Superpowers:让 AI 编程助手走完＂设计→开发→审查→交付＂全流程

一句话：Superpowers 是一个插件，安装后你的 AI 编程助手（如 Claude Code、Cursor）会自动遵循专业的软件工程流程来写代码，而不是拿到需求就乱写。

一、这个项目是干什么的？

先说背景

现在很多开发者用 AI 编程助手（Claude Code、Cursor、Codex 等）来写代码。你在对话框里说”帮我写一个登录功能”，AI 就开始写了。

问题是：AI 写代码的方式像一个不守规矩的实习生 —— 拿到需求就动手，不问清楚、不写测试、不做代码审查、修 Bug 靠猜。代码能跑，但质量没保障。

Superpowers 做了什么

Superpowers 是一个插件，安装到你的 AI 编程助手后，它会给 AI 注入一套工作规范（项目里叫”技能/Skills”）。安装后，AI 的行为会变成这样：

基本信息

二、核心理念（四句话）

三、它解决了什么问题？

用 AI 写代码时，你大概率遇到过这些情况：

1. AI 不理解你要什么就开始写

你说”加个搜索功能”，AI 直接写了个全文搜索。但你其实只想要个简单的列表过滤。

Superpowers 的做法：强制 AI 先跟你一问一答地确认需求（叫”头脑风暴”），确认完写成设计文档，你批准后才能动手。

2. 写完代码没有测试

AI 写了 200 行代码说”完成了”，但没有任何测试。你也不知道这代码到底对不对。

Superpowers 的做法：强制 AI 遵循 TDD（测试驱动开发）—— 先写一个测试，看它失败，再写代码让它通过。没有测试就不许写代码。

3. 修 Bug 靠猜，改了三次还没修好

测试报错了，AI 改了一行代码说”试试这个”。不行。又改一行。还不行。

Superpowers 的做法：强制 AI 走四步调试流程 —— 先读错误信息、复现问题、分析原因，找到根因后再改。猜了三次还没修好？停下来，可能是架构有问题。

4. 大任务写着写着就乱了

你让 AI 重构一个模块，它改着改着忘了前面改了什么，开始自相矛盾。

Superpowers 的做法：把大任务拆成 2-5 分钟的小步骤，每个步骤派一个全新的 AI 去做（叫”子 Agent”），做完有人审查，互不干扰。

5. AI 说”完成了”但其实没验证

AI 说”所有测试通过”，但它根本没跑测试，只是觉得应该能过。

Superpowers 的做法：必须真的跑验证命令，看到输出结果，才能说”完成”。禁止说”应该没问题”。

四、14 个技能一览

Superpowers 包含 14 个技能模块，按工作阶段分为四组。你不需要手动调用它们 —— AI 会根据你的请求自动选择合适的技能。

需求与设计

编码与执行

质量保障

收尾与扩展

五、完整工作流程

六、技术实现

它是怎么工作的？

Superpowers 的工作原理很简单：

1. 你安装插件后，每次启动 AI 会话时，一个钩子脚本（hook）会自动运行
2. 这个脚本把所有技能的规则注入到 AI 的上下文中
3. AI 读到这些规则后，就会按规则行事

类比：就像给新员工发了一本《开发规范手册》，他读完后就知道该怎么做了。

技术栈

一个有意思的组件：可视化伴侣服务器

在”头脑风暴”阶段，如果涉及 UI 设计（比如讨论页面布局），AI 可以启动一个本地 Web 服务器，在浏览器里展示设计方案。你可以直接在浏览器里点选你喜欢的方案，选择结果会自动回传给 AI。

工作原理：

这个服务器的特点：

• 零依赖：
  
  不需要 npm install 任何东西，WebSocket 协议都是手写实现的
• 自动管理：
  
  30 分钟没人用就自动关闭，不会留下僵尸进程
• 跨平台：
  
  Windows、macOS、Linux 都能用

项目结构（简化版）

七、怎么安装？

根据你用的 AI 工具选择对应的安装方式：

Claude Code（推荐）

/plugin install superpowers@claude-plugins-official

Cursor

在插件市场搜索 “superpowers” 安装。

Codex

告诉 Codex 执行：

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

OpenCode

在 opencode.json 中添加：

{  "plugin": ["superpowers@git+https://github.com/obra/superpowers.git"]}

Gemini CLI

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

验证安装成功

启动一个新会话，试着说：

• “帮我加个新功能” → AI 应该会先跟你讨论需求，而不是直接写代码
• “这个测试为什么失败了” → AI 应该会先分析原因，而不是直接改代码

如果 AI 的行为变了，说明安装成功。

八、关键设计决策

为什么要用”子 Agent”？

当 AI 在一个长对话里连续做很多任务时，前面任务的信息会”污染”后面的任务。比如任务 1 里讨论了数据库设计，到任务 5 时 AI 可能会把任务 1 的某些细节搞混。

Superpowers 的做法是：每个任务派一个全新的 AI 去做。这个 AI 只拿到它需要的信息（任务描述 + 相关代码），做完就结束。下一个任务再派一个新的。

好处：每个任务的 AI 都是”头脑清醒”的，不会被之前的信息干扰。

为什么要两轮审查？

每个任务做完后，会经过两轮审查：

1. 功能审查
   
   （Spec Review）：做出来的东西跟任务要求一致吗？
2. 质量审查
   
   （Quality Review）：代码写得好不好？有没有安全问题、性能问题？

为什么不合成一轮？因为关注点不同。功能审查关心”对不对”，质量审查关心”好不好”。分开审查，每轮更专注。

为什么强制 TDD？

TDD（测试驱动开发）的核心是：先写测试，再写代码。

很多人觉得这很麻烦，但对 AI 来说特别重要。因为 AI 写完代码后说”应该没问题”，你没法验证。但如果它先写了测试，你能看到测试从”失败”变成”通过”，这就是实打实的证据。

为什么修 Bug 不许直接改？

人类程序员修 Bug 时经常靠直觉猜，猜对了就很快。但 AI 的”直觉”不太靠谱，经常猜错，然后越改越乱。

Superpowers 强制 AI 走系统化的调试流程：先收集证据、分析原因、形成假设、验证假设。如果猜了 3 次还没修好，就停下来 —— 问题可能不在代码细节，而在架构设计。

九、谁适合用？

十、版本历史

v5.0.5（当前版本，2026-03-17）

• 修复了 Node.js 22+ 环境下服务器启动失败的问题
• 修复了 Windows 环境下进程监控不工作的问题
• 改进了服务器停止的可靠性

v5.0.4

• 优化了审查流程，减少了不必要的来回（从最多 5 轮降到 3 轮）
• 新增 OpenCode 和 Cursor 平台支持

v5.0.0 ~ v5.0.3

• 可视化伴侣服务器上线
• 跨平台支持（Windows + macOS + Linux）
• 子 Agent 双轮审查机制引入

十一、相关链接

本文档基于 Superpowers v5.0.5 源码编写