Skills：把重复流程变成能力

Skill 适合沉淀反复使用的流程。官方文档里，Skill 通过 SKILL.md 提供说明，Claude 会在相关场景自动加载，也可以用 /skill-name 直接调用。

什么时候该做 Skill

• 同一段提示词已经复制了 3 次以上。
• 流程包含固定检查清单，比如代码审查、发布前检查、教程写作。
• CLAUDE.md 里某段内容越来越像“操作步骤”，而不是项目事实。
• 希望团队成员调用同一套流程。

Skill 的本质不是“更高级的提示词”，而是把一套稳定工作流程交给 CC 在合适场景加载。普通提示词适合当下任务，CLAUDE.md 适合项目长期事实，Skill 适合反复执行的工作方法。

可以这样判断要不要做 Skill：

一个好 Skill 通常有 4 个特点：

1. 触发场景明确。
2. 步骤顺序稳定。
3. 输入输出格式相对固定。
4. 风险边界写得清楚。

什么时候不该做 Skill

• 一次性任务。
• 只是项目长期规则，应该放 CLAUDE.md。
• 需要硬性阻止危险动作，应该考虑权限或 Hook。
• 流程还没有跑顺，只是临时想“自动化一下”。
• 团队还没形成共识，Skill 写出来反而会固化错误习惯。

第一次 Skill 适合做什么

推荐从“提交前审查”或“教程写作审查”这种只读 Skill 开始。不要第一次就做会写文件、跑脚本、发布上线的 Skill。

适合新手的 Skill 例子：

• 提交前审查：检查 diff、无关文件、敏感信息、测试结果和提交说明。
• 前端验收：检查页面状态、移动端、按钮链接、控制台错误和截图反馈。
• 教程写作审查：检查标题、学习顺序、是否喂饭级、是否有用户视角。
• 接口变更审查：检查入参、出参、错误处理、兼容性和回归影响。

不适合新手的 Skill 例子：

• 一键重构整个项目。
• 自动生成并应用数据库迁移。
• 自动创建发布版本。
• 自动修改权限、Secrets 或部署配置。

Skill 草稿应该包含什么

一个基础 SKILL.md 至少要写清楚：

Skill 里最容易漏的是“禁止事项”。只写怎么做，不写不能做，后面复用时很容易越界。

让 CC 设计 Skill

请帮我设计一个 Claude Code Skill，但先不要创建文件。

场景：
【例如：提交前审查 / 教程写作审查 / 前端页面验收】

要求：
1. 说明这个 Skill 解决什么重复流程。
2. 说明它应该什么时候触发。
3. 说明它只读还是会修改文件。
4. 给出 SKILL.md 草稿。
5. 列出风险和不适合自动执行的动作。

让 CC 审查 Skill 草稿

Skill 草稿写出来后，不要马上使用。先让 CC 从风险角度审一遍。

请只读审查下面这个 Skill 草稿，不要创建或修改文件。

请重点检查：
1. 触发场景是否太宽。
2. 是否包含不该自动执行的危险动作。
3. 是否把项目事实误写成通用流程。
4. 输入和输出是否清楚。
5. 是否需要补充“禁止事项”。

最后给出：
- 可以保留的部分。
- 必须修改的部分。
- 第一次验证这个 Skill 的低风险任务。

第一次验证 Skill

验证 Skill 时不要直接上真实复杂任务。推荐用一个小任务模拟：

请按刚才设计的 Skill 流程，模拟执行一次“提交前审查”。

要求：
1. 只读分析当前 diff。
2. 不修改任何文件。
3. 按 Skill 的输出格式汇报。
4. 如果流程里有不适合当前项目的步骤，请指出并建议调整 Skill。

如果 CC 执行时频繁偏离流程，说明 Skill 写得还不够具体。先改 Skill，不要急着扩大使用范围。

Skill 验收标准

第一次上线 Skill 前，最好连续用 2-3 个低风险任务验证。如果每次都要口头补很多限制，说明 Skill 还没写成熟。

Skill 和其他能力怎么分工

维护 Skill

Skill 不是写完就永远不动。出现下面情况要更新：

• 团队流程变了。
• 输出格式不够好用。
• 经常触发不该触发的场景。
• 新增了安全边界或禁止事项。
• 项目技术栈变化导致步骤不适用。

可复制：

请审查这个 Skill 是否需要更新。

请检查：
1. 触发场景是否仍然准确。
2. 步骤是否有过时内容。
3. 禁止事项是否足够。
4. 输出格式是否方便使用。
5. 有没有应该移到 CLAUDE.md、Hook 或普通提示词的内容。

验收结果

• 你知道 Skill 和 CLAUDE.md 的区别。
• 你知道第一次 Skill 应该低风险。
• 你知道 Skill 适合沉淀重复流程。
• 你知道 Skill 写完后要先审查，再用低风险任务验证。