✓ 21+ 专业AI代理

✓ 50+ 引导式工作流

✓ 规模自适应智能

✓ 四阶段开发方法论

2026年2月

目  录

第一章 BMAD概述 1

1.1 什么是BMAD 1

1.2 BMAD的核心优势 2

1.3 适用场景 3

第二章 安装与配置 5

2.1 环境要求 5

2.2 安装步骤 6

2.3 项目初始化 7

第三章 核心概念 9

3.1 四阶段方法论 9

3.2 AI代理体系 11

3.3 工作流系统 13

3.4 文档体系 15

第四章 快速入门 17

4.1 Quick Flow快速流程 17

4.2 BMAD Method完整流程 19

4.3 Enterprise企业级流程 22

第五章 详细工作流指南 25

5.1 分析阶段工作流 25

5.2 规划阶段工作流 28

5.3 方案阶段工作流 32

5.4 实现阶段工作流 36

第六章 代理使用详解 41

6.1 PM产品经理代理 41

6.2 Architect架构师代理 43

6.3 SM Scrum Master代理 45

6.4 DEV开发代理 47

6.5 其他专业代理 49

第七章 最佳实践 51

7.1 上下文管理 51

7.2 新鲜对话原则 53

7.3 团队协作模式 55

7.4 Party Mode派对模式 57

第八章 模块扩展 59

8.1 官方模块介绍 59

8.2 模块安装与使用 61

8.3 BMAD Builder自定义模块 63

第九章 常见问题 65

9.1 安装问题 65

9.2 使用问题 67

9.3 故障排除 69

第十章 进阶技巧 71

10.1 自定义工作流 71

10.2 高级配置 73

10.3 与其他工具集成 75

附录A 命令速查表 77

附录B 文档模板 79

附录C 资源链接 81

提示：首次打开时，右键点击目录选择“更新域”以显示正确页码

第一章 BMAD概述

1.1 什么是BMAD

BMAD（Breakthrough Method of Agile AI Driven Development，敏捷AI驱动开发的突破性方法）是一个全面的AI驱动软件开发框架。它通过结构化的工作流程、专业化的AI代理和智能规划系统，帮助开发团队更高效地构建软件产品。

BMAD的核心理念是将AI作为开发团队的协作伙伴，而非简单的代码生成工具。它模拟真实软件开发团队的协作模式，通过多个专业AI代理（如产品经理、架构师、Scrum Master、开发工程师等）的分工合作，实现从需求分析到代码实现的完整开发流程。

1.1.1 BMAD的起源与发展

BMAD由BMad Code组织开发和维护，是一个开源项目，在GitHub上拥有超过33,000个星标。该项目始于对传统AI辅助开发方式的反思，旨在解决以下问题：

• 临时性提示（Ad-hoc Prompting）导致的不一致性

• 上下文丢失和规划不连贯

• AI生成代码质量参差不齐

• 缺乏结构化的开发流程

经过多个版本的迭代，BMAD已经发展到V6版本，引入了规模自适应智能、多模块扩展系统和Party Mode等创新功能。

1.1.2 BMAD的核心组成

BMAD框架由以下核心组件构成：

组件 说明

AI代理系统 21+个专业AI代理，涵盖产品、架构、开发、测试等角色

工作流引擎 50+个引导式工作流，覆盖完整开发生命周期

文档体系 标准化的文档模板和上下文管理机制

模块系统 可扩展的模块架构，支持领域特定功能

CLI工具 命令行工具，简化安装和工作流执行

1.2 BMAD的核心优势

1.2.1 规模自适应智能

BMAD能够根据项目复杂度自动调整规划深度和工作流程。一个简单的Bug修复可能只需要Quick Flow的三个命令，而一个复杂的企业级系统则需要完整的四阶段方法论。这种自适应能力确保了开发效率的最大化。

1.2.2 上下文工程

