Claude Code教程

Claude Code终极组合拳：Agent Teams + BMAD-SKILLS + SuperPowers实战指南

前言

Claude Code 不仅仅是AI编程助手，更是一个完整的开发环境。当我们将 Agent Teams（代理团队）、BMAD-SKILLS（敏捷开发方法论）和 SuperPowers（超级能力框架）三者结合使用时，能够释放出前所未有的生产力。

本文将从零开始，带你掌握这套终极组合拳，从入门到精通。

一、三大核心组件介绍

1.1 Agent Teams：多代理协作

什么是 Agent Teams？

Agent Teams 是 Claude Code 的多代理并行工作能力，允许你同时运行多个独立的子代理，每个代理负责不同的任务。

核心优势：

  • 🚀 并行处理：多个任务同时进行，大幅提升效率
  • 🎯 角色分工：每个代理专注于特定领域
  • 🔄 两阶段审查：规范合规性审查 + 代码质量审查
  • ⚡ 长时间自主运行：可以自主工作数小时而不偏离计划

使用场景：

  • 复杂项目的并行开发
  • 测试用例生成与核心逻辑实现同时进行
  • 文档编写与代码审查并行执行

1.2 BMAD-SKILLS：敏捷开发方法论

什么是 BMAD？

BMAD (Breakthrough Method for Agile AI-Driven Development) 是由 BMAD Code Organization 创建的敏捷开发方法论，专为 AI 驱动开发设计。

9 个核心技能角色：

角色 职责
BMad Master 总协调者，管理整体流程
Business Analyst 产品发现，市场分析
Product Manager 需求管理，PRD 编写
System Architect 系统设计，架构规划
Scrum Master Sprint 规划，任务分解
Developer 代码实现
UX Designer 用户体验设计
Builder 自定义代理和工作流创建
Creative Intelligence 头脑风暴，市场研究

15 个工作流命令：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
/workflow-init          - 初始化 BMAD 项目
/workflow-status         - 查看项目状态
/product-brief           - 阶段1：产品发现
/prd                     - 阶段2：详细需求文档
/tech-spec               - 阶段2：轻量技术规范
/architecture            - 阶段3：系统架构设计
/solutioning-gate-check  - 阶段3：架构质量检查
/sprint-planning         - 阶段4：Sprint 规划
/create-story            - 阶段4：创建用户故事
/dev-story               - 阶段4：实现用户故事
/create-agent            - 创建自定义代理
/create-workflow         - 创建自定义工作流
/brainstorm              - 结构化头脑风暴
/research                - 市场/技术研究
/create-ux-design        - UX 设计

Token 优化：

  • 使用 Helper Pattern 减少 70-85% 的 token 使用
  • 无角色设定开销，专注于”做什么”而非”谁来做”
  • 每次对话可节省 750-1000 tokens

1.3 SuperPowers：超级能力框架

什么是 SuperPowers？

SuperPowers 是一个完整的软件开发工作流框架，基于可组合的”技能”系统，强调 TDD、系统化开发和证据驱动的实践。

核心技能库：

测试（Testing）：

  • test-driven-development - RED-GREEN-REFACTOR 循环

调试（Debugging）：

  • systematic-debugging - 4 阶段根本原因分析
  • verification-before-completion - 确保真正修复

协作（Collaboration）：

  • 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 - 快速迭代 + 两阶段审查

核心理念：

  • ✅ 测试驱动开发（TDD）- 永远先写测试
  • ✅ 系统化而非临时 - 流程胜过猜测
  • ✅ 简化复杂性 - 简单作为主要目标
  • ✅ 证据胜过声明 - 验证后才能宣布成功

二、安装与配置

2.1 安装 BMAD-SKILLS

推荐方式（自动安装）：

在 Claude Code 中输入：

1
2
请从以下仓库安装 BMAD Method v6：
https://github.com/aj-geddes/claude-code-bmad-skills

Claude Code 会自动检测你的平台并完成安装。

手动安装：

