你的 Superpowers 该更新了:6.0 给 Agent 上规矩

lxiol

如果你已经在用 Superpowers,我建议这次直接更新到最新 6.0.x。这轮不是”又多了几个 skill”。6.0 改的是长任务工作流:子 Agent 怎么接任务,review 怎么跑,计划怎么写,临时文件放哪里,以及 Codex 这类非 Claude 工具怎么更自然地接进来。

我看完这次更新后,最直接的判断是:Superpowers 正在从”AI 编程技能包”,变成一套更像工程流程的东西。它提醒 Agent 要 TDD、要 review、要先问清需求,也在尽量减少一种常见失败:你让 Agent 跑一个复杂任务,它一开始计划写得很好,中途 diff 越堆越大,review 看起来也跑了,最后它说”完成了”,但你根本不知道哪些判断真的经过验证。6.0 就是在修这个问题。

截至 2026 年 6 月 22 日,上游 obra/superpowers 最新 release 是 v6.0.3。6.0.0 是大版本更新,v6.0.2 修了安装包里的 evals submodule 问题,v6.0.3 又把 SDD 的 scratch 文件从 .git/ 挪到了 .superpowers/sdd/。所以现在要更新,我会直接看最新的 6.0.x,而不是只盯 v6.0.0。

先看差异:6.0 到底改了哪里

环节 老版本更像什么 6.0 改成什么 对使用者的影响
SDD review 两类 reviewer 分开跑,diff 和任务说明容易在上下文里来回传 一个 task-reviewer-prompt.md 同时看规格和质量,任务材料更多走文件交接 review 成本更低,也更不容易被 controller 的解释带偏
计划结构 计划像提纲,约束散在聊天记录里 增加 Global Constraints 和 Interfaces 子 Agent 拿到任务时更清楚边界,少靠猜
模型选择 子任务和 reviewer 容易继承当前会话模型 dispatch 时要求明确模型 减少无意中全程用贵模型跑机械任务
可视化 brainstorm 本地 companion server 缺少足够鉴权 每个 session 有 key,文件访问和响应头更收紧 远程机器、共享网络里更安全
Codex 接入 更像 Claude Code 工作流的延伸 Codex 有自己的 SessionStart hook、安装说明和工具映射 Codex 用户不用把它当”凑合可用”的移植版
临时文件 SDD scratch 曾放在 .git/ 附近 v6.0.3 挪到 .superpowers/sdd/ 避免和 Claude Code 等工具的保护路径冲突

Superpowers 不是 prompt 包,它管的是”什么时候不能直接写代码”

很多人第一次看到 Superpowers,会把它理解成”Claude Code 的一堆提示词”。这个理解太轻了。上游 README 对它的定位是:一套给 coding agent 用的软件开发方法论。它把 brainstorming、writing-plans、subagent-driven-development、code review、verification 这些流程拆成可触发的 skill,让 Agent 在合适的时间进入对应流程。

这和普通 prompt 集合差别很大。普通 prompt 多半解决”这一轮怎么回答”。Superpowers 更像是在解决”这一轮是不是应该回答”。需求没问清,先 brainstorm;设计确认了,再写 plan;计划通过了,再执行;执行完,还要 review 和验证。

这个思路很适合现在的 AI 编程。模型已经很会写代码了,但越会写,越容易在边界没说清时抢跑。Superpowers 的价值,就是在 Agent 想直接冲出去之前,先给它上几道闸。6.0 这次最该看的,就是这些闸门怎么变严了。

核心更新一:SDD review 变便宜,也更难被糊弄

这次 6.0 的主角是 subagent-driven-development,也就是 SDD。官方 release notes 里说,在他们的 eval 里,Claude Code 和 Codex 在结果质量接近的情况下,大约快一倍,token 消耗接近少一半。这个数字我不会照搬成所有人的固定收益,因为项目复杂度、工具环境、模型选择都会影响结果。但这里暴露的问题很准:以前很多 token 都耗在 review 流程上,写代码反而不是最大头。

旧流程里,每个任务可能要跑两个 reviewer,一个看规格符合性,一个看代码质量。任务文本和 diff 也经常通过对话大段传来传去。结果就是上下文越来越贵,reviewer 还容易被 controller 的解释带偏。

6.0 把这套流程改得更硬。现在每个任务用一个 task-reviewer-prompt.md,一次读取 diff,同时给出两个判断:规格有没有满足,代码质量有没有问题。任务说明和 review diff 改成文件交接,减少把大块 diff 塞进上下文。每次 dispatch 还必须写清楚模型,避免 reviewer 默认继承当前会话里最贵的模型。

