把重复工作封装成 Skills

01什么时候值得创建 Skill

当你反复粘贴一段流程，或 CLAUDE.md 已经塞满只在特定任务需要的步骤，就可以把流程拆成 Skill。描述应说明适用任务和预期产物。

Skill 的指令正文按使用需要加载，因此适合放较长的操作步骤和参考资料。支持文件仍应按需读取，避免一次塞入全部资料。

02最小目录与示例

在项目 .claude/skills/ 下创建独立目录和 SKILL.md。下面是一个代码审查流程的原创起点；按团队真实验证命令补充。

---
name: review-changes
description: 检查当前项目的代码变更，定位功能回归并报告可操作问题。
---

1. 阅读项目约定和当前 diff。
2. 沿变更调用链检查边界条件。
3. 执行与问题相关的已有验证。
4. 报告问题位置、触发条件与建议。
5. 没有发现问题时，说明覆盖范围与验证限制。

03让流程可复用且可验证

把触发条件写得具体，把“做得更好”改成可检查的结果。脚本和参考文档放在同一目录，使用相对路径，并标明什么时候需要调用。

• 让 Skill 专注一种任务，避免成为第二份项目 README。
• 包含必要前置条件、失败处理和验收条件。
• 检查第三方 Skill 中的命令与网络访问再启用。
• 用真实任务验证，记录改进原因并持续版本化。

04把一个真实流程做成验收用例

以代码审查 Skill 为例，准备一个已知有缺陷的小改动：按钮提交后没有在异常分支恢复。让 Skill 找出触发条件与文件位置，再准备一个没有问题的改动，检查它是否会为了“有产出”编造问题。

确认基本流程后再加入项目特定命令。一个可靠 Skill 应能区分发现问题、没有发现问题和证据不足，而不总是生成相同结论。

• 使用至少一个成功场景和一个失败场景。
• 输出格式应该服务后续审查，而不是堆砌文字。
• 如果 Skill 依赖脚本，验证脚本不存在或执行失败时的行为。