Superpowers | 编码 Agent 方法论与 Skills 库 · TDD / 规划 / 子 Agent 工作流

Superpowers 是一套面向编码 Agent 的完整软件工程方法论：不是单个模型提示词，而是一组可组合的 Skills 与强制触发的工作流。Agent 在写代码前会先澄清需求、产出可审阅的设计与实现计划，再按 TDD、代码审查、git worktree 等步骤推进。作者 Jesse Vincent（Prime Radiant），MIT 开源。

仓库：https://github.com/obra/superpowers

TDD 驱动的完整开发流程

从「文章视角」看，Superpowers 的价值不只是装插件，而是把一次需求走成 可交付、可复盘 的工程闭环。典型五段式如下（与下方 Skills 一一对应）：

阶段	做什么	对应 Skill
需求澄清	写代码前先对齐目标、边界与不做清单；设计分块展示、逐段确认	brainstorming
任务拆解	把设计落成 2–5 分钟粒度任务，写明文件路径与验证步骤	writing-plans
测试驱动开发	RED → GREEN → REFACTOR；先写失败测试再写实现，禁止跳过	test-driven-development
小步快跑持续集成	独立 worktree / 分支上按任务推进；子 Agent 执行 + 两阶段审查；任务间 code review	using-git-worktrees、subagent-driven-development、executing-plans、requesting-code-review
交付前自查与质量复盘	证据优于宣称：跑测试、对照计划、严重问题阻塞合并；分支收尾（merge / PR / 保留 / 丢弃）	verification-before-completion、finishing-a-development-branch

与 Karpathy Guidelines 的配合：Superpowers 管「流程怎么走」，Karpathy 规范管「每一刀怎么改」——先澄清再动刀，先测试再实现，交付前用证据说话。

核心工作流（Skills 自动激活顺序）

典型开发链路（Skills 会在合适时机自动激活，而非可选建议）：

brainstorming — 写代码前先问清目标，分块展示设计供确认
using-git-worktrees — 设计通过后在新分支隔离工作区，验证测试基线
writing-plans — 拆成 2–5 分钟粒度的小任务，含文件路径与验证步骤
subagent-driven-development / executing-plans — 按任务派发子 Agent，两阶段审查（规格符合 → 代码质量）
test-driven-development — 强制 RED-GREEN-REFACTOR，先写失败测试再写实现
requesting-code-review — 任务间对照计划审查，严重问题阻塞进度
verification-before-completion — 声称完成前必须有运行时证据（测试输出、命令结果）
finishing-a-development-branch — 合并 / PR / 保留 / 丢弃分支的收尾流程

Skills 库概览

类别	代表 Skill
测试	test-driven-development
调试	systematic-debugging、verification-before-completion
协作	brainstorming、writing-plans、executing-plans、subagent-driven-development
Git	using-git-worktrees、finishing-a-development-branch
审查	requesting-code-review、receiving-code-review
并行	dispatching-parallel-agents

在 OpenCode 中安装

编辑全局或项目级 opencode.json，在 plugin 数组加入：

{
  "plugin": [
    "superpowers@git+https://github.com/obra/superpowers.git"
  ]
}

重启 OpenCode。插件会通过 OpenCode 插件管理器安装并注册全部 Skills。

验证：在对话中问「Tell me about your superpowers」，或让 Agent 用 skill 工具列出可用技能。

固定版本（可选）：

"superpowers@git+https://github.com/obra/superpowers.git#v5.0.3"

在 OpenCode 中使用

列出技能：让 Agent 使用 OpenCode 原生 skill 工具
加载技能：例如 superpowers/brainstorming
优先级：项目 .opencode/skills/ > 用户 ~/.config/opencode/skills/ > Superpowers 内置

插件机制：通过 experimental.chat.system.transform 注入 bootstrap 上下文；通过 config hook 注册 skills 目录，无需 symlink。

Claude Code 工具名在 OpenCode 中会自动映射（如 TodoWrite → todowrite，Task → @mention 子 Agent）。

与其他 harness

Superpowers 按 harness 分别安装（OpenCode、Claude Code、Codex CLI、Cursor、Gemini CLI 等各有入口）。在 OpenCode 装好后，若还用 Claude Code，需在那边单独安装 marketplace 版插件。

适用场景

希望 Agent 先规划再编码，减少「一上来就改文件」的翻车
团队或个人坚持 TDD、YAGNI、可验证的小步提交
已在用 OpenCode / Claude Code / Codex，想叠加标准化工程纪律

不太适合

只要一次性脚本、不需要流程约束的极短任务
不愿接受「先设计 / 先测试」带来的额外轮次
期望完全静默、零确认的全自动（Superpowers 强调分块确认与审查）

下一步

OpenCode 详细文档：https://github.com/obra/superpowers/blob/main/docs/README.opencode.md
与 Oh My OpenAgent 等多 Agent 编排插件可同装于 plugin 数组（见 OpenCode 工具页集成说明）
问题反馈：https://github.com/obra/superpowers/issues