Superpowers

Superpowers 是一套给 Claude Code、Cursor、Codex、Gemini CLI 等编码 Agent 用的软件开发工作流框架。作者 Jesse Vincent（obra）给它的定位是：「An agentic skills framework & software development methodology that works.」

它要解决的问题很具体：编码 Agent 默认的行为是拿到需求就直接写代码，写完就说"搞定了"。不做需求澄清、不做设计、不写测试、不做 review。结果是代码能跑但质量不可控，需求理解偏了也不知道。

Superpowers 把一套工程方法论（TDD、先规划后执行、子 Agent 并行、系统化调试）封装成 Claude Code 的 skill 插件，让 Agent 在编码过程中强制走这些流程。

核心 skill

按职能分四组：

协作类

• /brainstorming：苏格拉底式设计讨论，先把需求聊透再动手
• /writing-plans：生成分步实现计划，拆任务、标依赖、估复杂度
• /requesting-code-review：完成后发起自我审查，验证产出是否匹配计划

执行类

• /subagent-driven-development：把计划里的独立任务分发给子 Agent 并行执行，两阶段 review
• /using-git-worktrees：每个任务在独立 worktree 里做，互不干扰
• /finishing-a-development-branch：完成后决定合并方式（squash / PR / 清理）

质量类

• /test-driven-development：强制 RED-GREEN-REFACTOR 循环，先写失败测试再写实现
• /systematic-debugging：四阶段根因分析（复现 → 假设 → 验证 → 修复），不允许盲猜

工作流节奏

一个典型的开发任务走下来是这样的：

1. /brainstorming → 和用户把需求聊清楚，生成 spec
2. /writing-plans → 基于 spec 生成实现计划
3. /subagent-driven-development → 按计划并行执行，每个子任务走 TDD
4. /requesting-code-review → 执行完做一轮自审
5. /finishing-a-development-branch → 决定合并策略

每一步都可以人工确认或打断。它的价值不是让 Agent 跑得更快，而是让 Agent 的产出可预测、可验证。

适用场景

• 用 Claude Code / Cursor 做超过 50 行改动的功能开发，希望有结构化流程
• 团队里多人共用 Agent，需要统一的编码规范和质量门槛
• 习惯 TDD 但发现 Agent 不主动写测试
• 经常遇到 Agent 理解错需求然后跑偏的问题

不适用的情况

• 只是让 Agent 改几行代码或修个 typo
• 对 Agent 的工作流已经有自己的一套 prompt 规范
• 不用 Claude Code / Cursor / Codex / Gemini CLI 中的任何一个

安装

Claude Code（官方 marketplace）：

bash
/plugin install superpowers@claude-plugins-official

Claude Code（第三方 marketplace）：

bash
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

Cursor：

/add-plugin superpowers

GitHub Copilot CLI：

bash
copilot plugin marketplace add obra/superpowers-marketplace
copilot plugin install superpowers@superpowers-marketplace

Codex 和 OpenCode 需要手动配置，具体方式见仓库 README。

关于作者

Jesse Vincent（GitHub @obra），长期做开发者工具，早年做过 Request Tracker 和 keyboard.io。这套方法论是他在实际用 Agent 做项目的过程中逐步沉淀出来的，不是从理论出发设计的。

License：MIT。