Superpowers: AI 编程代理的专业开发工作流实战

中等难度 | 约 15 分钟阅读 | 掌握 AI 编程代理的专业开发流程

如果你正在用 Claude Code、Cursor、Codex 这类 AI 编程代理，你可能遇到过这样的场景：让 AI 写代码，它二话不说就开始堆代码；写到一半发现方向错了，又要重来；代码倒是写得挺快，但测试没有、注释没有、代码 review 更没有。

这就是 Superpowers 要解决的问题。这是一个开源的 AI 编程代理工作流框架，它不是另一个 AI 工具，而是让你现有的 AI 编程代理变得更专业。通过一系列可组合的"技能"（Skills），Superpowers 让 AI 在写代码之前先思考、写代码时先写测试、写完代码还有审查。

本文首发于 OpenClaw 社区（openclaw.ai），为你详细讲解 Superpowers 的安装和实战用法。

目标读者

1-5 年经验的开发者
正在使用或计划使用 Claude Code、Cursor、Codex 等 AI 编程代理
希望让 AI 写出更专业、可维护代码的团队

核心依赖与环境

AI 编程平台（任选其一）：
- Claude Code（推荐）
- Cursor
- Codex
- OpenCode
- Gemini CLI
Node.js 18+
Git

项目结构

superpowers/
├── skills/
│   ├── brainstorming/                     # 设计阶段：Socratic 方法论
│   ├── writing-plans/                     # 计划阶段：任务拆分
│   ├── subagent-driven-development/        # 执行阶段：子代理开发
│   ├── test-driven-development/            # TDD 循环
│   ├── requesting-code-review/            # 代码审查
│   ├── systematic-debugging/               # 调试方法论
│   ├── using-git-worktrees/                # Git worktree 并行开发
│   ├── finishing-a-development-branch/     # 分支完成工作流
│   ├── dispatching-parallel-agents/        # 并行子代理
│   ├── receiving-code-review/              # 响应代码审查
│   └── executing-plans/                    # 批量执行计划
├── hooks/                                 # 自动触发钩子
├── .claude-plugin/                        # Claude Code 插件配置
└── .codex/                                # Codex 配置

手把手步骤

1. 安装 Superpowers

不同平台的安装方式略有差异，我们以最常用的 Claude Code 为例。

首先，添加官方插件市场：

/plugin marketplace add obra/superpowers-marketplace

然后安装 Superpowers 插件：

/plugin install superpowers@superpowers-marketplace

TIP

如果你使用的是 Claude Code 官方市场，也可以直接运行：

/plugin install superpowers@claude-plugins-official

对于其他平台：

Cursor：

/add-plugin 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 CLI：

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

安装完成后，启动一个新的对话窗口，说一句触发技能的话，比如"帮我计划做一个用户登录功能"，Superpowers 就会自动激活 brainstorming 技能。

2. 触发 brainstorming：让 AI 先问清楚你要做什么

这是 Superpowers 最核心的设计理念：AI 不应该一上来就写代码，而是先理解你要做什么。

当你表达一个想法时，Superpowers 会自动触发 brainstorming 技能。它不会直接开始写代码，而是用 Socratic 方法——通过一系列问题来澄清你的需求。

比如你说"帮我做个用户管理系统"，Superpowers 可能会这样回复：

我需要先理解你的具体需求：

用户管理系统需要支持哪些功能？（注册、登录、权限管理、第三方登录...）

目标用户是谁？内部系统还是面向公众？

有没有现有的技术栈需要集成？

性能要求如何？预计多少用户？

请告诉我更多细节，我们先把这个"什么"定义清楚。

这个阶段会持续到你和 AI 就需求达成共识。Superpowers 会把讨论结果整理成设计文档，并分块展示给你确认。

3. 设计文档确认：AI 分块展示设计

当你回答完问题后，Superpowers 会生成一份结构化的设计文档。但它不是一次性全部展示给你，而是分块展示，让你逐段确认。

文档通常包含：

概述：系统要解决什么问题
功能列表：具体要实现哪些功能
技术方案：用什么技术、架构怎么设计
数据模型：数据库/数据结构设计
API 设计：接口定义
非功能需求：性能、安全、可扩展性

每展示一块，它会问你"这个你看可以吗？"或者"这里有没有需要调整的？"你确认后才会进入下一块。

WARNING

一定要仔细审核设计文档！在这个阶段修改设计成本最低。一旦进入开发阶段再改需求，代价会成倍增加。

4. 自动生成计划：创建可执行的任务清单

设计文档确认后，Superpowers 会触发 writing-plans 技能，生成一份详细的实施计划。

这份计划的特点是极度细粒度：

每个任务 2-5 分钟能完成
每个任务都有精确的文件路径
每个任务都有完整的代码示例
每个任务都有验证步骤

计划大概长这样：

## 任务 1: 创建用户表
- 文件: src/db/schema.ts
- 验证: 运行 `pnpm db:generate` 无报错
- 耗时: ~3 分钟

## 任务 2: 实现用户注册 API
- 文件: src/app/api/users/register.ts
- 验证: curl 测试返回 201
- 耗时: ~5 分钟

## 任务 3: 实现用户登录 API
- 文件: src/app/api/users/login.ts
- 验证: curl 测试返回 token
- 耗时: ~5 分钟

...

5. 子代理执行开发：AI 自主工作