BMAD采用先进的上下文工程技术，确保每个AI代理都能获得完成任务所需的完整信息。通过结构化的文档传递（PRD → 架构 → 故事 → 代码），避免了传统AI开发中常见的上下文丢失问题。

1.2.3 专业化代理协作

不同于单一AI模型处理所有任务，BMAD引入了多个专业代理，每个代理专注于特定领域：

• 分析师（Analyst）：负责头脑风暴和研究

• 产品经理（PM）：负责需求定义和PRD编写

• 架构师（Architect）：负责技术决策和系统设计

• Scrum Master（SM）：负责项目管理和故事拆分

• 开发工程师（DEV）：负责代码实现

• QA工程师：负责测试和质量保证

1.2.4 人机协作

BMAD强调人类开发者的主导作用，AI代理作为协作者提供专业建议。在每个关键决策点，人类开发者都有最终的决定权，确保开发方向符合业务目标。

1.3 适用场景

1.3.1 项目类型匹配

BMAD提供了三种规划轨道，适用于不同类型的项目：

轨道类型 适用场景 故事数量 产出文档

Quick Flow Bug修复、简单功能、范围明确 1-15个 技术规范

BMAD Method 产品、平台、复杂功能 10-50+个 PRD + 架构 + UX

Enterprise 合规系统、多租户架构 30+个 PRD + 架构 + 安全 + DevOps

1.3.2 团队规模

BMAD适用于各种规模的团队：

• 个人开发者：利用AI代理弥补技能短板

• 小型团队（2-5人）：提高开发效率，标准化流程

• 中型团队（5-20人）：协调多角色协作

• 大型团队（20+人）：Enterprise轨道支持复杂系统

1.3.3 技术栈支持

BMAD是技术栈无关的框架，支持各种编程语言和框架。通过模块扩展，还可以获得特定领域的深度支持：

• Web开发：React、Vue、Angular、Next.js等

• 后端开发：Node.js、Python、Java、Go等

• 移动开发：React Native、Flutter、iOS、Android

• 游戏开发：Unity、Unreal、Godot（通过Game Dev Studio模块）

第二章 安装与配置

2.1 环境要求

2.1.1 系统要求

运行BMAD需要以下环境：

组件 最低版本 说明

Node.js v20+ BMAD CLI的运行环境

Git 任意版本 版本控制（推荐）

AI IDE 最新版 Claude Code、Cursor、Windsurf等

2.1.2 AI开发工具

BMAD支持多种AI开发工具，以下是推荐选项：

• Claude Code（推荐）：Anthropic开发的CLI工具，与BMAD配合最佳

• Cursor：AI优先的代码编辑器，内置强大的AI功能

• Windsurf：Codeium开发的AI IDE，支持多种模型

• Roo Code：VS Code扩展，支持自定义AI代理

2.2 安装步骤

2.2.1 全局安装

在项目目录中打开终端，运行以下命令：

npx bmad-method install

安装程序会引导你完成以下步骤：

1.选择要安装的模块（可多选）

2.配置AI工具集成

3.创建项目基础结构

2.2.2 安装特定版本

如果需要安装特定版本（如V4稳定版），可以使用：

npx bmad-method@4.44.3 install

2.2.3 升级BMAD

要升级到最新版本，在项目目录中运行：

npx bmad-method upgrade

2.3 项目初始化

2.3.1 目录结构

安装完成后，BMAD会在项目中创建以下目录结构：

your-project/

├── _bmad/

BMAD配置目录

│   ├── agents/

AI代理定义

│   ├── workflows/

工作流定义

│   ├── prompts/

提示词模板

│   └── config.yaml

配置文件

├── _bmad-output/

输出目录

│   ├── PRD.md

产品需求文档

│   ├── architecture.md

架构文档

│   ├── epics/

Epic和故事文件

│   └── sprint-status.yaml

迭代状态

└── ...

你的项目代码

2.3.2 配置文件