1
2
3
4
5
6
7
8
9
10
11
12
# Linux/macOS/WSL
cd /tmp
git clone https://github.com/aj-geddes/claude-code-bmad-skills.git
cd claude-code-bmad-skills
chmod +x install-v6.sh
./install-v6.sh

# Windows PowerShell
cd $env:TEMP
git clone https://github.com/aj-geddes/claude-code-bmad-skills.git
cd claude-code-bmad-skills
.\install-v6.ps1

验证安装：

1
2
3
4
5
# Linux/macOS/WSL
ls -la ~/.claude/skills/bmad/core/bmad-master/SKILL.md

# Windows PowerShell
dir $env:USERPROFILE\.claude\skills\bmad\core\bmad-master\SKILL.md

重要： 安装完成后必须重启 Claude Code，技能才会加载。

2.2 安装 SuperPowers

Claude Code 用户（通过插件市场）：

1
2
3
4
5
1. 注册市场：
/plugin marketplace add obra/superpowers-marketplace

2. 安装插件：
/plugin install superpowers@superpowers-marketplace

Cursor 用户：

在 Cursor Agent 聊天中：

1
/plugin-add superpowers

验证安装：

开启新会话，输入：

1
帮我规划这个功能

代理应该自动触发相关的 SuperPowers 技能。

2.3 启用 Agent Teams

Agent Teams 是 Claude Code 的原生功能，无需额外安装。关键在于正确使用：

  1. 使用 /brainstorming - SuperPowers 自动在代码编写前激活
  2. 创建详细计划 - 使用 /writing-plans 或 BMAD 的 /architecture
  3. 执行计划 - 使用 /execute-plan 或 /dev-story + 并行代理

三、小白入门：第一个实战案例

让我们通过一个简单的实战案例，学习如何组合使用这三个工具。

3.1 项目目标

开发一个 任务管理 API，包含：

  • 创建/读取/更新/删除任务
  • 任务状态管理（待办/进行中/已完成）
  • 任务标签分类

3.2 步骤一：产品发现（BMAD）

1
/workflow-init

BMAD 会创建项目结构并初始化配置。

1
/product-brief

Business Analyst 角色会引导你：

  • 分析目标用户
  • 定义核心功能
  • 市场分析
  • 推荐项目级别

交互示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
Claude Code: 让我们创建产品简报。

问题 1/5：这个任务管理 API 的目标用户是谁？
你的回答：小团队和个人开发者，5-20人团队规模

问题 2/5：核心功能是什么？
你的回答：CRUD 操作、状态管理、标签系统

问题 3/5：主要竞品有哪些？
你的回答：Trello API、Asana API

[... 更多问题 ...]

✓ 产品简报已创建！
项目级别：Level 1（轻量级，1-10个故事）
下一步：创建技术规范 (/tech-spec)

3.3 步骤二：需求与技术规范

对于这个小型项目，使用轻量级规范：

1
/tech-spec

Product Manager 会创建技术规范文档，包含：

  • 功能需求（FR）
  • 非功能需求（NFR）
  • API 端点设计

输出示例（bmad-outputs/tech-spec.md）：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
# Task Management API - Technical Specification

## Functional Requirements

FR-001: 用户可以创建新任务
FR-002: 用户可以读取任务列表
FR-003: 用户可以更新任务详情
FR-004: 用户可以删除任务
FR-005: 任务支持状态管理（todo/in_progress/done）
FR-006: 任务支持标签分类

## API Endpoints

POST   /api/tasks          - 创建任务
GET    /api/tasks          - 获取任务列表
GET    /api/tasks/:id      - 获取单个任务
PUT    /api/tasks/:id      - 更新任务
DELETE /api/tasks/:id      - 删除任务
PATCH  /api/tasks/:id/status - 更新任务状态

## Tech Stack

- Backend: Python + FastAPI
- Database: SQLite (可扩展为 PostgreSQL)
- Testing: pytest

3.4 步骤四：并行开发（Agent Teams + SuperPowers）

