Superpowers 新手入门教程

Jesse Vincent (GitHub 前 CTO) 的完整开发工作流 - 让 AI 自动化的完整开发过程

什么是 Superpowers？

Superpowers 是 Jesse Vincent（GitHub 前 CTO）开发的完整软件开发工作流。它的核心理念是：技能自动触发，不需要每次手动指导 Agent。

核心理念

构思 → 计划 → 实现 → 审查 → 测试 → 发布

每个技能在上一个完成后自动触发，就像有一个经验丰富的工程师在指导整个流程。

特点

自动触发：技能在需要时自动激活
TDD 强制：必须先写测试，再写代码
子 Agent 驱动：可以自动执行多个任务
工作树隔离：每个功能在独立分支开发

安装 Superpowers

方式一：Claude Code 官方市场（推荐）

/plugin install superpowers@claude-plugins-official

方式二：添加市场后安装

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

方式三：Cursor

在 Cursor Agent chat 中输入：

/add-plugin superpowers

验证安装

启动新的 Claude Code 会话，输入：

brainstorm

如果看到提示让你描述想做的事情，说明安装成功！

核心工作流

Superpowers 的 7 步开发循环

1. brainstorming ──▶ 构思阶段，需求细化
       │
       ▼
2. using-git-worktrees ──▶ 创建隔离的工作环境
       │
       ▼
3. writing-plans ──▶ 详细实现计划
       │
       ▼
4. subagent-driven-development ──▶ 子 Agent 执行
       │
       ▼
5. test-driven-development ──▶ TDD 开发
       │
       ▼
6. requesting-code-review ──▶ 代码审查
       │
       ▼
7. finishing-a-development-branch ──▶ 完成并发布

自动触发机制

Superpowers 的技能是自动触发的。当你：

开始描述一个问题 → 触发 brainstorming
批准设计后 → 触发 using-git-worktrees
有计划后 → 触发 writing-plans
执行计划时 → 触发 subagent-driven-development

你不需要记住这些命令。它会自动检测你处于哪个阶段，然后触发相应的技能。

技能详解

1. brainstorming — 构思阶段

什么时候触发：当你描述想要构建的东西时

做什么：

问问题细化你的想法
探索替代方案
分段展示设计让你确认
保存设计文档

案例对话：

你: 我想给博客添加评论功能
Superpowers: 好的，让我细化一下。
- 评论系统需要支持哪些用户？（匿名/登录/社交登录）
- 需要审核吗？（需要/不需要/AI 辅助）
- 评论如何显示？（时间序/树状/ threaded）
- ...

2. using-git-worktrees — 创建隔离环境

什么时候触发：设计批准后

做什么：

在新分支创建隔离的工作目录
运行项目初始化
验证测试基线干净

案例：

设计批准后，Superpowers 自动执行：

✓ Created worktree: /workspace/blog-feature
✓ Branch: feature/comments
✓ Installed dependencies
✓ Tests baseline: 42 passing

3. writing-plans — 详细计划

什么时候触发：有设计文档后

做什么：

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

案例计划：

## 任务 1: 创建评论数据库模型
- 文件: src/models/comment.ts
- 验证: `bun test models/comment.test.ts`

## 任务 2: 实现评论 API 端点
- 文件: src/routes/comments.ts
- 验证: `curl localhost:3000/api/comments`

## 任务 3: 添加评论前端组件
- 文件: src/components/Comment.tsx
- 验证: `bun test components/Comment.test.tsx`

4. subagent-driven-development — 子 Agent 执行

什么时候触发：有计划后

做什么：

派遣子 Agent 执行每个任务
两阶段审查：规格合规 → 代码质量
可以批量执行，也可以人工检查点

案例：

启动子 Agent 执行任务 1-5...
[Agent 1] 创建评论数据库模型... ✓
[Agent 1] 实现评论 API... ✓
[Agent 2] 审查任务 1... ✓
[Agent 2] 审查任务 2... ✓
[Agent 1] 实现评论前端... 进行中...

5. test-driven-development — TDD 开发

什么时候触发：实现过程中

做什么：

强制 RED-GREEN-REFACTOR 循环
先写失败的测试
看测试失败
写最少的代码让测试通过
重构
删除写在使用测试之前的代码

TDD 流程：

1. 写一个失败的测试 (RED)
   └── expect(add(1,2)).toBe(3) // FAIL

2. 写最少的代码让测试通过 (GREEN)
   └── function add(a,b) { return a + b }

3. 重构 (REFACTOR)
   └── 优化代码结构

4. 提交

6. requesting-code-review — 代码审查

什么时候触发：任务之间

做什么：

审查代码是否符合计划
按严重程度报告问题
关键问题阻止继续

案例：

## 代码审查报告

### Critical (阻塞)
- ❌ 评论内容未做 XSS 过滤

### High
- ⚠️ 缺少速率限制
- ⚠️ 错误处理不完整

### Medium
- 💡 日志级别可优化

### 状态
[阻塞] 需要修复 Critical 问题

7. finishing-a-development-branch — 完成开发

什么时候触发：所有任务完成

做什么：

验证所有测试通过
提供选项：合并/PR/保留/丢弃
清理工作树

案例：

## 开发完成

✓ 所有测试通过: 51/51
✓ 代码覆盖率: 82%

选项：
1. [PR] 创建 PR 到 main
2. [MERGE] 直接合并
3. [KEEP] 保留分支继续工作
4. [DISCARD] 丢弃分支

请选择:

用户案例

案例：给博客添加评论系统

让我们看 Superpowers 如何帮助你完成这个任务。

第一步：告诉它你想要什么

你输入：

我想给博客添加评论功能