_bmad/config.yaml是BMAD的核心配置文件，包含：

• 模块配置：启用的模块列表

• 代理设置：各代理的行为参数

• 工作流选项：工作流的默认配置

• 集成设置：与AI工具的集成配置

2.3.3 验证安装

安装完成后，运行以下命令验证BMAD是否正常工作：

/bmad-help

如果看到帮助信息，说明安装成功。/bmad-help命令会根据你的项目状态提供下一步建议。

第三章 核心概念

3.1 四阶段方法论

BMAD采用四阶段方法论，将软件开发过程分解为结构化的阶段：

3.1.1 分析阶段（Analysis）

分析阶段是可选的探索阶段，用于：

• 头脑风暴：探索产品创意和解决方案

• 市场研究：验证市场需求和竞争格局

• 产品简报：定义产品愿景和目标用户

此阶段产出：brainstorming-report.md、research-findings.md、product-brief.md

3.1.2 规划阶段（Planning）

规划阶段是必需阶段，定义“要构建什么”：

• PRD编写：详细的产品需求文档

• UX设计：用户界面和体验设计规范

此阶段产出：PRD.md、ux-spec.md

3.1.3 方案阶段（Solutioning）

方案阶段决定“如何构建”：

• 架构设计：技术选型、系统架构、ADR

• 故事拆分：将需求拆分为可实现的Epic和Story

• 实现准备度检查：验证规划的一致性

此阶段产出：architecture.md、epics/、实现准备度报告

3.1.4 实现阶段（Implementation）

实现阶段是编码阶段，采用迭代方式：

• 迭代规划：初始化sprint-status.yaml

• 故事开发：创建故事 → 开发 → 代码审查

• 迭代回顾：每个Epic完成后进行回顾

此阶段产出：代码、测试、sprint-status.yaml更新

3.2 AI代理体系

3.2.1 代理角色

BMAD定义了多个专业AI代理角色：

代理 角色名称 主要职责 对应阶段

Mary Analyst（分析师） 头脑风暴、研究 分析阶段

John PM（产品经理） PRD、Epic、Story 规划+方案

Sally UX Designer UX设计 规划阶段

Winston Architect（架构师） 架构设计 方案阶段

Bob Scrum Master 项目管理 实现阶段

Amelia Developer（开发） 代码实现 实现阶段

Quinn QA（测试） 测试自动化 实现阶段

3.2.2 代理加载方式

有两种方式使用代理：

• 直接运行工作流：使用/bmad-xxx命令自动加载对应代理

• 手动加载代理：使用/bmad-agent-xxx命令加载特定代理进行对话

3.3 工作流系统

3.3.1 工作流命名规范

BMAD工作流采用统一的命名规范：

/bmad-[模块]-[工作流名称]

例如：

• /bmad-bmm-create-prd：BMAD Method模块的创建PRD工作流

• /bmad-brainstorming：头脑风暴工作流

3.3.2 工作流类型

工作流分为以下几种类型：

• 创建型：生成文档或代码（create-xxx）

• 检查型：验证质量或一致性（check-xxx）

• 执行型：执行特定任务（dev-story、code-review）

• 管理型：项目管理相关（sprint-planning、retrospective）

3.4 文档体系

3.4.1 文档传递链

BMAD采用文档传递链确保上下文连续性：

product-brief.md → PRD.md → architecture.md → epics/ → story-xxx.md → code

3.4.2 文档类型说明

文档 说明 创建者

product-brief.md 产品简报，定义愿景和目标用户 Analyst/PM

PRD.md 产品需求文档，详细的功能和非功能需求 PM

ux-spec.md UX设计规范，界面和交互设计 UX Designer

architecture.md 架构文档，技术决策和系统设计 Architect

