Tool profile · 01 / 05

Superpowers

官方将其定位为面向 coding agents 的技能库与开发工作流。本站暂将它放在“过程纪律层”研究:它主要约束 Agent 怎样澄清、计划、测试、调试、审查并证明完成。

初步记录官方项目 · obra/superpowers核对日期 · 2026-08-21
主要形态
宿主插件 / skills
独立领域 CLI
不需要
主要关注
可靠执行与过程门禁

01 · Why included

为什么纳入 SDD 相关研究

初步观察

Superpowers 不以维护中央产品行为规格为核心,但它把 brainstorming 形成的设计、实施计划、测试和审查作为 Agent 开发的权威上下文。它适合用来研究“规格如何约束一次实现过程”。

02 · Problem

解决什么问题

官方事实

减少随意编码

通过 skills 把需求澄清、计划、TDD、系统化调试、代码审查和完成前验证组织成可重复流程。

初步观察

把 Agent 行为变成方法

重点不是保存长期产品事实,而是让每次开发都有设计批准、可执行计划和验证证据。

03 · Core assets

核心资产

design spec

brainstorming 后形成、由用户确认的设计依据。

implementation plan

把设计拆成可验证的小步骤。

tests & review evidence

TDD、调试、审查与完成前验证留下的实现证据。

04 · Workflow

第一版理解的基本工作流

  1. Brainstorm
    调查现状、逐项澄清需求、比较方案并取得设计批准。
  2. Plan
    将批准的设计写成可验证、可执行的实施计划。
  3. Implement
    通过执行计划或 subagent 分工推进任务,并应用 TDD 与系统化调试。
  4. Review
    检查规格符合度和代码质量,修复问题。
  5. Verify & finish
    用新鲜证据证明结果,再交付人工验收和分支收尾。

05 · Installation

安装与运行形态

官方安装方式随宿主而异,不存在一条跨所有宿主的统一运行命令。

Codex

Codex App 与 Codex CLI 均可从官方插件市场安装 Superpowers;Codex CLI 使用 /plugins 打开插件搜索。

其他宿主

Claude Code、Cursor、Gemini CLI、OpenCode 等使用各自的插件、扩展或安装机制;如果同时使用多个宿主,需要分别安装。

06 · CLI & host

是否必须安装 CLI

结论

不需要额外安装一个 Superpowers 领域 CLI

需要安装的是适配当前 coding agent 的插件或 skills。具体流程依靠宿主 Agent 调用文件、终端、Git、测试和协作能力。

宿主 coding agent必须,例如 Codex、Claude Code 或 Cursor。
Superpowers 独立 CLI不需要;官方当前以插件/skills 分发。
项目工具按任务需要 Git、测试、lint、构建工具等。

07 · Early strengths

初步优势

  • 对 Agent 的设计、实施和验证行为提供明确门禁。
  • 把 TDD、调试和审查放进同一方法体系,而不只生成规格文件。
  • 通过宿主插件直接融入日常 coding agent 对话。

08 · Limits

限制与风险

  • 强流程会增加小任务的交互与文档成本,实际收益需要按任务规模验证。
  • 它不以持续维护中央产品行为规格为核心,长期事实仍需其他机制承载。
  • 不同宿主拥有的 subagent、计划和审查能力不同,体验不会完全一致。

09 · Scenarios

可能适用的场景

当团队更担心 Agent 跳过需求澄清、测试或审查,而不是缺少一个长期规格仓库时,Superpowers 的过程纪律可能更有价值。极小、一次性或高度探索性的任务需要评估完整门禁是否过重。

10 · Relations

与其他工具的初步关系

初步观察

Superpowers 更靠近“怎样可靠实现”。它可以消费 OpenSpec、Spec Kit 或其他方法产生的权威需求与设计,但组合时必须选定唯一的 design/tasks 和审批责任,避免双重规划与重复门禁。

11 · Next research

后续研究问题

  • 在同一个小功能中,完整门禁实际增加多少交互和时间?
  • Codex、Claude Code 和 Cursor 的 skill 触发一致性如何?
  • 需求变化时,设计规格和实施计划怎样避免漂移?
  • 与 OpenSpec 等长期规格工具组合时,哪份任务清单应作为权威?