2566 字
13 分钟
Superpowers 拆箱:给编程 Agent 装一套完整软件开发方法论的技能框架
2026-11-16

编程 Agent 最常见的毛病是什么?需求还没说清,它已经写了三百行代码。Superpowers 的解法不是换个更强的模型,而是给 Agent 装上一套软件开发方法论:一组可组合的技能(Skills),加上一段启动指令,保证 Agent 在动手之前先把流程走完——先头脑风暴挖需求,再写设计,再拆计划,然后用子代理逐个任务推进,全程 TDD,每步审查。它是目前 GitHub 上最火的 Agent 技能框架,31.8 万星,而且同一套技能能装进 17 种不同的编程 Agent 里。本文把它拆开:工作流怎么运转、技能库里有什么、各宿主怎么装、出了问题怎么诊断。

项目地址:https://github.com/obra/superpowers

先看清这是什么#

Superpowers 由 Jesse Vincent 与 Prime Radiant 团队维护,自我定义是「一套完整的、给编程 Agent 用的软件开发方法论,建立在一组可组合技能与启动指令之上」。关键数据(2026 年 11 月查于仓库主页):

项目数据
Star约 318k
Fork约 28.4k
建仓时间2025 年 10 月
版本发布17 个 Release
许可证MIT
支持宿主17 种编程 Agent

它和上一篇 ECC 的定位很像——都是给编程代理补「工程流程」这一层。区别在重心:ECC 是打包技能、记忆、安全扫描的运行时;Superpowers 更纯粹,押注的是流程纪律本身:技能会自动触发,工作流是强制的,不是建议。

工作原理:启动指令 + 自动触发#

Superpowers 由两部分组成。第一部分是技能库:一批写成文档的技能文件,每个技能描述一个流程(怎么做头脑风暴、怎么写计划、怎么系统化调试)。第二部分是启动指令:一个叫 using-superpowers 的引导技能,通过各宿主的会话启动钩子(SessionStart hook)注入,让 Agent 在每次会话开始时就知道「有技能可用、且必须用」。

效果是:你不需要记任何命令。Agent 在执行任何任务前会先检查有没有匹配的技能,有就按技能走。这也是它敢自称「方法论」而不是「提示词包」的原因——流程不是你想起来才用的,是焊在默认行为里的。

核心工作流:七步#

从你打开编程 Agent 的那一刻起,Superpowers 的工作流是这样的:

步骤技能干什么
1brainstorming动手前先挖需求:通过提问弄清你到底要什么,把理解复述给你纠正;小改动在对话里对齐,大项目产出正式设计文档
2using-git-worktrees设计批准后开隔离工作区:新分支、跑项目初始化、验证测试基线干净
3writing-plans把工作拆成 2–5 分钟一个的小任务,每个任务带确切文件路径、完整代码和验证步骤
4subagent-driven-development / executing-plans执行计划:前者给每个任务派一个全新子代理、逐个审查(最彻底);后者在当前会话内顺序执行、最后统一审查整条分支(最省钱)
5test-driven-development实现全程强制 RED-GREEN-REFACTOR:先写失败的测试,看它失败,再写最小代码,看它通过,然后提交;先写代码后补测试的,删掉重来
6requesting-code-review任务之间对照计划审查,按严重程度报告问题,严重问题阻断进度
7finishing-a-development-branch全部任务完成后验证测试,给出合并 / PR / 保留 / 丢弃的选项,清理工作区

官方的说法是:计划批准、你说了「go」之后,Agent 自主工作几个小时不偏离计划是常事。这套流程的设计假设很明确——把计划写到「一个热情但没品味、没判断、没项目上下文、还讨厌测试的初级工程师都能照着做」的程度,执行环节就可以放心交给子代理。这与 MuseAI-Skills 存档里那些技能文件的思路同源:把经验写成 Agent 能严格照做的规程,而不是指望模型临场发挥。

技能库里有什么#

仓库内置的技能按四类组织:

类别技能说明
测试test-driven-developmentRED-GREEN-REFACTOR 循环,附测试反模式参考
调试systematic-debugging四阶段根因定位流程(含根因追溯、纵深防御、条件等待等技法)
调试verification-before-completion宣布修好之前,先验证真的修好了
调试diagnosing-superpowers诊断 Superpowers 自己在某个会话里的异常行为
协作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技能系统总引导,即前述启动指令本体

安装:17 种宿主,各装各的#

Superpowers 是按宿主(harness)分别安装的:用几个 Agent,就装几遍。主流宿主的安装方式如下。

Claude Code(官方市场):

/plugin install superpowers@claude-plugins-official

或用作者自己的市场(还包含其他相关插件):

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

其他宿主各有自己的插件机制,命令一览:

