资料来源:GitHub
obra/superpowersREADME + 作者发布公告(文末附链接)
如果你用过 Claude Code / Cursor / Codex 这类编码 Agent,大概率都被同一件事折磨过:
- 你让它“修个小 bug”,它顺手重构半个项目
- 你说“先别写代码,聊方案”,它嘴上答应,转头开写
- 你让它“跑测试”,它说“已验证”,其实什么都没跑
- 你想并行做两条需求,它俩互相覆盖文件,最后一地鸡毛
obra/superpowers 真正要解决的,不是“模型够不够聪明”,而是更现实的那句:没有流程的智能,会把工程变成玄学。
它给编码 Agent 贴了一套“工程纪律”:先澄清 → 出设计 → 拆计划 → 用 worktree 隔离 → TDD 红绿灯 → 子代理执行 + 复审 → 收尾出 PR/合并。
听起来像“项目管理”,但真正厉害的是:这套流程是用 skills(技能文档)强制注入给 Agent 的,不是靠你每天复制粘贴提示词。
下面我按“它到底做了什么 / 为什么有效 / 怎么上手 / 怎么用出结果”把它拆开讲清楚。
1)Superpowers 到底是什么?一句话讲人话
Superpowers 是一套给编码 Agent 用的“技能框架 + 软件开发方法论”,核心目标就一个:
让 Agent 按工程流程做事,而不是按它的冲动写代码。
你可以把它理解成:
- 你以前是“对着 Agent 喊话”
- 现在是“给 Agent 配了一套 SOP(标准作业流程)+ 检查清单 + 强约束流程”
它不是只绑定某一个平台:同一套理念覆盖 Claude Code、Cursor、Codex、Gemini CLI、Copilot CLI 等多个“harness”(官方叫法)。
2)它为什么能让 Agent 变靠谱?关键在“把好习惯做成默认行为”
Superpowers 最反直觉的一点是:它不靠你变强,它靠“默认流程”变强。
作者在发布公告里把“启动钩子(bootstrap)”讲得非常明确:一启动就强制模型去读 getting-started 的 SKILL.md,并且灌输三件事(我用大白话翻译):
- 你有 skills,这玩意会给你超能力
- 你要先去找 skills,找到就读,然后照做
- 如果有 skill 能做这件事,就必须用
这听上去像“规矩”,但对 Agent 特别有效:它把“先计划、再测试、隔离分支、阶段复审”这些工程师自觉,变成了模型的默认动作。
3)最核心的 7 步工作流:看起来很“流程”,但每一步都在替你堵坑
官方给的 Basic Workflow 一共 7 步,我逐条拆给你看它“堵住了什么坑”。
3.1 brainstorming:先把需求问清楚(别急着写)
它会在写代码前用问题把目标“挤出来”,并把设计按小块展示给你确认。
它解决的坑:
- 你只说了 60 分的需求,Agent 用 120 分的想象补齐,然后写出 0 分的结果
- 你想要的是 A,它自作主张做成 B
3.2 using-git-worktrees:把改动隔离到 worktree(避免互相污染)
设计确认后,如果在 git repo 里,它会创建 worktree,在新工作目录里做事。
它解决的坑:
- 并行两条任务互相覆盖文件
- 试验性改动污染主分支,回不去
- “我只是想试试”最后变成“我好像改对了但不敢提交”
3.3 writing-plans:把任务拆成 2-5 分钟的小块(而且写清文件路径)
它强调:每个任务都要有确切文件路径、完整代码、验证步骤。
它解决的坑:
- Agent 写一个“宏大方案”,你看完仍然不知道下一步改哪个文件
- 计划里全是形容词(“优化”“增强”“重构”),没有可执行动作
3.4 subagent-driven-development / executing-plans:把实现丢给子代理做,再复审
它提供两种执行方式:
- 传统方式:你开第二个会话当 PM
- 新方式:逐个任务派发给子代理实现,并做两阶段 review(合规 + 质量)
它解决的坑:
- 一个 Agent 从头做到尾,越写越嗨,越偏越远
- 没有“阶段性刹车”,出问题时已经改了 30 个文件
3.5 test-driven-development:红→绿→重构(而且“先写的没测试就删掉”)
它强调真 TDD:先写失败测试 → 看它失败 → 写最小实现让它过 → 再重构。
甚至写得很狠:删掉那些没测试就先写出来的代码。
它解决的坑:
- Agent 很会“写看起来对的代码”,但不会“写可证明对的代码”
- 你以为它测了,其实只是“脑测”
3.6 requesting-code-review:每个阶段做 code review,Critical 必须修
它把“复审”做成流程,不让它糊弄过去。
它解决的坑:
- 功能能跑,但安全性、边界条件、可维护性一塌糊涂
- 你想 review,但你没精力每行都看
3.7 finishing-a-development-branch:收尾动作标准化(PR / merge / 清理)
做完会验证测试,并提供:提 PR、把 worktree 合并回源分支、或停止。
它解决的坑:
- “做完了”其实只是跑通本机,没有可交付物
- worktree 留一堆,后面越积越乱
4)真正“有货”的地方:Skills 才是发动机,不是装饰
发布公告里有一句话很直白:“Skills are the interesting part.”
为什么?因为 skills 让 Agent 的行为从“靠记忆和自觉”变成“靠规则和流程”。
作者还做了“压力测试(pressure test)”:用“生产事故每分钟亏 5000 美元”的场景逼问 Agent:你是直接开始 debug,还是先去找 debugging skill?然后根据失败情况不断强化 getting-started 的指令,让未来的 Claude 更守规矩。
你可以把它类比成:
- 没有 skills 的 Agent:聪明但没受过工程训练的实习生
- 有 skills 的 Agent:聪明 + 有班组长盯流程 + 每一步要打卡的工程师
5)怎么安装?选你正在用的那套工具就行
下面命令来自官方 README,我只做中文解释,不擅自改命令。
5.1 Claude Code(官方市场)
/plugin install superpowers@claude-plugins-official
或使用 Superpowers 自己的 marketplace:
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
5.2 Cursor
在 Cursor Agent chat 里:
/add-plugin superpowers
6)我建议你这样用:先拿一个小任务试出手感
如果你从没用过“流程化”的 Agent,建议第一周只练 3 件事:
- 只让它做 brainstorming + plan(你先不让它写代码)
- 只让它用 worktree 做隔离(你会立刻感觉世界清净了)
- 只让它按 TDD 走一遍(哪怕是一个很小的函数改动)
等你发现它终于“不乱改、会问问题、能验证复现”之后,再把子代理执行、code review 等环节加上去。
为了让你更快上手,我给你一个可直接照抄的“首次试跑清单”(10 分钟版本):
- 选一个极小任务:比如“修一个测试”“补一个边界条件”
- 先让它只做 brainstorming:把需求、约束、风险问清楚
- 让它写 plan:每步对应到文件路径 + 验证方式
- 进入 worktree:确保改动不污染主分支
- 跑一遍真 TDD:先让测试失败,再让它变绿
- 做一次 review:只看 Critical(严重问题)是否清零
7)常见误区:90% 的人会在这里翻车
误区 1:把它当“提示词合集”
Superpowers 更像“流程增强器”,不是“更强的 prompt”。prompt 只能影响一回合;流程能影响每一回合。
误区 2:以为流程会拖慢速度
你现在慢,往往慢在返工:写错方向 → 改 → 又错 → 再改。
Superpowers 用“前置澄清 + 小步验证”换“少走弯路”。
误区 3:你自己不愿意看计划
Superpowers 再强,也救不了“你不看它写的计划就让它开写”的习惯。你偷一次懒,它就会学到:原来可以跳过审查。
8)我的判断:这东西会成为“编码 Agent 的默认形态”
我不觉得 Superpowers 会取代任何一个模型。
但我非常确定:未来大家比的重点,会从“模型多会写”转到“工作流多稳定”。
你可以换 Claude / GPT / Gemini,甚至换工具链。
但“先澄清、再计划、隔离变更、测试驱动、阶段复审、标准化收尾”这一套,迟早会变成默认。
Superpowers 只是把它做得更早、更系统、更可复制。