Skills

是什麼

Skill 是一組打包好的指令和資源，用來教會 AI 編碼 agent 如何完成某項特定任務。你不必在每次對話中重新解釋自己的約定，而是把它們一次性寫成一個 Skill——一段簡短的描述，加上步驟、示例以及任何輔助檔案——agent 會在相關任務出現時按需載入它。可以把它想像成一份菜譜，當情況匹配時 agent 就會去取用。

優勢

• 把 know-how 一次性記錄下來並反覆複用，從此不必在每個 prompt 裡重複同樣的準備工作。
• 僅在相關時才載入，因此其餘時間不會塞滿 agent 的上下文。
• 檔案簡單易讀——通常是 Markdown——便於編寫、審閱，並用 git 做版本管理。
• 可在團隊或多個專案間共享，讓每個人都遵循同一套可信的流程。

權衡取捨

• 一個陳舊或含糊的 Skill 可能把 agent 帶偏；和文件一樣，它需要維護。
• 太多相互重疊的 Skill 會讓人搞不清該用哪個。
• 只有當 agent 識別出任務並將其調入時，它才能發揮作用。
• 它是指引，而非保證——agent 仍可能偏離指令碼。

何時使用

當你有一套帶有具體規則、可重複的流程時——一段部署序列、一份程式碼風格清單、一種領域專用的格式——就該用 Skill，否則你每次都得把它貼上到對話裡。

與 vibe coding 的契合度

Skill 正是讓一個普通助手變成你的助手的方式。把你的專案希望事情如何完成的方式編碼進去——命名、測試、操作順序——agent 就會自動遵循。讓每個 Skill 保持窄小，並清晰命名，這樣 agent 才能準確知道何時呼叫它。

---
name: ship-checklist
description: Steps to take before shipping any change to production.
---

1. Run the test suite and confirm it passes.
2. Bump the version in package.json.
3. Update CHANGELOG.md with a one-line summary.
4. Commit, push, then deploy.