现在进入实现阶段，使用 Agent Teams 并行工作。

启动并行代理：

在 Claude Code 中输入：

1
2
3
4
5
使用 SuperPowers 的 subagent-driven-development 流程实现这些任务：
1. 创建 FastAPI 项目基础结构
2. 实现数据模型（Task 模型）
3. 实现所有 API 端点
4. 编写完整的测试用例

SuperPowers 会自动：

  1. 创建实现计划 (/writing-plans)

  2. 启动 4 个子代理（并行工作）：

    • Agent 1：项目基础结构 + 配置
    • Agent 2：数据模型实现
    • Agent 3：API 端点实现
    • Agent 4：测试用例生成

  3. 执行两阶段审查：

    • 第一阶段：规范合规性审查
    • 第二阶段：代码质量审查

执行过程示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
📋 实现计划已创建：
- Task 1: 初始化 FastAPI 项目 (2-3分钟)
- Task 2: 实现 Task 数据模型 (3-4分钟)
- Task 3: 实现 6 个 API 端点 (8-10分钟)
- Task 4: 编写 pytest 测试套件 (6-8分钟)

🚀 启动 4 个并行子代理...

[Subagent 1] ✓ 项目结构创建完成
[Subagent 2] ✓ Task 模型实现完成
[Subagent 3] ✓ API 端点实现完成
[Subagent 4] ✓ 测试用例编写完成

🔍 第一阶段审查（规范合规性）：
- Task 1: ✅ 通过
- Task 2: ✅ 通过
- Task 3: ✅ 通过
- Task 4: ✅ 通过

🔍 第二阶段审查（代码质量）：
- Task 1: ✅ 通过（代码结构清晰）
- Task 2: ✅ 通过（模型设计合理）
- Task 3: ⚠️ 小问题：缺少输入验证
- Task 4: ✅ 通过（测试覆盖率 95%）

🔧 修复问题...
✓ 已添加输入验证

✓ 所有任务完成！
文件创建：
- main.py (FastAPI 应用)
- models/task.py (数据模型)
- api/routes.py (路由)
- tests/test_api.py (测试套件)

运行测试...
15/15 tests passing ✓
Coverage: 95%

3.5 步骤五：代码审查与合并

1
/requesting-code-review

SuperPowers 会进行预审查：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
🔍 代码审查报告

严重问题（阻塞）：
- 无

高优先级问题：
- 无

中优先级问题：
- 建议添加 API 文档（Swagger）

低优先级问题：
- 建议添加日志记录

✅ 代码质量良好，可以继续

四、进阶：大型项目实战

让我们通过一个更复杂的案例，展示这三个工具的完整威力。

4.1 项目：实时协作白板应用

功能需求：

  • 实时多人协作（WebSocket）
  • 绘图工具（画笔、形状、文字）
  • 导入/导出功能
  • 用户权限管理
  • 历史记录与撤销/重做
  • 实时语音聊天

4.2 完整工作流

阶段 1：产品发现（BMAD）

1
2
/workflow-init
/product-brief

Business Analyst 会：

  • 分析市场（Miro、Figma、Excalidraw）
  • 定义用户画像（设计师、产品经理、开发团队）
  • 识别核心差异点（隐私优先、离线支持）

输出： bmad-outputs/product-brief.md

阶段 2：详细需求（BMAD）

对于这种 Level 3 项目，使用完整 PRD：

1
/prd

Product Manager 会创建：

  • 功能需求（30+ FR）
  • 非功能需求（NFR）
  • 用户故事分组为 Epics
  • 验收标准
  • MoSCoW 优先级排序

输出： bmad-outputs/prd.md

示例片段：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
# 功能需求

## Epic 1: 实时协作

FR-001: 用户可以加入协作会话
FR-002: 多用户可以同时编辑同一白板
FR-003: 用户可以看到其他用户的鼠标位置
FR-004: 实时同步绘制内容（<100ms 延迟）

## Epic 2: 绘图工具