你说"开始吧"，Superpowers 就会启动 subagent-driven-development 技能。

这个技能会为每个任务创建一个独立的子代理（subagent）来执行。子代理的工作流程是：

读取任务：明确知道自己要做什么
先写测试：遵循 TDD 原则，先写一个失败的测试
实现代码：写最少的代码让测试通过
代码审查：检查代码是否符合规范
提交结果：任务完成

TIP

你可以让 Superpowers 每完成几个任务就暂停一下，让你确认方向是否正确。这样既保持了开发的连贯性，又不会失控。

Superpowers 的一个强大之处在于两阶段审查：

第一阶段：检查是否符合计划规范
第二阶段：检查代码质量（可读性、性能、安全等）

只有通过审查，子代理才会继续下一个任务。

6. TDD 强制执行：红/绿/重构循环

Superpowers 的 test-driven-development 技能会强制执行 TDD 流程：

RED：先写一个失败的测试
GREEN：写最少的代码让测试通过
REFACTOR：重构代码，同时保证测试仍然通过

如果 AI 试图先写实现代码再补测试，Superpowers 会阻止它，并要求重新按 TDD 流程来。

// 假设我们要实现一个加法函数
// 第一步：先写测试（RED）
describe('add', () => {
  it('should add two numbers', () => {
    expect(add(1, 2)).toBe(3);  // 此时 add 函数还不存在，测试失败
  });
});

// 第二步：写最少的代码让测试通过（GREEN）
function add(a: number, b: number): number {
  return a + b;
}

// 第三步：如果需要，重构代码
// 同时保证测试仍然通过

7. 代码审查：完成后自动检查

当一个任务完成后，Superpowers 会触发 requesting-code-review 技能进行代码审查。

审查清单包括：

功能完整性：是否实现了计划中的所有功能？
代码正确性：逻辑是否正确？边界情况处理了吗？
代码质量：命名清晰吗？函数太长了吗？重复代码多吗？
安全性：有 SQL 注入、XSS 等安全漏洞吗？
性能：有明显的性能问题吗？

审查结果会按严重程度分类：

Critical：必须修复，否则无法合并
Major：强烈建议修复
Minor：建议改进

8. 分支收尾：合并/PR/清理选项

所有任务完成后，Superpowers 会触发 finishing-a-development-branch 技能，展示几个选项：

合并到主分支：如果测试都通过，可以直接合并
创建 PR：如果需要团队审核，创建 Pull Request
保留分支：如果还想继续开发，可以保留分支
清理：删除开发分支和工作区

同时它会展示最终的测试结果、代码覆盖率等指标，让你做出明智的决定。

常见问题排查

1. 技能没有自动触发怎么办

首先确认 Superpowers 已经正确安装：

/plugin list

确认列表中有 superpowers。

如果仍然没有触发，尝试明确告诉 AI："请使用 superpowers 的 brainstorming 技能来帮我设计这个功能。"

2. 子代理开发卡住了如何干预

在子代理执行过程中，你可以说"暂停"或"stop"，Superpowers 会停止执行并等待你的指令。

然后你可以：

检查当前进度
修改后续任务
调整方向
继续执行

3. TDD 流程被跳过如何强制

如果发现 AI 没有先写测试就写了实现代码，直接说：

"请回到 TDD 流程，先删除刚才写的实现代码，然后按 RED-GREEN-REFACTOR 的顺序来。"

Superpowers 会强制 AI 遵守流程。

4. 设计文档太大怎么办

如果设计文档很长，Superpowers 会自动分块展示。你也可以要求：

"请把这个设计文档分成更小的部分，每次展示一部分让我确认。"

5. 如何自定义技能行为

每个技能的详细说明都在对应的 SKILL.md 文件中。你可以修改这些文件来调整技能行为。

WARNING

修改技能后，你的更改可能会在插件更新时被覆盖。建议在修改前先备份。

6. 多分支并行开发冲突处理

Superpowers 的 using-git-worktrees 技能支持并行开发多个功能分支。每个功能都在独立的 worktree 中开发，互不干扰。

如果遇到冲突：

让 AI 解释冲突原因
决定保留哪个版本
让 AI 手动解决冲突
验证解决后的代码能正常工作

扩展阅读 / 进阶方向

深入学习各技能

每个技能都有独立的 SKILL.md 文档，详细描述了技能的工作原理和使用方法。建议按顺序学习：

brainstorming（ brainstorming/SKILL.md ）：Socratic 设计方法论
test-driven-development（ test-driven-development/SKILL.md ）：TDD 最佳实践
systematic-debugging（ systematic-debugging/SKILL.md ）：系统性调试方法
writing-plans（ writing-plans/SKILL.md ）：任务拆分技巧
writing-skills（ writing-skills/SKILL.md ）：如何创建新技能

创建自定义技能

如果你有特定的开发流程需要自动化，可以创建自定义技能。Superpowers 的技能系统是高度可扩展的。

参考 writing-skills 技能，按照以下步骤创建：

定义技能的触发条件
编写技能的 prompt
添加验证逻辑
测试技能效果

与 OpenClaw 集成

Superpowers 可以与 OpenClaw 集成，实现更强的自动化能力。通过 OpenClaw 的消息桥接，你可以通过 Telegram、Discord 等平台触发 Superpowers 工作流。

更多信息请访问：https://openclaw.ai

项目地址：https://github.com/obra/superpowers