如果你很早就装了 Superpowers，现在该升级了

我应该算是比较早用上 Superpowers 的一批人。

当时吸引我的，并不是它又提供了几个 Prompt，而是它给 Coding Agent 建立了一套更完整的软件开发流程：先理解需求、讨论设计，再拆解计划、编写测试、实现功能、审核代码，最后验证结果。

它解决了早期 Coding Agent 一个很常见的问题：Agent 一拿到需求就开始写代码，执行速度看起来很快，最后却经常偏离真正的目标。

安装 Superpowers 以后，这套流程一直能用。也正因为它一直能用，我们后来几乎忘记了一件事：Superpowers 自己也在快速升级。

最近我重新检查本地环境时才发现，我们还在使用几个月前安装的版本。插件缓存停留在 v5.0.7，实际生效的 Skills 甚至混合了几个不同时间的版本。

而 Superpowers 上游已经发布了 v6.1.1。

这让我意识到一个很容易被忽略的问题：

我们很早就用上了一个好工具，却不等于会自动获得它后续的所有进步。

过去几个月，AI Agent 的发展非常快，Superpowers 也已经不再是我们最初安装时的那套工作流。如果你也是很早安装、之后一直没有检查版本，现在确实应该升级了。

Superpowers 是什么

Superpowers 是一套面向 Coding Agent 的软件开发方法和 Skills 集合。

它不只是教 Agent “怎么写代码”，而是约束 Agent “应该按照什么顺序完成开发”：

1. 先通过 brainstorming 理解需求和设计方案；
2. 使用 writing-plans 把设计拆成可执行任务；
3. 通过 test-driven-development 强调测试先行；
4. 使用 Subagent 分工实现和审核；
5. 遇到问题时进入 systematic-debugging，避免凭感觉乱改；
6. 完成前必须通过 verification-before-completion 验证结果。

真正有价值的地方，是它把很多优秀工程师依靠经验完成的动作，变成了 Agent 可以遵守的显式流程。

为什么这次值得升级

从 v5.0.7 到 v6.1.1，Superpowers 的变化很多，但普通使用者不需要逐条阅读 Release Notes。真正值得关注的，可以概括为四点。

1. 多 Agent 开发更快，也更省 Token

旧版在每个任务完成后，会进行多轮相对重复的审核。新版重新整理了审核流程，减少重复读取任务和代码的次数，同时在所有任务结束后保留一次全局审核。

对使用者来说，最直接的感受就是：

• Subagent 之间的重复工作更少；
• 长任务不需要反复传递同一批上下文；
• 审核仍然存在，但整体执行速度更快；
• Token 消耗更可控。

根据 Superpowers 官方在 v6.0 中公布的评测，在其测试场景里，Claude Code 和 Codex 在保持相近质量的同时，执行速度大约提升到原来的两倍，Token 消耗减少接近 50%。官方也强调，这个结果不一定适用于所有模型和任务，但至少说明新版正在认真解决 Agent 长任务中的成本问题。

参考：Superpowers v6.0.0 Release Notes

2. Agent 更不容易在执行过程中跑偏

很多 Coding Agent 失败，并不是因为不会写代码，而是因为任务执行到一半后，忘记了最初的约束。

例如：

• 不能增加新依赖；
• 必须兼容旧接口；
• 某个命名不能改变；
• 不同任务之间必须遵守同一个数据结构；
• 计划本身存在冲突，却直到实现阶段才被发现。

新版 Superpowers 加强了计划检查和约束传递。它会更明确地把全局要求交给后续任务，并在真正开始实现前先检查计划是否自相矛盾。

对于使用者来说，不需要理解内部增加了哪些字段。只需要知道：新版更重视把一开始确认的设计和约束，完整传递到后面的每一个 Agent。

这会减少一种非常常见的返工：每个局部任务看起来都完成了，最后拼起来却不是最初想要的结果。

3. Worktree 和分支操作更安全

Superpowers 一直建议使用 Git Worktree 隔离开发任务。但如果 Agent 自动创建、移动或清理 Worktree，也可能给用户带来风险。

