Superpowers 是一款面向 AI 编程工具的技能框架，为 Claude Code、Cursor、Codox 等注入完整开发流程。自动触发 Brainstorm→Plan→TDD→CodeReview 工作流，让 AI 从'代码生成器'升级为'靠谱开发搭档'。MIT 开源，106 Stars。

🎤 引言

你有没有这种感觉：让 AI 写代码，它噼里啪啦一顿输出，结果跑不通，想改又不知道从哪下手？

比如你跟 Cursor 说"帮我写个用户登录模块"，它哗哗写了两百行，一跑起来直接报错了——你还没来得及高兴，就得花半小时 debug。最气人的是，bug 修完又冒出三个新 bug，因为你改的那个地方其实另有隐情。

问题不在 AI 不够聪明，而在于没有流程约束。它拿到需求就开写，写完就算交差，完全没有设计评审、没有测试、没有复查。就像给一个天才实习生下了指令却不给 SOP，结果全靠运气。

Superpowers 就是来解决这个问题的。它是一套"技能框架"，装到你的 AI 编程工具里之后，AI 会自动按人类工程师的标准流程走：先理解需求 → 出设计方案 → 制定实施计划 → TDD 开发 → 代码审查 → 收尾分支。一句话：让 AI 学会做事前先动脑子，而不是上来就莽。

⭐ 核心功能

Superpowers 本质上是一组可组合的技能模块，会在合适的时机自动触发，不需要你手动调用。

主要技能：

1. brainstorming — 设计评审
AI 不会一上来就写代码，而是先问你"你到底想解决什么问题"，用苏格拉底式提问把模糊想法细化。方案分块展示，你逐块确认后才进入下一步。整个过程像是在和一个有经验的架构师讨论，而不是在对一个代码生成器下指令。

2. writing-plans — 任务拆分
把设计方案拆成 2-5 分钟就能完成的小任务，每个任务包含：精确文件路径、完整代码片段、验证步骤。"写得含糊的任务"在这里就被消灭了。输出看起来就像一个senior 工程师给 intern 写的详细任务卡。

3. subagent-driven-development — 子 Agent 驱动开发
任务拆分完毕后，启动子 Agent 执行流：每个任务派一个 Fresh Agent 处理 → 第一个 Agent 完成后 → 派第二个 Agent 做 Spec 审查 → 再派第三个做代码质量审查。任何问题都会打回重做。GitHub 上有用户分享，用这个模式连续跑了两小时，任务全自动完成，中途没有一次人工介入。

4. test-driven-development — TDD 红绿重构
强制执行红→绿→重构循环：先写一个注定失败的测试 → 看它 fail → 写最少量代码让它 pass → 重构。整个过程不将就。TDD 反模式的坑（测私有方法、过度 mock、测试太慢）都有专门参考文档。

5. systematic-debugging — 系统化调试
遇到 Bug 不瞎试，固定流程：① 定位根因 ② 找规律 ③ 假设+验证 ④ 修根不止表面。GitHub Issues 里反馈最多的"AI 修 Bug 越修越烂"在这里被从源头杜绝。配套还有 condition-based-waiting 技术，专门对付那些"偶发性"bug。

6. finishing-a-development-branch — 分支收尾
任务全部完成后，给你 4 个选项：本地合并 / 推 PR / 保留 / 丢弃。清晰的决策流程，不留烂摊子。

📥 安装与使用

Superpowers 支持主流 AI 编程平台，安装方式各不同：

Claude Code（官方插件市场）：

/plugin install superpowers@claude-plugins-official

Claude Code（手动注册市场）：

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

Cursor：

/add-plugin superpowers

或在插件市场搜索 "superpowers"

Codex：

Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md

OpenCode：

Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md

Gemini：

gemini extensions install https://github.com/obra/superpowers
gemini extensions update superpowers

装完之后，开一个新 Session，说一句"帮我 plan 这个功能"或者"let's debug this issue"，Superpowers 就自动介入了。你会看到 AI 的回复里出现了"🔍 触发 brainstorming 技能"这样的提示，整个交互界面会切换到多轮对话模式——不再是简单的问答应答，而是一个有结构的工作流。

🎯 适用场景

适合用 Superpowers 的人：

  • 已经有 Claude Code / Cursor / Codex / OpenCode 使用经验，想让 AI 输出更稳定
  • 正在做需要长期迭代的项目，而不是一次性脚本
  • 对 AI 写代码"不敢信"，需要 TDD 和 Review 流程来兜底
  • 希望 AI 能自主工作几个小时不跑偏

不适合的场景：

  • 一次性小脚本（5 行搞定那种）—— 开流程太重
  • 完全不懂代码、无法做设计评审的人——AI 问问题时你得接得住
  • 公司保密项目——Skill 工作在本地，GitHub 访问可能受控

🔍 对比与替代方案

Superpowers 之前，这个领域主要有两类方案：

方案特点与 Superpowers 的区别
直接让 AI 裸写快，但质量不稳定缺少设计/TDD/Review 约束
自己写 Prompt 工程可控，但维护成本高Superpowers 把这套流程固化成可复用 Skill
Agent Coding 框架（如 Devin）端到端 Agent更重，Superpowers 是轻量技能层

Superpowers 的核心差异：不是再造一个 AI 编程工具，而是给现有工具注入工程纪律。 它不替换你的 Claude Code 或 Cursor，而是在它们基础上加了一层"流程护栏"。你可以理解为：Superpowers 是工具的工具。

整个 Skill 系统的文件结构很清晰，skills/ 目录下每个子目录就是一个独立的 Skill，每个 Skill 里有触发条件 (SKILL.md) 和参考文档。懂一点 Python 的话，完全可以自己魔改触发规则。

⚠️ 注意事项

1. 需要设计评审参与感
Superpowers 的 brainstorming 阶段需要你逐块确认方案。如果你丢给 AI 一个模糊需求就想当甩手掌柜，流程会卡在"等待确认"这一步。

2. 安装方式因平台而异
文档分散在不同文件里（README.codex.md / README.opencode.md），安装前先确认自己用哪个平台。

3. 106 Stars，说明还是早期项目
生态还不算丰富，Skill 数量有限。有问题主要靠 GitHub Issues 和 Discord 社区。

4. 子 Agent 调用成本会增加
每个任务走完会触发 2-3 个子 Agent，Token 消耗比单次对话高。预算敏感的项目要想清楚。

✅ 总结

Superpowers 解决的是一个很具体的问题：AI 编程工具很快，但不够靠谱。

通过把人类软件工程的"最佳实践"（TDD、设计评审、代码审查）封装成自动触发的 Skill，它让 AI 从"代码生成器"进化成真正的"开发搭档"。

优点：

  • 流程自动触发，不改变现有工作流
  • TDD 强制循环从根本上提升代码质量
  • 子 Agent 并行执行，复杂项目也能跑得起来
  • MIT 协议，完全开源

缺点：

  • 有学习成本，要理解 Skill 触发时机
  • 目前 Stars 106，项目还早期
  • Token 消耗比普通对话高

推荐指数：⭐⭐⭐⭐（扣一星因为项目年轻、生态待完善）

如果你已经在用 Claude Code 或 Cursor，想让 AI 输出更稳定，Superpowers 值得一试。