Superpowers 智能体开发方法论

Superpowers 是给 AI 编程 Agent 的完整软件开发方法论：先澄清需求写规格，再拆实施计划，强制红绿 TDD + YAGNI + DRY，子智能体驱动开发可连续自主推进数小时。支持 Claude Code、Codex、Cursor、Gemini CLI 等 14 种客户端。

Skill Documentation

摘要

Superpowers 是给 AI 编程 Agent 的一整套软件开发方法论，而不是单个技能。它由一组可组合的技能加一份启动指令构成：Agent 一看到你要做东西，不会直接写代码，而是先退一步问你真正想解决什么问题，把规格谈出来分段给你确认，再生成一份"连没品味、没判断力、讨厌写测试的热心新人都能照着做"的实施计划，最后用子智能体逐个任务推进。仓库在 GitHub 已积累 22 万 + star，支持 Claude Code、Codex、Cursor、Gemini CLI、OpenCode 等 14 种客户端。

它把开发流程拆成了什么

第一步：先谈清楚要做什么

Agent 不接受"帮我加个功能"就开工。它会反复追问背景、边界、失败场景，直到能写出一份规格。规格分成小段展示，短到你真的会读完，而不是甩一篇长文档让你点"同意"。

第二步：计划要笨得能执行

签字后 Agent 出实施计划，标准是假设执行者毫无项目上下文、毫无品味、不爱写测试——计划必须清晰到这种人也能照着做对。计划里强制三条原则：真正的红/绿 TDD（先看到测试失败再写实现）、YAGNI（不做当下不需要的东西）、DRY。

第三步：子智能体驱动开发

你说"go"之后，Agent 启动 subagent-driven-development：为每个工程任务派子智能体执行，做完检查、评审、再往下走。作者称连续自主工作两小时不偏离计划是常态。

自动触发，不用记命令

技能是自动激活的。你不需要背斜杠命令或手动切换模式，编程 Agent 装上之后就"自带超能力"。

安装方式（按客户端）

• Claude Code: `/plugin install superpowers@claude-plugins-official`（Anthropic 官方市场）
• Claude Code 自有市场: `/plugin marketplace add obra/superpowers-marketplace` 后安装
• Antigravity: `agy plugin install https://github.com/obra/superpowers`
• Codex App / CLI: 官方插件市场 `/plugins` 搜 superpowers
• Cursor: 对话里 `/add-plugin superpowers`
• Devin CLI: `devin plugins install obra/superpowers`
• 另支持 Factory Droid、Gemini CLI、GitHub Copilot CLI、Grok Build CLI、Kimi Code、OpenCode、Pi、Hermes Agent
• 多个客户端要分别装，装一次不通用

适合谁用

• 受够了 Agent"上来就写代码、写完不对、来回返工"的开发者
• 想给团队定一套跨模型跨工具统一开发规范的技术负责人
• 需要 Agent 长时间自主推进而不跑偏的场景

Superpowers 和普通提示词有什么不同?

提示词是一次性建议，Agent 可以听也可以忽略，下一轮对话就忘了。Superpowers 把"先谈需求、先写规格、红绿 TDD、逐任务评审"做成会自动触发的技能，成为 Agent 每一步都要过的关口。差别是"建议"和"流程"的差别：前者靠运气，后者产出稳定。

子智能体驱动开发会失控吗?

不会放任。流程要求你先批准规格、再批准实施计划，之后子智能体才按计划逐任务执行，每个任务都要经过检查和评审才继续。它自主的是执行环节，决策环节仍在你手上——计划是你签过字的，跑偏了对不上计划就会被卡住。

为什么强制真正的红绿 TDD?

"红绿"的关键是先看到测试失败。很多 Agent 会先写实现再补一个必然通过的测试，这种测试证明不了任何事。Superpowers 要求测试先失败再让它通过，这样测试才真的是行为的证据，重构时才敢依赖它。

一定要用 Claude Code 吗?

不需要。方法论本身与模型和工具无关，仓库为 14 种客户端提供了各自的安装路径，包括 Codex、Cursor、Gemini CLI、OpenCode、Copilot CLI、Kimi Code 等。如果你同时用多个工具，需要在每个工具里各装一次。