为什么你的最佳实践总是「用完就忘」
你可能有这样的经历：今天教 Claude Code 按某个规范审查代码，效果很好；明天换了个会话，它又忘了，得重新教一遍。
技能系统就是治这个的：把你的最佳实践固化成「技能」，一次定义、处处复用。类似自定义斜杠命令，但更结构化、更适合复杂的流程。
对 codex-review 来说，这是最关键的升级：前两个模块你都是「手打」评审流程——手打并行指令、手打评审计划模板。这些流程是好实践，但每次手打、每次都可能打得不一致。技能系统让「评审怎么审」变成一次定义、处处可用的技能。
/review 就能触发整套评审流程，不用再手打大段指令。这一节先理解技能是什么、怎么运行。技能是什么
技能（Skill）是一套**「带说明的指令包」**，包含：
- 描述：它做什么、什么时候用
- 步骤：怎么执行、按什么顺序
- 约定：要注意什么、输出什么格式
一次调用，Claude Code 就能按这套指令完整执行，不用你每次重复叮嘱。
对 codex-review，这个「评审技能」就是把你前两个模块反复手打的评审流程，收进一个指令包里：
- 描述：一次代码评审怎么做
- 步骤：派三路子 Agent（逻辑 / 安全 / 风格），每路怎么审
- 约定：按三档输出、必须做冲突对账、覆盖哪些检查点
以后你说「跑一下 codex-review」，它就把这套流程完整跑一遍。
技能 与 斜杠命令 的区别
你可能觉得它和自定义斜杠命令像。确实有联系，但侧重点不同：
| 斜杠命令 | 技能 | |
|---|---|---|
| 形态 | 一段「快捷指令」 | 更完整的「指令包」 |
| 内容 | 通常较短 | 可含多步骤、多约定 |
| 用途 | 快速触发某个动作 | 承载一套复杂流程/最佳实践 |
简单说：技能是更正式、更完整的那一套。复杂流程适合做成技能。
对 codex-review，你要的是「整套评审流程」这种复杂的东西，显然适合做成技能，而不是一条短斜杠命令。技能里的约定（按三档输出、对账）是斜杠命令装不下的。
技能的典型用途
- 代码审查：按团队规范做一整套审查
- 新增模块：按项目骨架一键生成新模块
- 写文档：按规范产出文档
- 技术栈约定：让 Claude Code 写代码时遵守团队技术栈
本质都是：把「正确做法」固定下来，让 AI 稳定执行。
codex-review 本质就是一个「代码审查」技能的产物。你把评审规则封装成技能后，它能：
- 审任何项目时都按同一套评审标准走，不再每次自由发挥
- 新人拿到技能就能跑，不用先背一遍评审规范
- 评审标准想改，改技能一处，处处生效
技能由谁定义
技能可以分两种范围：
- 个人：放在你自己的配置目录，你独用
- 项目/团队：放在项目里，跟随仓库分发，全组共用
技能的本质是「可分享的资产」——这也是它比口头约定强的地方：放进仓库，全团队都能用。
对 codex-review，评审技能非常适合放进项目仓库，因为评审标准是团队级的资产：放在 .claude/skills/ 下，团队 clone 下来，每个人跑 codex-review 都是同一套评审标准，谁也不用重复发明。
两种范围的适用场景对照：
| 个人技能 | 项目/团队技能 | |
|---|---|---|
| 放哪 | 你自己的配置目录 | 项目仓库 .claude/skills/ |
| 谁用 | 只有你 | 所有 clone 项目的人 |
| 典型 | 个人偏好、草稿技能 | 团队评审标准、项目规范 |
| 迭代 | 你说了算 | 走版本管理，团队参与 |
codex-review 属于典型的「团队技能」——评审标准不是个人口味，是团队要统一的共同资产，所以放仓库、走版本管理更合适。
技能是怎么被触发的
理解技能的运行原理，核心是搞清「它怎么被用到」。通常两种方式：
- 显式调用：你明确提到它，比如「用评审技能审一下这次改动」。触发明确，是 codex-review 最常用的方式。
- 按需触发：技能里写清「何时用」，AI 在合适的场景主动调用。比如你只说「这次改动帮我看看」，AI 看到「改动 + 审查」语境，可能主动套用评审技能。
落地练习
② 怎么判断做对了：你的概括里「步骤」是具体的（派哪三路、每路审什么）、「约定」是明确的（三档输出、对账）；触发后它执行的流程和你手打时基本一致，没有自由发挥。
③ 卡住了怎么办：如果它没按你的概括来，说明「描述」写得不够触发条件明确，回去补充「何时用、何时不用」；如果步骤不具体，把每路子 Agent 的检查点一条条写进去。
常见坑：把技能当成「贴一段提示词」
很多人以为技能就是「把常用提示词存起来，要用时复制粘贴」。这是误解：技能不是提示词，而是一套有描述、有步骤、有约定、能被可靠触发和执行的结构化指令包。如果只是贴提示词，那跟你每次手打没区别，根本享受不到「一次定义、处处复用、稳定执行」的好处。
分辨标准：你的技能有没有「描述 / 步骤 / 约定」三层结构？能不能被可靠触发？改一处能否处处生效？三者有一项不是，它就还没到「技能」的程度。
小结
- 技能 = 「带说明的指令包」，把最佳实践固化下来
- 一次定义、处处复用，不再每次重复教
- 比斜杠命令更完整，适合复杂流程
- 可放个人目录或项目仓库，团队共享
- 技能能否被可靠触发，取决于「描述」写得好不好
下一节，动手写一个你自己的技能——把 codex-review 的评审规则真正做成 SKILL.md。