给编码 agent 装上完整开发流程的 15 个 skill
obra/superpowers
v6.4.1(2026-09-18),MIT,28.9 万 star,是我们见到 star 量最大的单一 skill 仓库。它把 brainstorming → spec → git worktree 隔离 → 实现计划 → subagent 执行 → 红绿 TDD → 双向 code review → 验证收尾串成一条主干工作流,README 列了 16 种以上 harness:Claude Code、Codex、Cursor、Gemini CLI、OpenCode、Kimi Code、Devin CLI 等。
我们的判断它的核心判断是「模型不缺编码能力,缺流程纪律」。最值得抄走的一条是 Rulings, not stalls:默认自己裁定,只有操作不可逆、涉及安全敏感面、副作用溢出到 worktree 之外、计划已经烂到无法继续这四种情况才允许停下来问人。这四条我们已经搬进本站自己的采集流程。
/plugin install superpowers@claude-plugins-official它解决的到底是什么问题
Superpowers 不是「一堆 prompt 模板」,它是一套给编码 agent 用的完整软件开发方法论:用一组可组合的 skill 加上初始指令,让 agent 在你说「开始做」的那一刻不要直接写代码。当前版本 v6.4.1(2026-09-18),MIT 许可,289,160 stars / 25,872 forks——这是我们看到的 star 量最大的单一 skill 仓库,而且它的增长来自方法论本身,不是玩具 demo。
它的核心观察很朴素:模型不缺编码能力,缺的是流程纪律。没有流程时 agent 会跳过需求澄清、跳过失败测试、跳过代码审查,最后交付一个「看起来对」的结果。Superpowers 用 15 个 skill 把这条流程钉死。
15 个 skill 与那条主干工作流
| 阶段 | skill | 它强制你做什么 |
|---|---|---|
| 1. 澄清 | brainstorming | 把模糊需求逼成一份 spec,分块给你确认,短到你真的会读完 |
| 2. 隔离 | using-git-worktrees | 每个任务一个 worktree,副作用不外溢到主工作区 |
| 3. 计划 | writing-plans | 写一份「品味差、没上下文、讨厌写测试的热情初级工程师」也能照做的实现计划 |
| 4. 执行 | subagent-driven-development / executing-plans | 前者派 subagent 逐任务做并互相审查;后者是 v6.4.1 重写的 Native 内联模式,一次收尾审查 |
| 5. 测试 | test-driven-development | 红/绿 TDD,铁律:NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST;已经先写了实现?删掉重来 |
| 6. 审查 | requesting-code-review / receiving-code-review | 主动请求审查,并要求以证据回应审查意见 |
| 7. 收尾 | finishing-a-development-branch / verification-before-completion | 声称完成前必须先验证 |
另外还有 systematic-debugging(系统化排障替代瞎试)、dispatching-parallel-agents(并行派发)、writing-skills(教你写 skill 的 skill),以及 v6.4.1 新增的 diagnosing-superpowers——一个做「会话法证」的 skill,要求每条结论都带 path:line 证据。
最值得抄走的一条设计:Rulings, not stalls
大多数 agent 框架的失败模式是「一遇到不确定就停下来问人」,一问十次,人就成了瓶颈。Superpowers 反过来写:默认自己裁定,只有 4 种情况才允许停:
1. 操作不可逆 / 有破坏性
2. 涉及安全敏感面
3. 副作用会溢出到 worktree 之外
4. 计划本身已经烂到无法继续
这四条是可以直接搬到任何自研 agent 上的停机准则。我们把它抄进了本站自己的采集流程(不可逆操作与生产写入前先确认)。
另一条同样关键:using-superpowers 要求在任何回复之前先检查是否有 skill 适用,门槛低到「哪怕只有 1% 的可能性也要调用」。skill 装上不生效,通常不是 skill 写得差,而是没有这条强制触发指令。
安装与运行时兼容
它是跨 harness 的,README 列了 16 种以上:Claude Code、Antigravity、Codex App/CLI、Cursor、Devin CLI、Factory Droid、Gemini CLI、GitHub Copilot CLI、Grok Build CLI、Kimi Code、OpenCode、Pi、Qwen Code、Hermes Agent、Muse。用几个 harness 就要分别装几次。
# Claude Code(官方插件市场)
/plugin install superpowers@claude-plugins-official
什么时候不该用它
它重。一次完整流程要经过 spec → plan → worktree → subagent → review,改一行配置用它是浪费。它真正划算的场景是:多文件重构、新功能从 0 到 1、需要留下可审查痕迹的团队协作。另外 subagent-driven-development 的 token 消耗显著高于内联模式,v6.4.1 把 executing-plans 重写并只保留一次收尾审查,正是对这个成本的回应。
哲学部分它自己写了四条:TDD、系统化胜过临场发挥、降低复杂度、证据胜过声称。最后一条是整个仓库的灵魂,也是我们判断任何 agent skill 值不值得进库的第一标准。