跳到主要内容

Codex Skills 说明

本文档用最直接的方式解释：Skill 到底有什么用、怎么触发、怎么落地。

什么是 Skill（先看结论）​

Skill 是给 AI 的“可复用任务流程包”。 它不只是提示词，而是一套可执行的方法说明：在什么场景触发、按什么步骤做、需要哪些脚本或参考资料。

一句话：Rule 约束边界，Skill 提供做法。

Skill 解决什么问题​

如果没有 Skill，常见问题是：

  • 同类任务每次都要重复解释流程
  • 不同人/不同会话输出不一致
  • 复杂任务容易漏步骤（例如“先测后改”“改完再验证”）

有了 Skill 后：

  • 任务触发条件更清晰（什么时候该用哪个 Skill）
  • 执行步骤更稳定（先做什么、后做什么）
  • 团队经验可沉淀（流程能复用）

Skill 怎么工作（工作机制）​

Skill 通常按下面顺序发挥作用：

  1. 根据需求匹配 Skill（例如：调试问题 -> systematic-debugging）
  2. 读取该 Skill 的 SKILL.md
  3. 按 Skill 步骤执行任务
  4. 必要时调用 scripts/、参考 references/
  5. 输出结果并做验证

Skill 由什么组成（结构）​

一个 Skill 至少有一个 SKILL.md，可选附带脚本和资料：

<skill-name>/
├── SKILL.md      # 必需：用途、触发条件、步骤
├── scripts/      # 可选：自动化脚本
├── references/   # 可选：参考资料（规范/API/领域知识）
└── assets/       # 可选：模板、素材、输出资源

每个目录的意义：

  • SKILL.md：定义“为什么用、何时用、怎么做”
  • scripts/：把高频、易错步骤固化为命令
  • references/：放长文档，按需读取，避免主说明过长
  • assets/：放模板文件，直接用于产出

怎么选择 Skill（最常用映射）​

  • 每次对话开始时：using-superpowers
  • 需求拆解和计划：writing-plans
  • 功能开发/修复：test-driven-development
  • 出现报错或异常：systematic-debugging
  • 准备结束任务前：verification-before-completion
  • 准备发起评审：requesting-code-review
  • 收到评审意见：receiving-code-review

一个完整示例（从需求到交付）​

新需求从 0 到交付，常见链路：

using-superpowers -> writing-plans -> test-driven-development -> verification-before-completion -> requesting-code-review -> receiving-code-review -> （按反馈修改）-> verification-before-completion

这条链路的意义：

  • 先规划，避免直接开写
  • 先测后改，降低回归风险
  • 评审前先自证，减少无效 review
  • 评审后再验证，确保最终可交付