5.2 skills：把流程做成卡片

skills 的作用不是“让模型更聪明”，而是让 Agent 每次按稳定流程做事。

skill 适合封装什么

适合：

• Bug 修复流程。
• 代码审查流程。
• 前端 polish 流程。
• API 变更流程。
• 发布说明流程。
• 数据分析流程。
• 文档生成流程。

不适合：

• 一次性任务。
• 还没跑顺的流程。
• 你自己都说不清的经验。
• 和已有 skill 高度重叠的东西。

一个 skill 通常包含

SKILL.md
  触发条件、工作步骤、规则。

references/
  需要时再读的资料。

scripts/
  稳定、重复、容易出错的脚本。

assets/
  模板、示例、静态资源。

什么时候写自己的 skill

出现这些信号：

• 你第三次复制同一段 prompt。
• Agent 第三次漏同一个步骤。
• 某个流程有固定输入输出。
• 团队希望复用同一套做法。
• 这个流程靠人记容易错。

skill 写法原则

1. 描述触发场景

描述要写清楚什么时候用：

description: Use when fixing reproducible bugs, including reading logs, reproducing, isolating root cause, making minimal fix, adding regression tests, and writing a short retrospective.

2. 步骤要具体

不要写：

认真修复 bug。

要写：

1. 复现问题。
2. 提出 2-3 个假设。
3. 用日志或测试验证假设。
4. 做最小修复。
5. 加回归测试。
6. 跑验证命令。
7. 写复盘。

3. 不要塞长篇资料

SKILL.md 应该短。长资料放 references/，脚本放 scripts/。

skills 的风险

• 装太多导致触发混乱。
• 多个 skill 管同一件事。
• skill 过长，Agent 抓不到重点。
• skill 把任务限制得过死。
• 没验证 skill 是否真的提升质量。

最佳实践：

少装。
常用。
边用边改。
优先自建。