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.