Skill 保存同類任務的做法,個案細節留在專案

觀念 L1 559 字 1 分鐘 v2.0.0 更新 2026-11-16

Skill 是寫給 agent(執行任務的 AI 助手)的任務做法,例如撰寫文章或製作新頁面的步驟。在不同對話反覆交代相同步驟時,就可以整理成 Skill。

新對話只載入 Skill 的名稱與說明。Claude Code 依名稱與說明判斷是否適用,符合時才載入全文;CLAUDE.md 則是每次新對話都載入全文的規則檔。詳細過程見 Skill 的載入過程。

先判斷規則適用的範圍

每個任務都需要知道的要求,放進 CLAUDE.md。只有特定類型任務需要的步驟,才寫成 Skill。

全文載入後會持續佔用 context,也就是一次請求送給模型的全部內容。無關個案也會跟著載入,過時的網址等細節則可能讓 agent 沿用舊做法。

同類任務共用的做法放進 Skill,專案名稱、網址與個案資料留在專案文件。

是否載入取決於說明,因此 description 要寫出適用任務與常見說法,例如「撰寫文章、製作新頁面」。下圖對照不同任務需要讀取的內容。

新對話的任務

每次載入

  • CLAUDE.md 全文
  • Skill 的名稱與說明

任務需要才載入

  • 範例任務沒有用到 Skill

未載入的內容

  • Skill 全文
假設任務未符合任何 Skill 說明。Claude Code 就不載入 Skill 全文。

通則仍然要能執行

通則不能只剩抽象要求。例如接新系統時,可以保留「先辨識底層平台,優先使用官方 API」的探索方法,但不保留特定站點的網址。

收到糾正時,先判斷其他同類任務是否也適用。適用時,可以這樣交代:

請把這次的做法寫回 Skill,整理成同類任務都能用的通則。

下圖示範如何依糾正的適用範圍,選擇保存位置。

糾正適用的範圍

寫到哪裡

  • 寫進通用 Skill

誰會讀到

  • 之後執行同類任務的 Claude Code
把通則與本次修正放在同一個 pull request。

專案專用的內容有不同邊界

但只供單一專案使用的驗證 Skill,可以保留該專案的驗證指令。

來源

讀完之後

基礎入門家目錄擴充MCPSkillPluginCLAUDE.md載入