宿主安装方式
Codex App侧边栏 Plugins → Coding 区找到 Superpowers 点 +
Codex CLI/plugins 里搜 superpowers,选 Install Plugin
CursorAgent 对话里 /add-plugin superpowers,或在插件市场搜
Gemini CLIgemini extensions install https://github.com/obra/superpowers
GitHub Copilot CLIcopilot plugin marketplace add obra/superpowers-marketplace 后 copilot plugin install superpowers@superpowers-marketplace
Grok Build CLIgrok plugin install superpowers@xai-official --trust
Kimi Code/plugins 里进 Marketplace 安装,或 /plugins install https://github.com/obra/superpowers
Qwen Codeqwen extensions install obra/superpowers
Devin CLIdevin plugins install obra/superpowers
Factory Droiddroid plugin marketplace add https://github.com/obra/superpowers 后 droid plugin install superpowers@superpowers
Antigravityagy plugin install https://github.com/obra/superpowers
Pipi install git:github.com/obra/superpowers
Hermes Agenthermes plugins install obra/superpowers --enable,装后要重启会话
OpenCode让 OpenCode 拉取仓库 .opencode/INSTALL.md 并按其中说明执行

值得单独说的是 Muse:Superpowers 提供了原生 Muse 插件,同一套技能、同一套启动注入(SessionStart 钩子),本地检出或克隆后安装:

Terminal window
git clone https://github.com/obra/superpowers.git
muse plugins install ./superpowers
muse plugins approve superpowers

装完要重启已打开的 Muse 会话,钩子才生效。验证装没装好有个官方小窍门:新开会话,发一句「Let’s make a react todo list」,正常的话 Agent 会在写任何代码之前先自动触发 brainstorming 跟你聊需求。各宿主的更新方式多为自动,或用各自的插件 update 命令重跑一遍安装流程即可。更多宿主细节可对照 AI 编程助手里对各家 CLI 的介绍。

出了问题怎么办:自带诊断技能#

会话行为异常——技能该触发的没触发、不该触发的乱触发、Agent 无视计划、重复劳动、token 烧得比预期多——Superpowers 给自己留了一个诊断入口:让 Agent「figure out what went wrong with superpowers in this session」,它会调用 diagnosing-superpowers 技能,读会话记录、给出带行号证据的复盘,还能把脱敏后的诊断包导出成 bug 报告材料。查更早的会话就把 session id 一起给它。这是个值得抄作业的设计:框架越大越需要自证清白的工具,否则出了问题只能靠猜。

理念:四条#

Superpowers 的哲学部分只有四条,但每条都在工作流里有对应物:

理念落地方式
测试先行(TDD)永远先写测试;先写实现再补测试的,删掉
系统化胜过临时发挥用流程代替猜测,调试有四阶段根因法
降低复杂度简单是首要目标,YAGNI 与 DRY 写进计划环节
证据胜过声明宣布完成前必须验证,审查按严重程度分级
WARNING

两个使用前要知道的点。第一,遥测:头脑风暴的可选可视化伴侣默认会从作者网站加载 Prime Radiant 的 logo,加载请求只带 Superpowers 的版本号,不带你的项目、提示词或宿主信息;介意的话设环境变量 SUPERPOWERS_DISABLE_TELEMETRY 为任意真值即可关闭(它也尊重 Claude Code 的 DISABLE_TELEMETRY 等退出开关)。第二,流程是有重量的:七步工作流是给正经项目准备的,改个文案、写个一次性小脚本时,全套头脑风暴加计划加子代理审查会显得杀鸡用牛刀——它适合「要做对」的事,不适合「随手试试」的事。

排障#

技能不触发。 先确认宿主的启动钩子真的生效:多数宿主要在安装后重启会话,钩子没加载,using-superpowers 就没注入,技能自然不会自动触发。用前述 react todo list 的方法验证。Hermes 还有一个已知坑:它没有压缩后钩子,超长会话一旦把第一轮压缩掉,启动指令会丢,技能停止触发——开新会话即可。

装了多个宿主,只有一个生效。 这是设计如此:每个宿主独立安装、独立更新。在 Claude Code 里装好,不等于 Codex 里也有,要逐个装。

更新后行为变怪。 先跑一遍 diagnosing-superpowers 复盘当前会话,确认是技能行为问题还是模型问题;再检查版本(各宿主用自己的插件 update 命令升级),很多「突然不好用」其实是新旧版本技能混杂。

想贡献新技能。 官方明确说一般不接受新技能贡献,且任何技能更新必须在全部支持的宿主上都能工作;Agent 代写的、修别人 issue 的 PR 也不收(除非维护者点名)。提问题走 issue 区,把复盘材料附上比直接甩 PR 更受欢迎。

小结#

Superpowers 证明了一件事:让编程 Agent 可靠干活,靠的不是更长的提示词,而是流程。它用一组技能把「先想清楚、再拆计划、测试先行、逐个审查」焊进 17 种宿主的默认行为,让不同 Agent 共享同一套工程纪律。对已经在用 Claude Code、Codex 或 Muse 的人,它是目前最值得一装的技能框架;装完用那句 react todo list 验一下,Agent 先跟你聊需求而不是先写代码,你就知道它在工作了。

Superpowers 拆箱:给编程 Agent 装一套完整软件开发方法论的技能框架
https://www.anexns.cloudns.org/posts/ai-superpowers/
作者
Anexns
发布于
2026-11-16
许可协议
CC BY-NC-SA 4.0