循循 synsoon 課程
12 / 13

特講 Agent Skills

每天對 AI 講同一套台詞?Agent Skills 把教導寫下來一次,變成按需載入的技能包。 本特講先比較兩種舊做法(CLAUDE.md 常駐、斜線指令),再拆解 SKILL.md 的結構: description 這張職位說明書、when_to_use 與 1536 字元、常被搞反的 allowed-tools 方向、 漸進式揭露與 500 行、為什麼要它「Run 而不是 Read」、Context Fork、 子代理不繼承技能的隔離陷阱、擴散途徑與同名衝突,收在機師級除錯快問快答。

本集章節19

本集心智圖6 組

Agent Skills:按需載入的操作手冊
  • 技能檔長什麼樣
    • SKILL.md 加上 YAML frontmatter
    • name 與 description
    • disable-model-invocation
    • allowed-tools
    • 支援檔案怎麼放
  • 它從哪裡被找到
    • 技能檔可以住在好幾層
    • 即時變更偵測
    • 從父目錄與巢狀目錄探索
    • 額外目錄裡的技能
    • 同步進來的技能名稱撞到既有指令怎麼辦
  • 誰可以叫它
    • 模型自動判斷,或使用者打斜線指令
    • 指令名稱是怎麼決定的
    • 可用的字串替換
  • 為什麼要按需載入
    • 常駐的指令會一直佔著 context
    • 描述先進 context,內文用到才讀
  • 內建技能
    • 把 app 跑起來並驗證
  • 設定不生效時怎麼查
    • 看什麼載進了 context
    • 檢查解析後的設定
    • 檢查 MCP 伺服器與 hooks
    • 用一份乾淨設定對照測試

#AgentSkills#ClaudeCode#SKILLmd#AI自動化#AI開發