Superpowers 教程:让 AI 编码助手拥有完整软件开发方法论
Superpowers 教程:让 AI 编码助手拥有完整软件开发方法论
小新软件平替你有没有遇到过这种情况:让 Claude Code 帮你写代码,它二话不说就开始输出代码,结果写出来的东西逻辑混乱、没有测试、不符合你的需求?Superpowers 就是来解决这个问题的——它不是让 AI 更快地写代码,而是让 AI 先想清楚再动手,遵循一套完整的软件开发方法论。
Superpowers 是什么? Superpowers 是一个开源的 AI 编码技能框架(MIT 许可证,202k+ GitHub Stars),由 Jesse Vincent 和 Prime Radiant 团队开发。它通过可组合的技能模块为 Claude Code、Codex CLI、Cursor、Gemini CLI、OpenCode、GitHub Copilot CLI 等 8 款 AI 编码助手注入完整的软件开发方法论——从需求头脑风暴到子代理驱动开发,再到代码审查和分支合并。
前提条件
- AI 编码助手:以下任一即可:
- Claude Code(推荐)
- Codex CLI / Codex App
- Cursor
- Gemini CLI
- OpenCode
- Factory Droid
- GitHub Copilot CLI
💡 提示:如果你使用多个 AI 编码助手,需要为每个助手分别安装 Superpowers。
概述
Superpowers 的核心理念是:AI 编码助手不应该直接跳进写代码的环节。相反,它应该先退后一步,问你到底想做什么,然后制定计划,再按照计划执行。
整个工作流程分为 7 个阶段:
- 头脑风暴(Brainstorming)→ 理清需求
- Git Worktree → 创建隔离工作区
- 编写计划(Writing Plans)→ 拆分任务
- 子代理驱动开发 → 并行执行任务
- 测试驱动开发 → RED-GREEN-REFACTOR
- 代码审查 → 质量把关
- 完成分支 → 合并/PR
这些技能会自动触发,你不需要手动调用——安装后你的 AI 编码助手就拥有了 Superpowers。
第一步:安装 Superpowers
Claude Code(推荐)
方式一:官方插件市场
1 | /plugin install superpowers@claude-plugins-official |
方式二:Superpowers 市场
1 | /plugin marketplace add obra/superpowers-marketplace |
Codex CLI
1 | /plugins |
搜索 superpowers,选择 Install Plugin。
Cursor
在 Cursor Agent 聊天中:
1 | /add-plugin superpowers |
或在插件市场搜索 “superpowers”。
Gemini CLI
1 | gemini extensions install https://github.com/obra/superpowers |
OpenCode
在 OpenCode 中告诉它:
1 | Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md |
GitHub Copilot CLI
1 | copilot plugin marketplace add obra/superpowers-marketplace |
第二步:理解核心工作流
1. 头脑风暴(Brainstorming)
当你告诉 AI 你想构建什么时,Superpowers 不会让它直接写代码。相反,它会:
- 通过提问理清你的真实需求
- 探索替代方案
- 分段展示设计方案供你确认
- 保存设计文档
💡 提示:这是 Superpowers 最有价值的环节——它确保 AI 理解了你真正想要什么,而不是它认为你想要什么。
2. Git Worktree
设计通过后,Superpowers 会:
- 在新分支上创建隔离的工作区
- 运行项目初始化
- 验证测试基线是否干净
3. 编写计划(Writing Plans)
Superpowers 会将工作拆分为小任务(每个 2-5 分钟),每个任务包含:
- 精确的文件路径
- 完整的代码
- 验证步骤
计划的设计目标是:即使是一个”热情但品味差、没有判断力、没有项目上下文、讨厌测试的初级工程师”也能执行。
4. 子代理驱动开发
执行计划时,Superpowers 会:
- 为每个任务分派一个全新的子代理
- 子代理独立完成任务
- 两个阶段的审查:规范合规性 → 代码质量
- Claude 可以自主工作数小时而不偏离计划
5. 测试驱动开发(TDD)
Superpowers 强制执行 RED-GREEN-REFACTOR 循环:
- 🔴 写一个失败的测试
- 看着它失败
- 🟢 写最少的代码让它通过
- 看着它通过
- 提交
铁律:如果代码在测试之前写,Superpowers 会删除那段代码。
6. 代码审查
任务之间,Superpowers 会:
- 对照计划审查代码
- 按严重程度报告问题
- 关键问题会阻止进度
7. 完成分支
所有任务完成后,Superpowers 会:
- 验证测试
- 提供选项:合并 / 创建 PR / 保留 / 丢弃
- 清理工作树
第三步:掌握 14 个核心技能
测试
| 技能 | 用途 |
|---|---|
| test-driven-development | RED-GREEN-REFACTOR 循环(含测试反模式参考) |
调试
| 技能 | 用途 |
|---|---|
| systematic-debugging | 4 阶段根因分析流程(含根因追踪、纵深防御、条件等待技术) |
| verification-before-completion | 确保问题真正被修复 |
协作
| 技能 | 用途 |
|---|---|
| brainstorming | 苏格拉底式设计优化 |
| writing-plans | 详细的实现计划 |
| executing-plans | 分批执行 + 检查点 |
| dispatching-parallel-agents | 并发子代理工作流 |
| requesting-code-review | 预审查清单 |
| receiving-code-review | 响应反馈 |
| using-git-worktrees | 并行开发分支 |
| finishing-a-development-branch | 合并/PR 决策流程 |
| subagent-driven-development | 快速迭代 + 两阶段审查 |
元技能
| 技能 | 用途 |
|---|---|
| writing-skills | 创建新技能的最佳实践 |
| using-superpowers | 技能系统入门 |
设计哲学
Superpowers 的核心理念:
- 测试驱动开发:先写测试,永远如此
- 系统化 > 临时方案:流程优于猜测
- 降低复杂度:简洁是首要目标
- 证据 > 声称:验证后再宣布成功
常见问题(FAQ)
Q: Superpowers 会自动触发吗?
A: 是的。安装后,AI 编码助手会在每次任务前检查相关技能。这是强制性工作流,不是建议。
Q: 支持哪些 AI 编码助手?
A: 目前支持 8 款:Claude Code、Codex CLI、Codex App、Factory Droid、Gemini CLI、OpenCode、Cursor、GitHub Copilot CLI。
Q: Superpowers 和其他 AI 编码技能包有什么区别?
A: Superpowers 不只是一个技能集合——它是一套完整的软件开发方法论。它会强制执行 TDD、系统化调试、代码审查等工程实践,而不是让 AI 随意写代码。
Q: 如何更新 Superpowers?
A: 取决于你的 AI 编码助手,但通常是自动更新的。
Q: 可以贡献新技能吗?
A: Superpowers 一般不接受新技能贡献。任何技能更新必须在所有支持的编码助手上都能工作。详见 skills/writing-skills/SKILL.md。
总结
通过本教程,你已经掌握了 Superpowers 的核心用法:
- ✅ 在你的 AI 编码助手中安装 Superpowers
- ✅ 理解 7 阶段核心工作流(头脑风暴 → 计划 → TDD → 审查)
- ✅ 掌握 14 个核心技能的用途
- ✅ 了解 Superpowers 的设计哲学
Superpowers 的核心价值在于让 AI 编码助手遵循工程最佳实践,而不是让它随意写代码。通过强制执行 TDD、系统化调试和代码审查,你的 AI 助手不再是一个”热情但品味差的初级工程师”,而是一个遵循完整软件开发方法论的可靠伙伴。
📖 官方仓库:github.com/obra/superpowers
💬 Discord:加入社区
📝 发布公告:primeradiant.com/superpowers










