Superpowers：28 万星的 Agent 技能框架，让 AI 编程助手按软件工程方法论干活

原文来源：GitHub — 一个装了就能用的 Agent 技能框架，把 TDD、代码评审、子代理开发这些工程方法变成会自动触发的技能。

Superpowers 是个有点特别的开源项目：它不生产代码，也不提供模型，而是把一整套软件开发方法论打包成"技能"，装进你正在用的编程助手。现在它有 28 万 Star，作者是 Jesse Vincent（obra）和 Prime Radiant 团队。

它解决什么问题

大多数编程 Agent 的问题是：你一开口，它就开始写。它不会停下来问你到底想做什么，不会先质疑你的方案，也不会在写完一段之后认真验证。Superpowers 要改的就是这个默认行为。

装好之后，Agent 看到你要做点什么，第一反应不是跳进代码，而是先把需求问出来。它会把问出来的需求分块展示给你，每一块都短到你能真的读完。你确认设计之后，它再产出一份实现计划，明确到"一个热情、品味一般、没有项目上下文、也不爱写测试的初级工程师也能照着做"。计划里强调真正的红绿 TDD、YAGNI 和 DRY。

等你说"开始"，它会启动一套子代理驱动的开发流程：每个工程任务交给一个新 Agent，做完就检查和评审，然后继续下一个。作者说，Agent 一次自主工作几个小时不偏离计划并不罕见。

支持的平台

这是它比较实用的一点：装法按助手而异，同一个项目可以分别装到十几个平台上。官方列出的包括 Claude Code、Codex（App 和 CLI）、Cursor、Gemini CLI、GitHub Copilot CLI、Grok Build CLI、Devin CLI、Factory Droid、Kimi Code、OpenCode、Antigravity、Pi，以及 Hermes Agent。Claude Code 和 Codex 都有官方插件市场入口。

装起来是什么体验

大多平台的装法都是一条命令。Claude Code 走官方插件市场，Codex 有官方插件入口，OpenCode 需要抓取一份 INSTALL 文档按步骤走，Hermes Agent 则是先装插件、再重启会话。作者专门提醒：Hermes 没有上下文压缩之后触发的钩子，长会话一旦被压缩，最初的引导就会丢失——技能不再触发的话，开个新会话就好。

装完之后你不需要记住任何技能名。技能是"看到相关信号就自己跳出来"的：你说"我想做个 X"，brainstorming 先接管；你确认计划后，writing-plans 和子代理流程接上；写代码时 TDD 强制生效；任务收尾时评审和分支清理按顺序走。这套设计的赌注是，把约束放在 Agent 一侧比放在人一侧更可靠——人会偷懒，而技能每次都会检查。

工作流长什么样

它的技能是自动触发的，不需要你手动点名。主流程大致是这样：

1. brainstorming — 写代码之前激活。用提问打磨粗糙的想法、探索替代方案、把设计分块交给你确认，最后存成设计文档
2. using-git-worktrees — 设计通过后激活。在新分支上建隔离工作区，跑项目初始化，确认测试基线是干净的
3. writing-plans — 把工作拆成 2 到 5 分钟一步的小任务，每个任务都带准确的文件路径、完整代码和验证步骤
4. subagent-driven-development 或 executing-plans — 按计划执行。前者每个任务派一个全新子代理，做两阶段评审（先看是否符合规格，再看代码质量）；后者分批执行，带人工检查点
5. test-driven-development — 实现阶段激活。强制 RED-GREEN-REFACTOR：先写失败的测试，看它失败，再写最小实现，看它通过，提交。写在测试之前的代码会被删掉
6. requesting-code-review — 任务之间激活。对照计划评审，按严重程度报问题，关键问题直接阻断进度
7. finishing-a-development-branch — 任务完成时激活。验证测试，给出合并、提 PR、保留或丢弃的选项，清理工作区

关键点在于"Agent 在做任何任务前都会检查有没有相关技能"——这些是强制工作流而不是建议。

里面有什么

技能库分几类：

• 测试：test-driven-development，含反模式参考
• 调试：systematic-debugging（4 阶段根因流程，附根因追踪、纵深防御、条件等待技巧）、verification-before-completion（确认真的修好了）
• 协作：brainstorming、writing-plans、executing-plans、dispatching-parallel-agents、requesting-code-review、receiving-code-review、using-git-worktrees、finishing-a-development-branch、subagent-driven-development
• 元技能：writing-skills（按最佳实践写新技能，含测试方法）、using-superpowers

它的理念

项目把自己的哲学写得很清楚：测试优先、系统化胜过临时应付、把降低复杂度当首要目标、证据胜过声明——宣布成功之前先验证。

这四条其实回答了"AI 编程到底该追求什么"。现在大多数工具在比谁写得快、谁能一次生成更多代码；Superpowers 的取向相反——它假设"写出来"是最不值钱的一步，真正稀缺的是想清楚、验证和评审。

适合谁，不适合谁

适合已经在用编程 Agent 做正经项目、但被"生成很快、维护很痛"折磨的人，尤其是那些发现 Agent 经常跑偏、写出来的代码没人敢 review 的团队。它的强项是把模糊需求逼成明确计划，把一次性的大生成拆成可验证的小步。

不太适合两种场景。一是只想让 Agent 写个小脚本的一次性任务，装上它反而多几轮对话；二是完全不想被流程约束、喜欢边写边想的人，它强调的强制 TDD 和评审会打断节奏。

如果你正在纠结要不要给团队引入这类框架，可以先拿一个小项目试装一周，重点观察两件事：Agent 是否真的开始先问需求再动手，以及它写出来的代码是不是比之前更容易 review。这两点比"省了多少时间"更能说明它有没有生效。

另外作者提到，他们一般不接受新技能的贡献，而且对技能的改动必须在所有支持的 Agent 上都能工作。这说明它是收敛型项目，不是靠社区拼装起来的技能库——好处是质量稳定，代价是覆盖面由维护者说了算。