FR-010: 自由绘制（画笔工具）
FR-011: 绘制形状（矩形、圆形、箭头）
FR-012: 添加文本标注
FR-013: 调整线条粗细和颜色

# 非功能需求

NFR-001: 性能 - 支持 50+ 用户同时在线
NFR-002: 延迟 - 实时同步 <100ms
NFR-003: 可扩展性 - 支持水平扩展
NFR-004: 安全性 - WebSocket 认证与授权
NFR-005: 可靠性 - 数据持久化，故障恢复

阶段 3：架构设计（BMAD + SuperPowers）

1
/architecture

System Architect 会设计：

  • 系统组件架构
  • 数据模型与 Schema
  • API 规范
  • 技术栈选择（对照 NFR 论证）
  • WebSocket 实时通信方案
  • 数据库设计

输出： bmad-outputs/architecture.md

关键技术栈：

1
2
3
4
5
6
Frontend: React + TypeScript + Canvas API
Backend: Node.js + Express + Socket.io
Database: PostgreSQL (主数据) + Redis (缓存)
Real-time: Socket.io (WebSocket)
Storage: AWS S3 (图片/白板快照)
Auth: JWT + OAuth2

阶段 4：架构质量检查

1
/solutioning-gate-check

System Architect 自动验证：

1
2
3
4
5
6
7
8
9
10
11
12
✓ Gate Check 通过！分数：94/100

✓ FR 覆盖率：100% (32/32 需求已处理)
✓ NFR 覆盖率：100% (8/8 需求已满足)
✓ 质量检查：24/25 通过

⚠️ 改进建议：
- 添加 CDN 加速静态资源
- 考虑使用 WebRTC 替代部分 WebSocket

准备进入实施阶段！
下一步：Sprint 规划 (/sprint-planning)

阶段 5：Sprint 规划与任务分解

1
/sprint-planning

Scrum Master 会：

  • 将 32 个需求分解为多个 Sprint
  • 创建用户故事
  • 估算故事点数
  • 识别依赖关系

输出： bmad-outputs/sprints/sprint-1.md

Sprint 1 示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# Sprint 1: MVP 基础

Sprint 目标：可用的单用户白板
故事点数：28 点
持续时间：2 周

Stories:
1. 用户认证与注册 (5 点)
2. 创建/删除白板 (3 点)
3. 基础画笔工具 (5 点)
4. 绘制形状 (4 点)
5. 保存/加载白板 (4 点)
6. 基础测试套件 (3 点)
7. CI/CD 管道 (4 点)

阶段 6：并行实现（Agent Teams + SuperPowers）

现在使用 SuperPowers 的并行代理实现 Sprint 1：

1
/run subagent-driven-development @sprint-1-plan

SuperPowers 会启动 6 个并行子代理：

代理 任务 预计时间
Agent 1 用户认证（JWT + OAuth2） 8-10 分钟
Agent 2 白板 CRUD API + 数据模型 10-12 分钟
Agent 3 画笔工具实现（Canvas API） 12-15 分钟
Agent 4 形状绘制实现 8-10 分钟
Agent 5 保存/加载功能（S3 集成） 6-8 分钟
Agent 6 测试套件（pytest） 8-10 分钟

TDD 模式激活：

SuperPowers 的 test-driven-development 技能会强制执行 RED-GREEN-REFACTOR 循环：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
[Agent 1] 📝 RED - 编写失败的认证测试
  ✓ tests/test_auth.py created
  ✓ pytest tests/test_auth.py: 12 tests failed

[Agent 1] 🟢 GREEN - 编写最小代码使测试通过
  ✓ auth/middleware.py implemented
  ✓ auth/jwt.py implemented
  ✓ pytest tests/test_auth.py: 12 tests passing

[Agent 1] ♻️ REFACTOR - 重构代码
  ✓ 优化 token 验证逻辑
  ✓ 添加代码注释
  ✓ 测试仍然通过

[Agent 2] 📝 RED - 编写白板 API 测试
[... 重复 RED-GREEN-REFACTOR 循环 ...]