epics/*.md Epic文件，包含相关Story PM

story-*.md 故事文件，开发任务的完整上下文 SM

sprint-status.yaml 迭代状态跟踪 SM

第四章 快速入门

4.1 Quick Flow快速流程

4.1.1 适用场景

Quick Flow适用于以下场景：

• Bug修复

• 简单功能添加

• 范围明确的变更

• 1-15个故事的小任务

4.1.2 三步快速开发

Quick Flow只需三个命令即可完成开发：

步骤1：创建技术规范

/quick-spec

此命令会：

• 分析现有代码库

• 生成技术规范文档

• 创建用户故事

步骤2：开发实现

/dev-story

此命令会：

• 读取技术规范

• 实现每个故事

• 生成测试代码

步骤3：代码审查

/code-review

此命令会：

• 验证代码质量

• 检查最佳实践

• 提供改进建议

4.2 BMAD Method完整流程

4.2.1 流程概览

BMAD Method是完整的四阶段开发流程，适用于产品级开发：

阶段 工作流 命令 产出

分析 头脑风暴（可选） /bmad-brainstorming brainstorming-report.md

分析 研究（可选） /bmad-bmm-research research-findings.md

分析 创建产品简报 /bmad-bmm-create-product-brief product-brief.md

规划 创建PRD /bmad-bmm-create-prd PRD.md

规划 UX设计（可选） /bmad-bmm-create-ux-design ux-spec.md

方案 创建架构 /bmad-bmm-create-architecture architecture.md

方案 创建Epics和Stories /bmad-bmm-create-epics-and-stories epics/

方案 实现准备度检查 /bmad-bmm-check-implementation-readiness 检查报告

实现 迭代规划 /bmad-bmm-sprint-planning sprint-status.yaml

实现 创建故事 /bmad-bmm-create-story story-xxx.md

实现 开发故事 /bmad-bmm-dev-story 代码

实现 代码审查 /bmad-bmm-code-review 审查报告

实现 迭代回顾 /bmad-bmm-retrospective 回顾报告

4.2.2 详细步骤

【步骤1】创建产品简报

加载PM代理

/bmad-agent-bmm-pm

或直接使用工作流

/bmad-bmm-create-product-brief

输入你的产品想法，PM代理会引导你完成产品简报的定义。

【步骤2】创建PRD

/bmad-bmm-create-prd

PM代理会基于产品简报创建详细的产品需求文档。

【步骤3】UX设计（如有UI）

/bmad-agent-bmm-ux-designer

/bmad-bmm-create-ux-design

UX设计师代理会创建用户界面和交互设计规范。

【步骤4】创建架构

/bmad-agent-bmm-architect

/bmad-bmm-create-architecture

架构师代理会进行技术选型并创建架构文档。

【步骤5】创建Epics和Stories

/bmad-agent-bmm-pm

/bmad-bmm-create-epics-and-stories

PM代理会将PRD和架构文档转换为可实现的Epic和Story。

【步骤6】实现准备度检查

/bmad-bmm-check-implementation-readiness

架构师代理会验证所有规划文档的一致性。

【步骤7】迭代规划

/bmad-agent-bmm-sm

/bmad-bmm-sprint-planning

SM代理会初始化sprint-status.yaml用于跟踪进度。

【步骤8】开发循环

对每个Story重复以下步骤：

创建故事

/bmad-bmm-create-story

开发实现

/bmad-bmm-dev-story

代码审查

/bmad-bmm-code-review

4.3 Enterprise企业级流程

4.3.1 适用场景

Enterprise轨道适用于：

• 合规要求严格的系统

• 多租户架构

• 大型企业应用

• 30+个故事的复杂项目

4.3.2 额外产出

Enterprise流程在BMAD Method基础上增加了：

• 安全规范文档

• DevOps配置

• 合规检查清单

• 风险评估报告

第五章 详细工作流指南

5.1 分析阶段工作流

5.1.1 头脑风暴（brainstorming）

命令：/bmad-brainstorming

代理：Analyst（Mary）

产出：brainstorming-report.md

头脑风暴工作流帮助你：

• 探索产品创意和方向

• 识别潜在机会和风险

• 生成创新解决方案

5.1.2 研究（research）

命令：/bmad-bmm-research

代理：Analyst（Mary）

产出：research-findings.md

研究工作流帮助你：

• 验证市场假设

• 分析竞争对手

• 了解技术可行性

5.1.3 创建产品简报（create-product-brief）

命令：/bmad-bmm-create-product-brief

代理：Analyst/PM

产出：product-brief.md

产品简报包含：

• 产品愿景

• 目标用户画像

• 核心价值主张

• 成功指标

5.2 规划阶段工作流

5.2.1 创建PRD（create-prd）

命令：/bmad-bmm-create-prd

代理：PM（John）

产出：PRD.md

PRD（Product Requirements Document）是BMAD的核心文档，包含：

章节 内容

产品概述 产品背景、目标、范围

用户画像 目标用户特征、需求、痛点

功能需求 详细的功能描述、用户故事

非功能需求 性能、安全、可用性要求

用户旅程 关键流程和交互

成功指标 KPI和验收标准

风险与假设 潜在风险和缓解策略

5.2.2 创建UX设计（create-ux-design）

命令：/bmad-bmm-create-ux-design

代理：UX Designer（Sally）

产出：ux-spec.md

UX设计规范包含：

• 信息架构

• 用户流程

• 线框图描述

• 交互规范

5.3 方案阶段工作流

5.3.1 创建架构（create-architecture）

命令：/bmad-bmm-create-architecture

代理：Architect（Winston）

产出：architecture.md

架构文档包含：

• 技术栈选择

• 系统架构图

• 数据模型

• API设计

• ADR（架构决策记录）

5.3.2 创建Epics和Stories（create-epics-and-stories）

命令：/bmad-bmm-create-epics-and-stories

代理：PM（John）

产出：epics/目录

此工作流将PRD和架构转换为可实现的Epic和Story。V6版本的改进是在架构之后创建Stories，这样可以根据技术决策更好地拆分工作。

5.3.3 实现准备度检查（check-implementation-readiness）

命令：/bmad-bmm-check-implementation-readiness

代理：Architect（Winston）

产出：PASS/CONCERNS/FAIL

此检查验证：

• PRD与架构的一致性

• 故事拆分的合理性

• 技术可行性

5.4 实现阶段工作流

5.4.1 迭代规划（sprint-planning）

命令：/bmad-bmm-sprint-planning

代理：SM（Bob）

产出：sprint-status.yaml

sprint-status.yaml跟踪所有Epics和Stories的状态：

epics:

- id: 1

title: 用户认证系统

status: in-progress

stories:

- id: 1-1

title: 实现登录功能

status: done

- id: 1-2

title: 实现注册功能

status: in-progress

5.4.2 创建故事（create-story）

命令：/bmad-bmm-create-story

代理：SM（Bob）

产出：story-[slug].md

故事文件包含完整的实现上下文：

• 故事描述和验收标准

• 相关数据库表结构

• API接口定义

• UI设计描述

• 依赖关系

5.4.3 开发故事（dev-story）

命令：/bmad-bmm-dev-story

代理：Developer（Amelia）

产出：代码+测试

开发工作流会：

• 读取故事文件

• 理解架构规范

• 实现功能代码

• 编写单元测试

• 运行测试验证

5.4.4 代码审查（code-review）

命令：/bmad-bmm-code-review

代理：Developer（Amelia）

产出：审查报告

代码审查检查：

• 代码质量

• 最佳实践遵循

• 架构一致性

• 安全性

• 性能

5.4.5 测试自动化（automate）

命令：/bmad-bmm-automate 或 QA

代理：Quinn（QA）

产出：测试套件

Quinn代理会生成：

• API测试

• E2E测试

• 集成测试

5.4.6 迭代回顾（retrospective）

命令：/bmad-bmm-retrospective

代理：SM（Bob）

产出：回顾报告

每个Epic完成后进行回顾，总结：

• 做得好的地方

• 需要改进的地方

• 经验教训

5.4.7 路线修正（correct-course）

命令：/bmad-bmm-correct-course

代理：PM（John）

产出：更新后的计划

当需求发生重大变化时使用，PM代理会：

• 评估影响范围

• 更新相关文档

• 调整故事优先级

第六章 代理使用详解

6.1 PM产品经理代理

6.1.1 代理概述

PM代理（John）是产品规划的核心角色，负责将产品愿景转化为详细的需求文档和可执行的开发任务。

6.1.2 主要工作流

• /bmad-bmm-create-product-brief：创建产品简报

• /bmad-bmm-create-prd：创建产品需求文档

• /bmad-bmm-create-epics-and-stories：创建Epic和Story

• /bmad-bmm-correct-course：路线修正

6.1.3 使用技巧

与PM代理协作时：

• 提供清晰的产品愿景和业务目标

• 主动参与需求讨论，不要完全依赖AI

• 审核生成的PRD，确保符合业务需求

• 在Epic拆分阶段提供技术限制信息

6.1.4 PRD最佳实践

一个高质量的PRD应该包含：

• 明确的用户画像和使用场景

• 详细的功能描述和验收标准

• 清晰的非功能需求（性能、安全等）

• 可量化的成功指标

6.2 Architect架构师代理

6.2.1 代理概述

架构师代理（Winston）负责技术决策和系统设计，确保技术方案满足业务需求并具有良好的可维护性。

6.2.2 主要工作流

• /bmad-bmm-create-architecture：创建架构文档

• /bmad-bmm-check-implementation-readiness：实现准备度检查

6.2.3 架构文档要素

架构文档应包含以下要素：

要素 说明

技术栈 编程语言、框架、数据库、工具等

系统架构 整体架构图、组件关系

数据模型 数据库设计、实体关系

API设计 接口定义、数据格式

安全设计 认证授权、数据保护

部署架构 基础设施、CI/CD

ADR 关键架构决策记录

6.2.4 架构决策记录（ADR）

ADR是架构文档的重要组成部分，每个ADR包含：

• 背景：需要解决的问题

• 决策：选择的方案

• 后果：选择的优缺点

6.3 SM Scrum Master代理

6.3.1 代理概述

SM代理（Bob）负责项目管理和流程协调，确保开发过程按计划进行。

6.3.2 主要工作流

• /bmad-bmm-sprint-planning：迭代规划

• /bmad-bmm-create-story：创建故事

• /bmad-bmm-retrospective：迭代回顾

6.3.3 故事管理

SM代理负责将Epic拆分为可执行的Story，每个Story应该：

• 有明确的目标和范围

• 包含完整的实现上下文

• 有清晰的验收标准

• 估算合理的工作量

6.3.4 sprint-status.yaml

sprint-status.yaml是SM代理的核心工作产物，用于跟踪项目进度：

sprint-status.yaml 示例

epics:

- id: 1

title: 用户认证系统

status: in-progress

priority: high

stories:

- id: 1-1

title: 实现登录功能

status: done

assignee: dev-1

- id: 1-2

title: 实现注册功能

status: in-progress

assignee: dev-2

- id: 1-3

title: 实现密码重置

status: backlog

assignee: null

6.4 DEV开发代理

6.4.1 代理概述

开发代理（Amelia）是代码实现的主力军，负责将Story转化为可工作的代码。

6.4.2 主要工作流

• /bmad-bmm-dev-story：开发故事

• /bmad-bmm-code-review：代码审查

• /bmad-bmm-quick-dev：快速开发（Quick Flow）

6.4.3 开发流程

DEV代理的开发流程：

1.读取Story文件，理解需求

2.查看架构文档，遵循设计规范

3.编写代码实现功能

4.编写单元测试

5.运行测试验证

6.提交代码

6.4.4 代码质量

DEV代理生成的代码应符合以下质量标准：

• 遵循项目编码规范

• 有适当的注释

• 包含单元测试

• 通过代码审查

6.5 其他专业代理

6.5.1 Analyst分析师代理（Mary）

负责：

• 头脑风暴引导

• 市场和竞品研究

• 产品简报创建

6.5.2 UX Designer设计师代理（Sally）

负责：

• 用户界面设计

• 交互设计规范

• 用户体验优化

6.5.3 QA测试代理（Quinn）

Quinn是内置的QA代理，负责：

• 生成API测试

• 生成E2E测试

• 测试框架集成

使用命令：/bmad-bmm-automate 或 QA

6.5.4 Party Mode多代理模式

Party Mode允许同时加载多个代理进行协作讨论：

进入Party Mode

/bmad-party-mode

邀请多个代理

@Mary @John @Winston 我们来讨论这个架构设计

适用场景：

• 复杂问题的多角度讨论

• 架构方案评审

• 故障排查

第七章 最佳实践

7.1 上下文管理

7.1.1 文档传递链

BMAD的核心优势在于结构化的上下文管理。理解文档传递链对于成功使用BMAD至关重要：

product-brief.md → PRD.md → architecture.md → epics/ → story-xxx.md → code

每个文档都是下一个阶段的输入，确保AI代理始终拥有完整的上下文。

7.1.2 上下文加载机制

不同工作流会自动加载相关文档：

工作流 加载的文档

create-story PRD、架构、UX、Epics

dev-story Story文件

code-review 架构、Story

quick-dev 技术规范

7.1.3 避免上下文丢失

以下做法会导致上下文丢失：

✗ 在同一会话中运行多个工作流

✗ 跳过规划阶段直接进入开发

✗ 不更新sprint-status.yaml

7.2 新鲜对话原则

7.2.1 为什么需要新鲜对话

每个工作流都应该在新的对话中运行，原因如下：

• 避免上下文窗口限制

• 防止信息污染

• 确保工作流按预期执行

7.2.2 正确的工作流执行方式

/bmad-bmm-create-prd

/bmad-bmm-create-architecture

/bmad-bmm-create-prd

/bmad-bmm-create-architecture

7.2.3 对话管理建议

• 为每个工作流创建有意义的对话标题

• 关闭已完成的工作流对话

• 定期清理历史对话

7.3 团队协作模式

7.3.1 单人开发模式

单人开发者可以充分利用BMAD的所有代理：

• 自己担任产品负责人角色

• 使用BMAD代理弥补技能短板

• 快速完成从规划到实现的全流程

7.3.2 团队开发模式

在团队中，BMAD可以辅助人类成员：

• PM使用BMAD PM代理辅助需求分析

• 架构师使用Architect代理探索方案

• 开发者使用DEV代理加速编码

7.3.3 文档共享

_bmad-output/目录下的所有文档都可以：

• 提交到版本控制

• 与团队成员共享

• 作为项目文档的一部分

7.4 Party Mode派对模式

7.4.1 什么是Party Mode

Party Mode是BMAD的创新功能，允许同时加载多个代理进行协作讨论。就像召开一个虚拟会议，多个专家同时参与讨论。

7.4.2 使用场景

• 架构方案讨论：Architect + PM + Tech Lead

• 需求澄清：PM + Analyst + UX Designer

• 故障排查：DEV + Architect + QA

7.4.3 使用方法

/bmad-party-mode

7.4.4 注意事项

• Party Mode适合讨论，不适合执行工作流

• 明确讨论目标和范围

• 记录讨论结论

第八章 模块扩展

8.1 官方模块介绍

8.1.1 BMAD Method（BMM）

BMM是BMAD的核心模块，提供软件开发的基础工作流：

• 34+个工作流

• 覆盖4个开发阶段

• 12+个专业代理

BMM是必装模块，其他模块在此基础上扩展。

8.1.2 BMAD Builder（BMB）

BMB是BMAD的扩展开发工具，用于：

• 创建自定义代理

• 创建自定义工作流

• 开发领域特定模块

8.1.3 Test Architect（TEA）

TEA是企业级测试模块，提供：

• 8个测试工作流

• 风险驱动的测试策略

• 质量门禁

• 34个测试模式和最佳实践

8.1.4 Game Dev Studio（BMGD）

BMGD是游戏开发专用模块：

• Unity支持

• Unreal Engine支持

• Godot支持

• 游戏特定工作流

8.1.5 Creative Intelligence Suite（CIS）

CIS是创新工具包：

• 头脑风暴工作流

• 设计思维

• 问题解决

• 创意写作

8.2 模块安装与使用

8.2.1 安装模块

在安装BMAD时选择需要的模块：

npx bmad-method install

在提示中选择需要的模块

8.2.2 添加新模块

在已有项目中添加新模块：

npx bmad-method add [module-name]

例如

npx bmad-method add tea

8.2.3 模块命令

不同模块提供不同的命令前缀：

模块 命令前缀 示例

BMM /bmad-bmm- /bmad-bmm-create-prd

TEA /bmad-tea- /bmad-tea-test-strategy

BMGD /bmad-bmgd- /bmad-bmgd-design-level

CIS /bmad-cis- /bmad-cis-brainstorm

8.3 BMAD Builder自定义模块

8.3.1 创建自定义代理

使用BMB创建自定义代理：

npx bmad-builder create-agent

8.3.2 创建自定义工作流

创建符合团队需求的工作流：

npx bmad-builder create-workflow

8.3.3 发布自定义模块

第九章常见问题

第九章常见问题

9.1 安装问题

9.1.1 Node.js版本问题

问题：安装时提示Node.js版本过低

解决方案：

# 检查当前Node.js版本node --version# 如果低于v20，请升级# 使用nvm切换版本nvm install 20nvm use 20

9.1.2 网络问题

问题：安装时网络超时

解决方案：

# 使用镜像源npm config set registry https://registry.npmmirror.com# 或使用代理npx bmad-method install --proxy http://proxy.example.com

9.1.3 权限问题

问题：安装时权限不足

解决方案：

# 使用npx（推荐），无需全局安装npx bmad-method install# 或者修改npm权限sudo chown -R $(whoami) ~/.npm

9.2 使用问题

9.2.1 代理不响应

问题：运行命令后代理没有响应

可能原因和解决方案：

• AI工具未正确配置：检查.bmad/config.yaml

• 代理文件损坏：重新安装BMAD

• 上下文过长：新建对话重试

9.2.2 文档生成失败

问题：工作流运行但文档未生成

检查事项：

• _bmad-output/目录是否存在

• 目录权限是否正确

• 磁盘空间是否充足

9.2.3 代码质量不理想

问题：生成的代码不符合预期

改进建议：

• 提供更详细的Story描述

• 在架构文档中明确编码规范

• 使用code-review工作流进行质量检查

9.3 故障排除

9.3.1 重置BMAD

如果遇到无法解决的问题，可以重置BMAD：cp -r _bmad _bmad.backuprm -rf _bmadnpx bmad-method install

9.3.2 查看日志

启用调试日志以排查问题：

# 设置环境变量export BMAD_DEBUG=true# 运行工作流/bmad-bmm-create-prd# 查看日志cat _bmad/logs/debug.log

9.3.3 获取帮助

获取更多帮助的渠道：

• 运行 /bmad-help 获取交互式帮助

• 加入 Discord 社区

• 查看官方文档

• 在GitHub提交Issue

附录A 命令速查表

A.1 核心命令

A.2 Quick Flow命令

A.3 代理加载命令