能复用的 Claude Code 技能

技能是干什么的

技能打包一套程序：何时用、检查什么、跑哪些命令。审 PR、写发布说明、套用仓库 lint，都是好的第一份技能。

它不是第二份 CLAUDE.md。说明书始终在。技能在任务匹配时才加载。

触发条件不能用一句话说清，就还没写好。

技能放哪

项目技能进仓库，同事才能拿到。个人技能留在自己机器。目录布局抄当天文档，不要抄旧 gist。

加完后开新会话，或按客户端的重载方式。用很小的一次调用验证，比猜测强。

• 仓库里一份项目技能。
• 只属于你的技能不要进库。
• 先重载再判断它坏了。

把技能写薄

名称、描述、步骤。写上校验命令。能外链就不要贴一本书。

写清不要做什么：不部署生产、不碰密钥文件。

保证新克隆也能跑。

1. 一句触发语。
2. 新人能跟的步骤。
3. 校验命令。
4. 禁令。

怎么调用

很多构建会提供斜杠命令或技能名。描述写清楚时，也可以用自然语言点名。

第一次调用用很小的替身，不要在发布分支上试。

• 小仓库或小分支。
• 看它碰了哪些文件。
• 再用于真任务。

和团队共享

像代码一样 PR。若它会跑 shell，评审应看见命令列表。

版本钉死和 URL 会过期。每个季度重读一次。

• 必须走 PR。
• 技能正文没有令牌。
• 描述里写负责人。

技能和 CLAUDE.md

CLAUDE.md 写这个仓库怎么工作。技能写这个流程怎么走。两边都重复测试命令时，命令留在 CLAUDE.md，技能指向它。

不要把架构禁令只藏在没人触发的技能里。

• 始终生效的事实进 CLAUDE.md。
• 流程进技能。
• 测试命令只有一条。

钩子不是技能

钩子在生命周期某一点跑你的命令，例如编辑之后。它是补充，也很容易做过头。

第一周：零个或一个钩子。坏钩子会让每次会话都难解释。

• 一个钩子只做一件事。
• 在练习仓库证明。
• 拿不准就先写技能。

技能阶段的错法

把聊天记录倒进技能文件。

十份技能里没有一份带校验命令。

• 剧本里有密钥。
• 没有触发句。
• 技能只是复述 CLAUDE.md。

做到这样就够了

你在一个小任务上调用过一次技能，并保留或撤回了结果。

1. 写了一份技能。
2. 触发是一句话。
3. 有校验。
4. 同事能跑。
5. 没有令牌。

下一章：接一台 MCP

MCP 连接 git 树以外的系统。技能仍是仓库内的剧本。

不要同一晚上加三台服务器。