两阶段审查：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
🔍 第一阶段审查（规范合规性）：
- Agent 1: ✅ 所有需求满足
- Agent 2: ✅ API 端点完整
- Agent 3: ✅ 画笔功能符合规范
- Agent 4: ✅ 形状绘制正确
- Agent 5: ✅ S3 集成完成
- Agent 6: ✅ 测试覆盖率 92%

🔍 第二阶段审查（代码质量）：
- Agent 1: ✅ 代码质量良好
- Agent 2: ⚠️ 建议：添加输入验证
- Agent 3: ✅ Canvas 性能优化
- Agent 4: ✅ 形状算法清晰
- Agent 5: ✅ 错误处理完善
- Agent 6: ✅ 测试用例全面

🔧 修复 Agent 2 的输入验证问题...
✓ 已添加 Pydantic 模型验证

✓ Sprint 1 所有故事完成！

阶段 7：UX 设计（BMAD）

1
/create-ux-design

UX Designer 会创建：

  • 用户流程图（快乐路径、错误处理）
  • 线框图（ASCII 描述或结构化说明）
  • WCAG 2.1 无障碍合规
  • 组件库规范
  • 设计 Token（颜色、字体、间距）

输出： bmad-outputs/ux-design.md

阶段 8：创意与优化（BMAD）

1
/brainstorm

Creative Intelligence 会使用 8 种头脑风暴技术：

  • 5 Whys（5个为什么）
  • SCAMPER（替代、组合、调整、修改、用其他用途、消除、重排）
  • 思维导图
  • 逆向头脑风暴
  • 六顶思考帽
  • 星爆法
  • 头脑写作
  • SWOT 分析

示例场景：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
用户: /brainstorm
Creative: 我们要头脑风暴什么？
用户: 如何提升白板的性能和用户体验
Creative: 我将使用 3 种互补技术：
  1. SCAMPER - 生成创意变体
  2. 思维导图 - 组织想法
  3. SWOT - 战略评估

[执行头脑风暴工作流]

✓ 头脑风暴完成！

生成了：
- 28 个性能优化想法
- 15 个用户体验改进点

关键洞察：
1. 使用 OffscreenCanvas 优化渲染（SCAMPER: 修改）
2. 实现增量同步（思维导图：实时性分支）
3. 添加用户自定义快捷键（SWOT: 机会）

文档：bmad-outputs/brainstorming-optimization-2026-02-27.md

下一步：市场调研？(/research)

五、最佳实践与进阶技巧

5.1 项目级别选择

BMAD 支持不同级别的项目，选择合适的级别避免过度规划：

级别 故事数 规划 推荐命令
0 1 个故事 最小化 /product-brief → /tech-spec → /dev-story
1 1-10 个 轻量 /product-brief → /tech-spec → /create-story
2 5-15 个 标准 /product-brief → /prd → /architecture
3 12-40 个 全面 完整 BMAD（所有阶段）
4 40+ 个 企业级 完整 BMAD + Sprint 规划

5.2 状态跟踪

使用 /workflow-status 查看项目进度：

1
/workflow-status

输出示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
project_level: 3
last_workflow: architecture
last_workflow_date: "2026-02-27"

phase_1_analysis:
  product_brief_completed: true
  product_brief_date: "2026-02-25"

phase_2_planning:
  prd_completed: true
  prd_date: "2026-02-26"
  functional_requirements_count: 32
  nfr_requirements_count: 8

phase_3_solutioning:
  architecture_completed: true
  architecture_date: "2026-02-27"
  gate_check_passed: true
  gate_check_score: 94

phase_4_implementation:
  sprints_planned: 4
  stories_created: 28
  stories_completed: 7

5.3 自定义代理与工作流

使用 Builder Module 创建自定义代理：

1
/create-agent

交互示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
Claude Code: 这个代理应该扮演什么角色？
你回答: DevOps 工程师

