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 个阶段:

  1. 头脑风暴(Brainstorming)→ 理清需求
  2. Git Worktree → 创建隔离工作区
  3. 编写计划(Writing Plans)→ 拆分任务
  4. 子代理驱动开发 → 并行执行任务
  5. 测试驱动开发 → RED-GREEN-REFACTOR
  6. 代码审查 → 质量把关
  7. 完成分支 → 合并/PR

这些技能会自动触发,你不需要手动调用——安装后你的 AI 编码助手就拥有了 Superpowers。

第一步:安装 Superpowers

Claude Code(推荐)

方式一:官方插件市场

1
/plugin install superpowers@claude-plugins-official

方式二:Superpowers 市场

1
2
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@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
2
copilot plugin marketplace add obra/superpowers-marketplace
copilot plugin install superpowers@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 循环:

  1. 🔴 写一个失败的测试
  2. 看着它失败
  3. 🟢 写最少的代码让它通过
  4. 看着它通过
  5. 提交

铁律:如果代码在测试之前写,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 的核心用法:

  1. ✅ 在你的 AI 编码助手中安装 Superpowers
  2. ✅ 理解 7 阶段核心工作流(头脑风暴 → 计划 → TDD → 审查)
  3. ✅ 掌握 14 个核心技能的用途
  4. ✅ 了解 Superpowers 的设计哲学

Superpowers 的核心价值在于让 AI 编码助手遵循工程最佳实践,而不是让它随意写代码。通过强制执行 TDD、系统化调试和代码审查,你的 AI 助手不再是一个”热情但品味差的初级工程师”,而是一个遵循完整软件开发方法论的可靠伙伴。

📖 官方仓库:github.com/obra/superpowers
💬 Discord:加入社区
📝 发布公告:primeradiant.com/superpowers