新版在这方面更加谨慎：

• 创建 Worktree 前会先询问用户；
• 如果 Codex 已经提供原生隔离能力，会优先使用平台能力；
• 不会随意清理来源不明的 Worktree；
• 对已经处于 Worktree、Detached HEAD 等情况处理得更合理。

这类升级可能不像“新增一个 Skill”那么显眼，但对真正把 Agent 用在项目开发中的人来说非常重要。

一个成熟的 Agent 工作流，不只要能完成任务，也要知道哪些操作必须先获得用户授权。

4. 对 Codex 的适配更自然了

我们最初安装 Superpowers 时，很多 Agent 平台还没有成熟的 Skill 发现机制，因此需要通过启动 Hook 把 Superpowers 的规则注入会话。

现在 Codex 已经能够原生发现 Skills，旧的注入方式反而可能带来重复加载和额外的 Token 消耗。

v6.1 针对 Codex 做了明显调整：

• 支持通过 Codex 插件市场安装；
• 使用 Codex 原生 Skill 发现能力；
• 减少不再必要的启动 Hook；
• 压缩每个会话都会加载的基础说明，降低固定 Token 成本；
• 修复重复注册 Hook 和信任提示等问题。

这些变化说明，Superpowers 已经从“适配 Coding Agent 的一组通用提示词”，逐渐变成了一套会针对不同 Agent Runtime 持续优化的工程化项目。

参考：Superpowers v6.1.0 Release Notes、Superpowers v6.1.1 Release Notes

最简单的升级方法

如果你使用 Codex，最简单的方法不是自己研究每个 Skill 文件，也不是手工对比几十个目录。

直接把下面这句话交给 Codex：

检查我本地 Superpowers 当前版本，备份现有 Superpowers Skills，然后升级到 obra/superpowers 最新稳定版。不要覆盖其他自定义 Skills，升级后验证 using-superpowers、brainstorming 和 subagent-driven-development 能否被正常发现。

让 Agent 自动完成以下工作：

• 找到真正生效的 Skill 目录；
• 识别是否存在多个旧版本；
• 备份当前文件；
• 从正式 Release 安装最新稳定版；
• 做一次最基本的可用性验证。

升级完成后，新建一个 Codex 任务，输入一个需要设计或开发的需求，观察它是否会主动触发 brainstorming。能够正确发现和触发新版 Skill，基本就说明升级已经生效。

Codex App 用户也可以直接在侧边栏打开 Plugins，搜索 Superpowers，并按照插件市场提示安装或更新。最新安装方式以官方仓库为准：obra/superpowers

Skill 不是安装一次就结束了

这次升级给我最大的提醒，并不是 Superpowers 又增加了多少功能，而是我们应该改变对 Skill 的理解。

Skill 看起来是 Markdown，但它实际控制的是 Agent 的行为：什么时候提问、什么时候写代码、如何拆分任务、是否使用 Subagent、如何审核、如何处理 Git，以及在什么条件下才能宣布任务完成。

因此，Skill 更像是 Agent Runtime 的行为依赖，而不是一份静态文档。

既然我们会升级开发框架、依赖库、Docker Image、IDE 插件和 CI Workflow，也应该定期检查重要 Skills：

• 当前使用的是哪个版本；
• 是否存在多个来源的同名 Skill；
• 上游最近是否改变了工作流；
• 新版本是否更适配当前使用的 Agent 平台；
• 升级后能否正常触发。

AI 发展的速度很快，几个月没有升级的 Skill，背后的最佳实践可能已经变化了一轮。

如果你是在几个月前安装的 Superpowers，并且之后再也没有检查过，现在就是一个合适的升级时间。

先让 Codex 帮你检查一下版本。你可能会发现：你正在使用的 Superpowers，早已不是今天的 Superpowers。

---

参考资料

• obra/superpowers GitHub 仓库
• Superpowers v6.0.0 Release Notes
• Superpowers v6.1.0 Release Notes
• Superpowers v6.1.1 Release Notes