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 全文
通則仍然要能執行
通則不能只剩抽象要求。例如接新系統時,可以保留「先辨識底層平台,優先使用官方 API」的探索方法,但不保留特定站點的網址。
收到糾正時,先判斷其他同類任務是否也適用。適用時,可以這樣交代:
請把這次的做法寫回 Skill,整理成同類任務都能用的通則。
下圖示範如何依糾正的適用範圍,選擇保存位置。
糾正適用的範圍
寫到哪裡
- 寫進通用 Skill
誰會讀到
- 之後執行同類任務的 Claude Code
專案專用的內容有不同邊界
但只供單一專案使用的驗證 Skill,可以保留該專案的驗證指令。
來源
- Agent Skills specification agentskills.io
- Extend Claude with skills Claude Code docs
- Equipping agents for the real world with Agent Skills Anthropic
- Operating Systems: Three Easy Pieces Arpaci-Dusseau
- Agent Skills agentskills.io