我最在意的是另一点:controller 不能提前告诉 reviewer 忽略什么,也不能提前压低严重性。这很像真实团队的 code review。实现者可以解释为什么这么写,但不能替 reviewer 下结论。Superpowers 这次明确要求 reviewer 只读不改、对实现者的理由保持怀疑、用文件和行号支撑 finding。这个改动不花哨,但对长任务很有用。很多 AI 长任务并不缺 review 步骤,缺的是不被 controller 话术带偏的 review。6.0 明显在堵这个洞。

核心更新二:计划开始承载真实约束,而不是写给人看的提纲

我以前看 AI 写计划,最烦的是它看起来很完整,但一执行就散。比如一句:实现权限校验,补充测试,保持兼容。这句话放在计划里很顺,放到执行里就很虚。什么叫兼容?哪些接口不能变?错误码有没有固定值?测试覆盖哪些边界?如果这些没写清,子 Agent 只拿到自己的任务时,还是会猜。

6.0 的 writing-plans 开始补这个问题。计划里新增了 Global Constraints,用来放所有任务都必须遵守的规则,比如版本限制、依赖限制、命名、精确文案、不能碰的目录。每个任务也会有 Interfaces,写清楚它消耗什么、产出什么,避免子 Agent 只看到局部任务后乱猜相邻模块的合同。

这对 Codex 用户尤其有用。Codex 跑长任务时,经常会在多个文件、多个工具调用之间来回切。你一开始说过的约束,如果没有沉到计划和任务里,后面就可能丢。6.0 的计划更像工作单。它要让后续执行、review、恢复上下文都能拿到同一组约束,而不是只给人看一个漂亮提纲。

核心更新三:brainstorm 可视化伴侣补了安全模型

6.0 还有一个不太适合做标题、但很应该更新的点:brainstorming visual companion 的安全模型。这个 visual companion 本质上是一个本地小 web server。Agent 在头脑风暴时,可以打开浏览器展示 mermaid 图、结构图、决策树。旧版本鉴权薄弱,共享网络里可能被人直接访问。

6.0 给每个 session 加了 key,文件访问和响应头更收紧。这不算大功能,但在远程机器或团队共享环境里,属于”不出事没感觉,一出事很麻烦”的补丁。既然 Superpowers 鼓励在 brainstorm 阶段用可视化辅助,安全模型就必须跟上。

核心更新四:Codex 不再是”凑合可用”的移植版

Superpowers 最早是给 Claude Code 写的。Codex 用户之前也能用,但体验像是”把 Claude 的 workflow 硬套到 Codex 上”。6.0 专门给 Codex 做了 SessionStart hook、独立的安装说明和工具映射。Codex 有自己的 agent 行为模式,直接复用 Claude 的 hook 会错位。

这个改动说明 Superpowers 的野心不只是”Claude Code 的最佳搭档”,而是”所有 coding agent 的通用工程流程”。Codex 是第一步,后面可能还会有更多工具接入。对同时用 Claude Code 和 Codex 的人来说,6.0 让切换成本变低了。

核心更新五:临时文件路径规范化

v6.0.3 把 SDD 的 scratch 文件从 .git/ 附近挪到 .superpowers/sdd/。这个改动很小,但解决了实际问题:Claude Code 等工具会保护 .git/ 目录,scratch 文件放在附近可能触发意外行为。规范路径后,Superpowers 的临时文件和工具的保护逻辑不再冲突。

我的判断

Superpowers 6.0 不是加功能,是修流程。它把 review 变得更独立、计划变得更具体、安全变得更默认、多工具支持变得更自然。这些改动不 flashy,但对长任务质量的影响是真实的。

如果你已经在用 Superpowers,建议直接升到 6.0.3。如果你还没用,现在入坑的时机也不错——6.0 的文档和流程已经比早期版本成熟很多,eval 数据也更有说服力。

最后提醒一句:Superpowers 是方法论,不是魔法。它能让 Agent 在边界不清时停下来问,但前提是你要愿意花时间回答。如果你习惯”直接写代码,不行再改”,Superpowers 可能会让你觉得慢。但如果你想要的是”一次做对,少返工”,6.0 的方向是对的。

GitHub: https://github.com/obra/superpowers

  • 标题: 你的 Superpowers 该更新了:6.0 给 Agent 上规矩
  • 作者: lxiol
  • 创建于 : 2026-06-23 11:00:00
  • 更新于 : 2026-06-23 18:56:57
  • 链接: https://blog.lxiol.cn/2026/06/23/2026-06-23-superpowers-6-0-agent-workflow/
  • 版权声明: 本文章采用 CC BY-NC-SA 4.0 进行许可。