Claude Code: 这个角色的 3-7 个关键职责是什么？
你回答:
- CI/CD 管道配置
- 容器化部署
- 监控与日志
- 备份与恢复

Claude Code: 这个代理会执行哪些工作流？
你回答:
- /deploy - 部署到生产环境
- /rollback - 回滚版本
- /monitoring - 设置监控

[Builder 生成 SKILL.md]

✓ DevOps 工程师技能已创建！
文件: ./custom-agents/devops-engineer/SKILL.md

安装: 复制到 ~/.claude/skills/bmad/bmb/devops-engineer/

5.4 Git Worktrees 并行开发

使用 SuperPowers 的 using-git-worktrees 技能进行并行分支开发：

1
/using-git-worktrees

工作流：

  1. 为每个功能分支创建独立的工作树
  2. 在不同的工作树中并行开发
  3. 避免频繁切换分支
  4. 每个工作树有独立的测试环境

5.5 代码审查集成

在子代理任务之间自动触发代码审查：

1
/requesting-code-review

审查检查清单：

  • ✅ 计划合规性
  • ✅ 代码质量（可读性、可维护性）
  • ✅ 测试覆盖率
  • ✅ 安全漏洞
  • ✅ 性能问题

5.6 调试方法论

遇到 Bug 时，使用 systematic-debugging：

1
/systematic-debugging

4 阶段根本原因分析：

  1. 问题定义 - 精确定义症状
  2. 根本原因追踪 - 追溯到源代码
  3. 深度防御 - 添加保护措施
  4. 验证 - 确保真正修复

六、常见问题与故障排除

Q1: 技能没有加载？

解决方案：

  1. 检查安装：ls ~/.claude/skills/bmad/
  2. 必须重启 Claude Code
  3. 查看启动日志，确认技能加载

Q2: 命令不工作？

解决方案：

  1. 确保已运行 /workflow-init
  2. 检查 bmad-outputs/project-config.yaml 是否存在
  3. 使用 /workflow-status 查看状态

Q3: 子代理工作不并行？

解决方案：

  1. 确保使用 subagent-driven-development 或 dispatching-parallel-agents
  2. 检查计划是否足够详细
  3. 确保任务之间没有强依赖

Q4: Token 使用过高？

解决方案：

  1. BMAD 自动优化 70-85% 的 token 使用
  2. 使用 Helper Pattern 避免重复内容
  3. 不要在每个会话中重复加载大型文档

七、总结：组合拳的威力

通过组合使用 Agent Teams、BMAD-SKILLS 和 SuperPowers，你可以：

✅ 系统化开发 - 从产品发现到部署的完整流程
✅ 并行加速 - 多个子代理同时工作
✅ 质量保证 - TDD + 两阶段审查 + 自动化测试
✅ 灵活扩展 - 自定义代理和工作流
✅ Token 优化 - 减少 70-85% 的使用
✅ 跨平台支持 - Windows、Linux、macOS、WSL

生产力提升：

  • 单人开发：相当于 2-3 人团队效率
  • 小团队：相当于 5-8 人团队效率
  • 大型项目：大幅减少规划与协调时间

八、推荐学习路径

入门（1-2 周）

  1. 安装 BMAD-SKILLS 和 SuperPowers
  2. 完成小型项目（如任务管理 API）
  3. 熟悉基本命令：/workflow-init、/product-brief、/tech-spec、/dev-story

进阶（2-4 周）

  1. 学习完整 BMAD 工作流（4 个阶段）
  2. 使用并行子代理开发中型项目
  3. 掌握 TDD 和代码审查流程
  4. 创建自定义代理和工作流

精通（1-2 月）

  1. 大型项目（Level 3-4）全流程实践
  2. 优化工作流，提升效率
  3. 深入理解 Token 优化
  4. 贡献自己的技能到社区

九、资源链接

Happy Coding! 🚀

如果你觉得这篇文章有帮助，别忘了：

  • ⭐ 给相关仓库点 Star
  • 💬 在社区分享你的经验
  • 🤝 贡献你的改进建议