Superpowers 深度调研:AI 编码代理的方法论技能框架
Superpowers 不是模型或 MCP 服务,而是一套把“先澄清、再设计、再计划、TDD、审查、验证”注入 AI 编码代理的技能方法论。价值在纪律,代价也在纪律。
1. 定位
Superpowers 是 Jesse Vincent(@obra) 发起的开源项目,官方定位是“a complete software development methodology for your coding agents”。它是一组可组合的 SKILL.md 技能与启动注入规则,让 Claude Code、OpenCode、Codex、Cursor、Gemini CLI、GitHub Copilot CLI 等编码代理按一套工程流程工作。
它解决四类常见失败:跳过设计、测试后补或不测、猜测式调试、未验证就声称完成。
Skills are mandatory workflows, not suggestions. If there is even a 1% chance a skill applies, invoke it before action.
| 维度 | 结论 |
|---|---|
| 项目类型 | Agentic skills framework + software development methodology |
| 许可证 | MIT |
| 支持平台 | Claude Code、OpenCode、Codex、Cursor、Gemini CLI、Copilot CLI、Kimi Code 等 |
| 核心价值 | 把工程纪律变成代理必须遵循的流程 |
| 主要代价 | 小任务流程过重、token 成本高、可能与 OpenCode 原生技能产生冲突 |
2. 核心工作流
官方 README 描述的流水线是: brainstorming 澄清需求 → using-git-worktrees 建隔离分支 → writing-plans 拆 2-5 分钟小任务 → subagent-driven-development/executing-plans 执行 → test-driven-development 红绿重构 → requesting-code-review 审查 → finishing-a-development-branch 验证并收尾。
这不是建议流程,而是 Superpowers 希望代理默认执行的工程节奏。
3. 技能库
| 类别 | 技能 | 作用 |
|---|---|---|
| 测试 | test-driven-development | 红绿重构,反对先写代码再补测 |
| 调试 | systematic-debugging | 四阶段根因分析 |
| 验证 | verification-before-completion | 未验证不得宣布完成 |
| 设计/计划 | brainstorming, writing-plans | 需求澄清与可执行计划 |
| 执行 | executing-plans, subagent-driven-development | 批量执行或用 subagent 推进 |
| 协作 | requesting-code-review, receiving-code-review | 审查与处理反馈 |
| 分支 | using-git-worktrees, finishing-a-development-branch | 隔离开发与收尾 |
| 元技能 | using-superpowers, writing-skills | 启动协议与创建新技能 |
这些技能的风格是强规则加反借口。TDD 技能把“生产代码必须由失败测试驱动”作为铁律;验证技能反对“应该好了”“看起来没问题”这类无证据表述。
4. OpenCode 集成方式
OpenCode 当前推荐在 opencode.json 的 plugin 数组加入 git-backed 包:
{
"plugin": ["superpowers@git+https://github.com/obra/superpowers.git"]
}重启 OpenCode 后,插件通过 experimental.chat.messages.transform 注入 bootstrap,并通过 config hook 注册技能目录。验证方式:问 Tell me about your superpowers。若也用 Claude Code、Codex 等,每个 harness 都要单独安装。
5. 与 subtask2 的关系
| 项目 | 定位 | 解决层级 |
|---|---|---|
| Superpowers | 工程方法论与技能库 | 告诉代理应该按什么流程做事 |
| subtask2 | OpenCode /command 编排增强 | 提供 return、loop、parallel、结果捕获等控制流能力 |
理想组合是:Superpowers 定义工程纪律,subtask2 定义命令级编排。但也要小心双重流程导致过度复杂。
6. 争议与建议
公开评论总体认可它对中大型功能、TDD、调试和验证的价值,但也有明显争议:小任务会变慢,token 成本高,流程强约束可能过度工程化。部分 OpenCode 用户反馈它会“每个 prompt 都触发”,造成 skill clash 或过度规划。
适合
- 中大型功能开发
- 需要 TDD 与审查纪律的项目
- 团队想统一 AI 编码流程
- 复杂 bug 的系统性调试
不适合
- 一两行快速修复
- 没有测试体系的项目
- 已经有成熟个人流程且讨厌强约束的开发者
- token/上下文预算很紧的环境
建议:在 OpenCode 中先不要全量启用到所有任务。更稳的策略是:中大型功能用 brainstorming + writing-plans + verification-before-completion;bug 修复用 systematic-debugging;实现阶段按需启用 TDD。若追求轻量,可只借鉴它的技能内容,不必安装整套插件。