一、速览：给 AI 编程助手装上一套开发规范

入门

先解释一个词：编码代理（coding agent），指装在编辑器或终端里、能读你的代码并自己动手改代码的 AI 助手，Claude Code、Cursor、Gemini CLI 都属于这一类。

多数人用它的方式很直接：心里有个想法，打一句话，它就往外吐代码。问题是这些代码是不是你要的，往往要等你读完几百行才知道，改回去的成本还得自己承担。

Superpowers 把这个顺序倒过来。它是一个装在代理里的技能框架，代理一看到你在"做东西"，会先停下来问你到底想做什么，把需求聊成一份设计文档，再拆成计划，最后才动手。

它不是一个新的 AI 编程工具，而是给已有工具换上一套"先设计、后编码"的工作习惯。

Superpowers 仓库封面

适合谁：已经在用 Claude Code 等工具、但总觉得"AI 写完的代码不敢信"的人，以及想给团队定一套 AI 协作规矩的人。

二、设计理念：技能是菜谱，代理是厨师

入门

把技能（skill）想成菜谱。代理是厨师，刀工火候都有，但不会主动翻菜谱——你不说，它就直接把菜下锅。

Superpowers 做的是两件事：把一本菜谱放在灶台边，再在墙上贴一张流程表，规定"开炒前先看菜谱"。厨房还是那个厨房，出品稳定了很多。

这里的约定优于配置体现在时机上：技能会在合适的时候自己激活。写代码前激活"头脑风暴"，设计通过后激活"建工作区"，计划批准后激活"任务拆分"。你几乎不用手动喊"请先用 TDD"。

技能之间靠产物接力：头脑风暴产出设计文档，设计文档喂给计划技能，计划喂给执行技能。前一环的输出就是后一环的输入，链条一断，后面全接不上。

设计文档还有一个刻意的处理：它不一次性甩给你几千字，而是分段展示，每段短到你真能读完并当场点头。原因很现实——一次看完整份设计的人，通常什么都没看。

方法论上它只认三条老规矩：TDD（测试驱动开发，先写测试再写实现）、YAGNI（你不会需要它，别提前做用不上的功能）、DRY（不要重复自己，同样的逻辑只写一遍）。

三、快速开始：装进你的编码代理

入门

前置条件：你得先有一个能正常工作的编码代理，并且它支持插件市场或斜杠命令。Superpowers 本身不是独立程序，它寄生在代理里运行，没有代理就无从谈起。

以 Claude Code 为例，在它的会话里输入：

/plugin install superpowers@claude-plugins-official

如果没装上，换官方市场源再试一次：

/plugin install superpowers@superpowers-marketplace

装好之后，用一个真实但不大的需求试水，比如"给登录页加一个记住我选项"。不要拿 hello world 试——需求太空，头脑风暴环节问不出东西，你会误以为它坏了。

接下来你会看到几样产物，各自的角色是：

  • 设计文档：先解决"要做什么"，一份可以反复回看的共识。
  • 新分支：代理在独立工作区干活，改坏了不影响你原来的代码。
  • 实施计划：每个任务 2–5 分钟能做完，写清文件路径、完整代码和验证方法。

常见的问题是：装完插件没重启代理会话，技能列表没加载出来。先重启会话，再检查安装是否成功。

四、核心概念：一次完整的五步流水线

进阶 · 推荐细读

头脑风暴是入口。代理不写代码，只提问：你真正想解决什么？有没有别的做法？聊完它存下一份设计文档，交给你确认。

搭工作区在设计通过后触发。它在新分支上建隔离环境，跑完项目初始化，确认测试基线是干净的——这一步是给后面的开发留一条"随时能回到原点"的退路。

写计划把工作切成小块，每块 2–5 分钟，附带确切的文件路径、完整代码和验证步骤。README 里的原话是：计划要细到"一个热情但没品味、没判断力、不了解项目、还讨厌写测试的初级工程师"也能照着做。

子代理驱动开发是执行阶段的核心。这里引入一个概念：子代理（subagent），指主代理派出去的"分身"，每个分身只负责一个任务、只带这个任务需要的上下文。两种模式可选：

  • 逐任务审查：每个任务派一个全新子代理，做完立刻审查，最彻底也最贵。
  • 一次性审查：所有任务在当前会话里做完，最后对整个分支做一次审查，最省钱。

TDD 循环在执行过程中强制生效，走红—绿—重构：先写一个会失败的测试，看着它失败，写最少的代码让它通过，提交。测试之前写的代码会被删掉。

由于计划足够具体，代理连续自主工作一两个小时不跑偏，是这套流程里的常见结果。

五、生态与扩展：不只属于 Claude Code

深入 · 老手可选

支持的代理名单很长：Claude Code、Cursor、Codex App / Codex CLI、Gemini CLI、GitHub Copilot CLI、OpenCode、Qwen Code、Kimi Code、Devin CLI、Factory Droid、Grok Build CLI、Antigravity、Pi、Hermes Agent、Muse。

每个工具的安装方式都不一样，命令格式各不相同。找到你正在用的那个名字，复制它对应的那一条即可，不要跨工具混用命令。

技能是可组合的，这是它最值得留意的地方：你可以照着已有技能的写法，写一个团队自己的"发布流程"或"代码评审规范"塞进去，让它和原有技能串在同一条流水线上。社区入口在仓库 README 的 Community 一节。

关于隐私：项目带一个可选的遥测（telemetry，指程序自动上报使用数据）开关，只上报用了哪些技能和版本号，可以关掉：

export SUPERPOWERS_DISABLE_TELEMETRY=1

它同时尊重 Claude Code 自带的 DISABLE_TELEMETRY 和 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 两个开关。流程卡住时，README 里另有一节专门讲怎么排查。

最后给一个判断标准：如果只是改一行配置、修一个拼写错误，直接让代理动手更快，提问和规划反而是负担。它真正省时间的地方，是那种要说清背景、要动好几个文件、还要保证不破坏现有功能的需求。

项目信息

项目 值
仓库 obra/superpowers
语言 Shell
Star 296,004
Fork 26,430
主页 无

参考链接

延伸阅读

想继续探索？这些同领域的教程可能也适合你：