第二步：自动触发 brainstorming

Superpowers：

好的，让我帮你细化需求。

我需要问几个问题：

1. 评论系统需要支持哪些用户？
   - 匿名用户
   - 已登录用户
   - 社交登录（GitHub/Google）

2. 需要评论审核吗？
   - 不需要，直接显示
   - 需要人工审核
   - AI 辅助审核（过滤垃圾）

3. 评论如何显示？
   - 按时间顺序
   - 树状回复
   - 点赞排序

你回答：已登录用户 + AI 辅助审核 + 树状回复

Superpowers：

收到。让我为你生成设计文档...

## 评论系统设计

### 核心功能
- 用户登录后评论
- AI 垃圾评论过滤
- 树状回复结构

### 技术方案
- 数据库: comments 表（支持嵌套）
- API: RESTful
- 前端: React 组件

### 待确认
- [ ] 确认设计文档

第三步：你确认设计文档

你输入：确认设计

第四步：自动触发 using-git-worktrees

Superpowers：

✓ Created worktree: /workspace/blog-comments
✓ Branch: feature/comments
✓ 依赖已安装
✓ 测试基线: 42 passing

第五步：自动触发 writing-plans

Superpowers：

生成任务计划...

## 任务列表

### Phase 1: 数据库 (10 分钟)
1. 创建 comment 模型
2. 添加嵌套支持
3. 创建数据库迁移

### Phase 2: 后端 API (20 分钟)
4. GET /api/comments/:postId
5. POST /api/comments
6. DELETE /api/comments/:id

### Phase 3: 前端 (20 分钟)
7. CommentList 组件
8. CommentForm 组件
9. ReplyButton 组件

### Phase 4: AI 审核 (15 分钟)
10. 集成 AI 审核服务
11. 审核状态显示

### Phase 5: 测试 (15 分钟)
12. 单元测试
13. 集成测试

第六步：你批准计划，开始执行

你输入：开始执行

第七步：自动触发 subagent-driven-development

Superpowers：

开始执行任务...

[Agent 1] Phase 1: 数据库
  ✓ 任务 1: 创建 comment 模型
  ✓ 任务 2: 添加嵌套支持
  ✓ 任务 3: 创建数据库迁移

[Agent 2] Phase 2: 后端 API
  ✓ 任务 4: GET /api/comments/:postId
  ✓ 任务 5: POST /api/comments
  ⚠ 任务 6: DELETE /api/comments/:id
    - 发现需要权限验证
    - 暂停等待确认

[Agent 1] Phase 3: 前端
  ✓ 任务 7: CommentList 组件
  ✓ 任务 8: CommentForm 组件
  ...

第八步：强制 TDD

在每个任务执行中，Superpowers 会：

1. 写测试 (RED)
   test('should create comment', () => {
     const comment = createComment({...})
     expect(comment.content).toBe('Hello')
   })
   → FAIL ❌

2. 写最少的代码 (GREEN)
   function createComment({content}) {
     return { content }
   }
   → PASS ✅

3. 重构
   → 优化结构

第九步：触发代码审查

Superpowers：

## 代码审查

### Critical
- ❌ XSS: 评论内容未过滤
- ❌ SQL 注入: 原始查询

### High
- ⚠️ 缺少速率限制

修复 Critical 问题后继续...

第十步：完成并发布

你输入：完成

Superpowers：

## 开发完成

✓ 所有测试通过: 51/51
✓ 覆盖率: 82%
✓ 合并到 main

🚀 评论系统已完成！
从想法到发布只用了 2 小时。

常见问题

Q: Superpowers 要钱吗？

A: 免费！MIT 许可证。

Q: 技能不会自动触发？

A: 确保从 Claude Code 官方市场安装：

/plugin install superpowers@claude-plackages-official

Q: 可以跳过某些步骤？

A: 可以。告诉 Superpowers "跳过 brainstorming" 即可。

Q: 子 Agent 是什么？

A: Superpowers 会派一个独立的 Agent 去执行任务，然后另一个 Agent 审查。两阶段确保质量。

Q: TDD 强制吗？

A: 是的。Superpowers 强制 RED-GREEN-REFACTOR。如果你先写代码再写测试，它会删除代码并让你重写。

下一步

阅读 Superpowers 完整文档
尝试其他技能：systematic-debugging、finishing-a-development-branch
了解更多：官方博客

FilesExpand file tree

superpowers-tutorial.md

Latest commit

History

superpowers-tutorial.md

File metadata and controls

Superpowers 新手入门教程

目录

什么是 Superpowers？

核心理念

特点

安装 Superpowers

方式一：Claude Code 官方市场（推荐）

方式二：添加市场后安装

方式三：Cursor

验证安装

核心工作流

Superpowers 的 7 步开发循环

自动触发机制

技能详解

1. brainstorming — 构思阶段

2. using-git-worktrees — 创建隔离环境

3. writing-plans — 详细计划

4. subagent-driven-development — 子 Agent 执行

5. test-driven-development — TDD 开发

6. requesting-code-review — 代码审查

7. finishing-a-development-branch — 完成开发

用户案例

案例：给博客添加评论系统

第一步：告诉它你想要什么

第二步：自动触发 brainstorming

第三步：你确认设计文档

第四步：自动触发 using-git-worktrees

第五步：自动触发 writing-plans

第六步：你批准计划，开始执行

第七步：自动触发 subagent-driven-development

第八步：强制 TDD

第九步：触发代码审查

第十步：完成并发布

常见问题

Q: Superpowers 要钱吗？

Q: 技能不会自动触发？

Q: 可以跳过某些步骤？

Q: 子 Agent 是什么？

Q: TDD 强制吗？

下一步