Superpowers:16 个宿主通用的编码智能体方法论
Superpowers 是 obra 的 MIT 技能框架:15 个技能串起澄清、计划、TDD 与评审,可装进 Claude Code 等 16 个宿主。
项目资料
GitHub Ecosystem- 许可证
- MIT
- 主语言
- Shell
- 星标
- 323,387
- 核查时间
- 2026-11-22
以上快照资料以核查当日为准,可能随版本或运营策略变化。

用编码智能体写生产代码的人,多半重复过同一段对话:先说清楚需求,再让它写计划,提醒它测试先行,最后自己 review。Superpowers 是作者 obra 发起的开源项目,把这套流程拆成 15 个技能,并在每个会话开头注入一份引导文件,让技能自己触发。截至 2026-11-22,仓库 obra/superpowers 有 323,387 星、28,693 次分叉,MIT 许可,主语言标为 Shell,最新版本 v7.0.2 发布于 2026-11-03。

要点
- 15 个技能,按 README 分四组:测试 1 个、调试 3 个、协作 9 个、元技能 2 个。
skills/目录里正好 15 个子目录,与 README 的清单对得上。 - 16 个宿主,安装方式按宿主分:Claude Code、Codex App 与 Codex CLI、Cursor、Gemini CLI、GitHub Copilot CLI、Grok Build CLI、Kimi Code、OpenCode、Pi、Qwen Code、Hermes Agent、Muse、Antigravity、Devin CLI、Factory Droid。没有一个通用的安装脚本。
- 默认流程固定七步:brainstorming、using-git-worktrees、writing-plans、subagent-driven-development 或 executing-plans、test-driven-development、requesting-code-review、finishing-a-development-branch。
核心功能
Superpowers 的核心不是技能数量,而是技能之间的先后关系:上一步的产物是下一步的输入,跳一步就会卡住。
- 先问再写:
brainstorming在写代码前把意图问出来,再把理解复述给你改。v7.0.2 的发布说明给了维护者自己的盲评数字:填充式提问从 7.0.1 的 41 个降到 23 个,「为什么做」在 33/33 次对话里先于方案出现,此前是 28/33。这是官方自测,不是第三方基准。 - 计划细到能照抄:
writing-plans把工作拆成 2 到 5 分钟一个任务,每个任务带准确的文件路径、完整代码和验证步骤。README 的说法是,计划要细到「一个热情但没品位、没判断力、没有项目上下文、还讨厌写测试的初级工程师」也能照着做。 - 每个任务一个子代理:
subagent-driven-development给每个任务派一个全新的 subagent,任务后先查是否符合 spec、再查代码质量,整条分支最后再 review 一次。省 token 的路线是executing-plans:在当前会话里内联执行,最后统一 review 一遍。 - TDD 写成铁律:
test-driven-development的第一条是「没有失败的测试就不许写生产代码」,先写了实现就删掉重来;配套的verification-before-completion要求先跑命令、看到输出,才能声称完成。 - 工作区隔离:
using-git-worktrees在设计批准后开分支和 worktree,跑项目初始化,确认测试基线干净;finishing-a-development-branch收尾时给合并、开 PR、保留、丢弃四个选项,并清理 worktree。 - 排障与元技能:
systematic-debugging用四阶段找根因,diagnosing-superpowers读会话记录定位「技能该触发却没触发」,writing-skills讲怎么写新技能,还带测试方法。
十六个宿主
Superpowers 的跨宿主能力靠三层拼起来,不是把同一份文件复制 16 遍。技能本体只描述动作(invoke a skill、dispatch a subagent),不写具体工具名;每个宿主配一份工具映射,把动作翻成 task、shell 这类真实调用;最后一层是引导注入,在会话开始时把 using-superpowers/SKILL.md 全文塞进上下文。
项目的移植文档把这件事说得比 README 更直接:引导就是整个集成,没有它,磁盘上的技能文件是惰性的。文档还列了硬性规则——移植只能新增工具映射和引导注入器,不许改 skills/*/SKILL.md 里的措辞,也不许去改用户的全局配置。
| 宿主 | 安装入口 | 备注 |
|---|---|---|
| Claude Code | /plugin install superpowers@claude-plugins-official | 官方插件市场已有,也可加 obra 自己的市场 |
| Cursor | /add-plugin superpowers | 在 Agent 对话里执行,或去市场搜 |
| Codex CLI | /plugins 搜 superpowers | Codex App 在侧栏 Plugins 的 Coding 区 |
| Gemini CLI | gemini extensions install https://github.com/obra/superpowers | 按扩展装,更新用 extensions update |
| OpenCode | 让 agent 读仓库里的 .opencode/INSTALL.md | 没有安装命令,靠 agent 照文档动手 |
| Hermes Agent | hermes plugins install obra/superpowers --enable | 没有压缩后钩子,长会话会丢引导 |
哪些是硬约束
这是 Superpowers 最容易被误读的地方。真正接进宿主的只有钩子:hooks/hooks.json 注册一个 SessionStart 钩子,匹配 startup|clear|compact,调用 run-hook.cmd session-start 把引导写进上下文。Cursor 的 hooks-cursor.json 也只有 sessionStart 一条。
仓库里注册的钩子都只做引导注入:Claude Code 与 Cursor 是 SessionStart,Kimi 是 sessionStart,Hermes 是 pre_llm_call。没有 PreToolUse 一类的工具调用拦截,也没有 git 钩子拦提交。TDD 的「删掉先写的代码」、验证的「没跑命令不许说通过」,都是写给模型读的规则,执行与否取决于模型是否照做。仓库里能被机器执行的是另一部分:subagent-driven-development 的 helper 脚本(task-brief、sdd-repo、sdd-workspace、review-package),参数不对、不在 git 仓库里、代码围栏没闭合时会以 exit 2 退出,并告诉 agent 下一步该做什么。
所以「技能能强制 TDD 吗」的答案是:技能能做的上限,取决于宿主有没有注入引导、模型愿不愿意照做。这也解释了 README 为什么要单独写 Hermes 的限制——它没有压缩后钩子,一次长会话压缩之后引导就没了,技能不再触发,只能开新会话。
典型使用场景
- 每次都要重讲规矩的人:已经在 Claude Code 或 Codex 里写生产代码,但每次都忍不住补一句「先写测试」。装完开新会话说需求,流程自己跑起来。
- 想把设计留在仓库里的团队:设计文档和计划都是仓库里的 markdown,review 时直接看 diff 和计划文件,不用翻聊天记录。
- 愿意放手几小时的长任务:
subagent-driven-development明确要求连续执行、不要中途问「要不要继续」,只有四类事情会停:不可逆或破坏性操作、安全敏感动作、worktree 之外有副作用的动作、计划坏到每条路都是猜。 - 同时用多个宿主:同一个人在 Claude Code、Codex、Cursor 之间切换,不想维护三套提示词。
快速上手
Claude Code 最短,一条命令:
/plugin install superpowers@claude-plugins-official
其它宿主按各自入口装:
# Cursor(Agent 对话里)
/add-plugin superpowers
# Codex CLI:打开插件搜索,输入 superpowers,选 Install Plugin
/plugins
# Gemini CLI
gemini extensions install https://github.com/obra/superpowers
装完开一个新会话,说「做个 React todo list」。如果 brainstorming 先跳出来问你为什么要做、给谁用,说明引导注入成功;如果它直接开始写代码,先查宿主有没有 SessionStart 钩子。
外部评价
2025-10-11 的 Hacker News 讨论拿到 435 分、231 条评论,质疑集中在证据上:有人说这类文章该给 A/B 测试和可量化指标,而不是「用久了就知道好用」;也有人认为全大写的 EXTREMELY_IMPORTANT 是 2000 年代 SEO 式的咒语,模型现在只是照指令办事。子代理的成本也被点名——把实现全部丢给 subagent,token 消耗比在主上下文里干要高。
正面的一方同样具体。2026-04-03 的一篇长评(50 分、25 条评论)作者说,Claude Code 原生的 plan mode 会写出一份多页计划让你 review,改一次又吐一份新的,而 Superpowers 把计划拆小、允许直接改仓库里的 markdown,「这两个问题它都修了,还不止」。评论区不完全买账:有人说自己用下来 Claude 犯错更多,「别把它当银弹」;也有人引评测说它更适合还不是资深工程管理者的人。
成本侧有一个可查的数。simonwillison.net 上 2025-10-10 的笔记引作者的说法:核心引导文档不到 2k token,需要细节时用 shell 脚本去搜,耗 token 的实现工作交给子代理;一个 todo 应用从计划到实现的完整对话约 100k token。安装方式也有争议,OpenCode 那条等于让 agent 去取一份文档再照做,Hacker News 上有人形容成「curl | bash,还多了一层 LLM」。
小结
适合已经把编码智能体当主力、又被「它总跳步」反复咬到的人;也适合要在一个团队里统一流程、并且愿意接受一套固定七步的人。只是偶尔让 AI 写脚本,或者坚持流程自己定的人,装它反而多一层约束——同站的 mattpocock/skills 走的就是相反路线,明确反对框架接管流程。要更多技能、更宽的生命周期覆盖,可以看 agent-skills 的 25 个技能;Superpowers 的差别在子代理执行和 16 个宿主的一致性。
许可是 MIT,主语言标为 Shell(技能本体是 markdown,加一批 bash helper),2026-11-22 为 323,387 星、28,693 次分叉,2025-10-09 建库,最近一次推送是 2026-11-03。几个短板先知道:技能是提示词层面的约束,没有拦截工具调用的钩子,TDD 靠模型配合;唯一的效果数字来自维护者自己的盲评,第三方基准还没有;子代理执行更彻底,也更贵。
还有一个默认值值得留意:brainstorming 的可视化伴随功能会从 primeradiant.com 加载 logo,请求里带 Superpowers 版本号,但不含项目内容;不想上报就设 SUPERPOWERS_DISABLE_TELEMETRY。贡献政策也偏紧:一般不接受新技能 PR,改动必须同时兼容所有支持的宿主,别人报的 issue 也不接受 agent 代写修复。