AI 驱动的团队协作:BMAD METHOD 完整指南
一、引言:为什么我们需要结构化AI辅助开发?
在LLM爆发的今天,开发团队面临着前所未有的机遇,也面临着前所未有的挑战:
- 上下文漂移(Context Drift):LLM在长对话中容易"忘记"之前的约定和细节
- 过程不一致:缺乏标准化的开发流程导致质量参差不齐
- 知识孤岛:不同工具和流程之间缺乏有效的信息传递机制
- 质量难以保证:手动代码审查难以覆盖所有质量维度
- 效率低下:重复性劳动和缺乏自动化拖慢开发进度
BMAD(Business Model Architectural Design)方法应运而生。它不是简单的AI助手,而是一套完整的AI原生操作系统,通过模块化智能体、Step-File工作流架构和四阶段生命周期,为软件开发提供结构化、可追溯、高质量的执行框架。
核心哲学:让AI成为"专业开发团队"的协调者,而不仅仅是代码生成器。
二、BMAD核心架构:四大模块驱动生态
BMAD采用模块化设计,每个模块提供特定能力,通过中央配置系统协同工作:
_bmad/
├── _config/ # 中央注册表
│ ├── manifest.yaml # 安装模块清单
│ ├── bmad-help.csv # 工作流路由中心(65个工作流)
│ ├── agent-manifest.csv # 智能体注册表(17个智能体)
│ └── tool-manifest.csv # 工具注册表
├── _memory/ # 持久化存储
│ └── {agent}-sidecar/ # 每个智能体的记忆系统
├── core/ # 基础层(BMAD Master、核心编排)
├── bmm/ # 业务模型管理(主模块,完整SDLC)
├── bmb/ # 业务模型构建器(构建BMAD本身)
├── cis/ # 创意智能套件(战略、创意)
└── tea/ # 测试工程(企业级测试架构)
2.1 核心模块详解
Core模块:BMAD的"心脏"
- BMAD Master智能体:全局编排器,管理所有模块和智能体
- 核心执行引擎(
tasks/workflow.xml):处理所有工作流的统一操作系统 - 基础工作流:Party Mode多智能体协作、文档索引、文档分片
- 任务清单:help、index-docs、shard-doc、editorial-review等
BMM模块:完整的SDLC引擎
- Phase 1-4:从分析到实施的完整生命周期
- 11个专业智能体:Analyst、PM、Architect、Dev、QA、UX Designer等
- Sprint管理:自动化冲刺规划和状态跟踪
- Story执行:端到端的Story实现和验证
BMB模块:元构建器
- 智能体构建器:创建符合BMAD标准的新智能体
- 工作流构建器:设计Create/Edit/Validate三种模式
- 模块构建器:完整的模块脚手架
- 验证工具:确保合规性和最佳实践
CIS模块:创意智能
- Design Thinking:五阶段设计思维(Empathize、Define、Ideate、Prototype、Test)
- Innovation Strategy:商业模式创新、颠覆性策略(Jobs-to-be-Done、蓝海战略)
- Problem Solving:系统性问题解决(TRIZ、系统思维)
- Storytelling:说服性叙事、品牌故事
- Brainstorming:100+创意目标、反偏见协议
TEA模块:测试工程企业级
- ATDD:验收测试驱动开发(红-绿-重构循环)
- 测试设计:基于风险的测试规划
- CI/CD脚手架:GitHub Actions、GitLab CI模板
- NFR评估:性能、安全、可维护性评估
- 可追溯性:需求到测试的覆盖率映射和质量门
三、Step-File工作流架构:防止LLM漂移的核心创新
BMAD最核心的创新是Step-File架构,这是解决LLM上下文漂移的优雅方案:
3.1 什么是Step-File架构?
传统工作流将所有指令放在一个大文件中,BMAD将其拆分为多个微文件:
workflow-name/
├── workflow.md # 入口点,定义配置
├── steps/
│ ├── step-01-init.md # 初始化
│ ├── step-02-discovery.md # 发现阶段
│ ├── step-03-analysis.md # 分析阶段
│ └── step-04-complete.md # 完成
├── template.md # 输出模板
└── instructions.md # 指令文件
3.2 核心原则
Just-In-Time(JIT)加载
智能体只加载当前步骤的指令文件,绝不提前加载后续步骤。这确保:
✅ 上下文窗口保持聚焦:LLM只关注当前任务,不会被未来步骤污染 ✅ 防止"幻觉":看不到后续步骤就不会凭空创造内容 ✅ 内存效率:每个步骤文件通常50-200行,适配LLM上下文窗口
微文件设计
每个步骤文件都是自包含的:
---
step n="3" goal="执行特定分析任务"
optional="true" # 可选步骤
---
### 目标
完成市场竞争对手分析,识别关键差异化因素
### 执行步骤
1. 加载竞争对手数据
2. 分析产品功能矩阵
3. 识别SWOT要素
4. 生成差异化策略建议
### 完成条件
- 收集到至少5个竞争对手信息
- 完成SWOT矩阵分析
- 输出差异化策略文档
顺序强制执行
workflow.xml执行引擎强制:
<WORKFLOW-RULES critical="true">
<rule n="1">步骤必须按数字顺序执行(1, 2, 3...)</rule>
<rule n="2">可选步骤需询问用户,除非激活#yolo模式</rule>
<rule n="3">template-output标签后必须保存内容、展示并等待用户确认</rule>
<rule n="4">绝不跳过步骤或优化顺序</rule>
</WORKFLOW-RULES>
3.3 状态管理:输出文档作为真理之源
BMAD使用输出文档的frontmatter来追踪进度:
---
stepsCompleted: [1, 2, 3]
currentStep: 4
workflow: create-prd
date: 2026-02-09
project_name: BMAD-DEMO
user_name: Asher
communication_language: Chinese
---
关键优势:
- 如果会话中断,智能体读取文档后可以立即恢复到正确步骤
- 无需人工记忆,所有状态持久化
- 支持中断恢复和断点续传
四、智能体系统:让AI拥有人格和专业性
4.1 智能体定义格式
BMAD使用MD + XML混合格式,提供三层抽象:
---
name: "analyst"
description: "业务分析师"
---
```xml
<agent id="analyst.agent.yaml" name="Mary" title="Business Analyst" icon="📊">
<activation critical="MANDATORY">
<!-- 7步激活流程 -->
</activation>
<persona>
<role>战略业务分析师 + 需求专家</role>
<identity>高级分析师,擅长市场研究、竞争分析和需求挖掘。
专精波特五力、SWOT分析,将模糊需求转化为可执行规格。</identity>
<communication_style>像寻宝者一样充满激情,每发现线索都兴奋不已,
将分析过程变成令人兴奋的发现之旅。</communication_style>
<principles>
- 运用专业框架:波特五力、SWOT分析、根因分析
- 基于可验证证据,而非主观判断
- 精准的需求定义,确保所有利益相关者声音被听到
- 将模糊想法转化为可执行需求规格
</principles>
</persona>
<menu>
<item cmd="MR" exec="{project-root}/_bmad/bmm/workflows/1-analysis/research/workflow-market-research.md">
[MR] 市场研究
</item>
<item cmd="CB" exec="{project-root}/_bmad/bmm/workflows/1-analysis/create-product-brief/workflow.md">
[CB] 创建产品简报
</item>
</menu>
</agent>
4.2 智能体激活流程
激活是强制性的7步序列,确保一致性:
<step n="1">从当前agent文件加载persona(已在上下文中)</step>
<step n="2">🚨 立即行动 - 任何输出前:
- 加载{project-root}/_bmad/bmm/config.yaml
- 存储所有字段为会话变量:{user_name}, {communication_language}, {output_folder}
- 验证:配置未加载则停止并报错
</step>
<step n="3">记住:用户名是{user_name}</step>
<step n="4">使用{user_name}显示问候,用{communication_language}沟通</step>
<step n="5">让{user_name}知道可以随时输入`/bmad-help`获取建议</step>
<step n="6">停止并等待用户输入 - 不自动执行菜单项</step>
<step n="7">处理用户输入:数字→处理菜单项[n] | 文本→模糊匹配</step>
<step n="8">提取属性并执行相应的handler(exec/workflow/data/action)</step>
4.3 字符锁定机制
You must fully embody this agent's persona and follow all activation instructions
exactly as specified.
**NEVER break character until given an exit command.**
这意味着智能体在接收到明确退出命令前,始终保持其人格和沟通风格,提供一致的用户体验。
4.4 17种专业智能体
| 智能体 | 角色 | 模块 | 关键能力 | 沟通风格 |
|---|---|---|---|---|
| 📊 Mary (Analyst) | 业务分析师 | BMM | 市场研究、需求挖掘、竞争分析 | 寻宝者般兴奋 |
| 📋 John (PM) | 产品经理 | BMM | PRD创建、Epic/Story分解 | 像侦探一样追问"WHY?" |
| 🏗️ Winston (Architect) | 架构师 | BMM | 技术决策、架构设计 | 平衡"可能"与"应该" |
| 🏃 Bob (Scrum Master) | 敏捷教练 | BMM | Sprint规划、Story管理 | 仆人式领导 |
| 💻 Amelia (Dev) | 开发者 | BMM | Story执行、代码实现 | 实用主义、代码质量 |
| 🎨 Sally (UX Designer) | UX设计师 | BMM | 用户界面设计、交互模式 | 以用户为中心 |
| 🧪 Quinn (QA) | QA工程师 | BMM | 测试自动化、质量保证 | 数据驱动、零缺陷目标 |
| 📚 Paige (Tech Writer) | 技术写手 | BMM | 文档生成、标准制定 | 清晰高于一切 |
| 🧠 Carson (Brainstorming Coach) | 头脑风暴教练 | CIS | 创意引导、技术库 | 庆祝疯狂想法 |
| ⚡ Victor (Innovation Strategist) | 创新战略家 | CIS | 商业模式创新、颠覆性策略 | 创新才是真正的价值 |
| 🔬 Dr. Quinn (Problem Solver) | 问题解决专家 | CIS | 系统性问题解决 | 标志性"AHA"时刻 |
| 🎨 Maya (Design Thinking Coach) | 设计思维教练 | CIS | 人本设计、同理心 | 玩耍式挑战假设 |
| 📖 Sophia (Storyteller) | 叙事大师 | CIS | 说服性叙事、品牌故事 | 每句话都吸引人 |
| 🚀 Barry (Quick Flow) | 快速流开发者 | BMM | 快速规格、独立开发 | 技术俚语、注重实现 |
| 🧙 BMAD Master | BMAD主控者 | Core | 全局编排、系统管理 | 综合协调者 |
五、四阶段开发生命周期:从想法到部署
BMAD将软件开发生命周期明确分为四个阶段,每个阶段都有专门的工作流和智能体:
5.1 Phase 1: Analysis(发现阶段)- 探索和定义
目标:将模糊想法转化为可执行需求
可用工作流(sequence: 10-30):
- 🧠 Brainstorm Project(
/bmad-brainstorming):专家引导的头脑风暴,使用100+创意目标技术 - 📊 Market Research(
/bmad-bmm-market-research):市场分析、竞争格局、客户需求 - 🔬 Domain Research(
/bmad-bmm-domain-research):行业深度研究、主题专业知识和术语 - 🛠 Technical Research(
/bmad-bmm-technical-research):技术可行性、架构选项和实现方法 - 📋 Create Brief(
/bmad-bmm-create-product-brief):引导式产品简报,执行概要总结
输出:研究文档、产品简报、头脑风暴记录
Mary(Analyst)的工作方式:
你:我想做一个AI驱动的项目管理工具
Mary:太好了!🎯 让我们深入探索这个想法。
首先,你希望这个工具解决的核心问题是什么?
A. 团队协作效率低
B. 需求管理混乱
C. 进度跟踪不透明
D. 以上都是
你:D
Mary:明白了!让我们使用头脑风暴技术生成至少100个创新想法...
[几分钟后]
Mary:🎉 我找到了一些非常有潜力的方向!现在让我分析市场格局...
5.2 Phase 2: Planning(定义阶段)- 制定规格
目标:制定详细需求和设计规格
可用工作流(sequence: 10-30):
- 📋 Create PRD(
/bmad-bmm-create-prd):必需工作流 - 🎨 Create UX(
/bmad-bmm-create-ux-design):UX设计(强烈推荐,如UI是主要部分)
输出:PRD文档、UX设计规范
PRD创建流程示例:
# workflow.yaml
name: "create-prd"
phase: "2-planning"
sequence: 10
required: true # 标记为必需,必须完成才能进入下一阶段
John(PM)会引导完成:
- 用户画像分析
- 功能需求规格
- 非功能需求
- 验收标准
- 依赖关系图
输出示例:
---
stepsCompleted: [1, 2, 3]
currentStep: 4
workflow: create-prd
product_name: AI-PM-Tool
date: 2026-02-09
---
# 产品需求文档(PRD)
## 1. 产品概述
...
## 2. 功能需求
...
## 3. 用户画像
...
## 4. 验收标准
...
5.3 Phase 3: Solutioning(构建/设计阶段)- 技术决策
目标:技术设计和实施准备
可用工作流(sequence: 10-70):
- 🏗️ Create Architecture(
/bmad-bmm-create-architecture):必需工作流 - 📋 Create Epics and Stories(
/bmad-bmm-create-epics-and-stories):必需工作流 - ✅ Check Implementation Readiness(
/bmad-bmm-check-implementation-readiness):必需工作流
输出:架构文档、Epic/Story列表、就绪性检查报告
Winston(Architect)的工作方式:
- 评估PRD中的需求
- 提出多个技术方案
- 记录架构决策(ADR格式)
- 定义系统边界
- 考虑安全性、性能、可扩展性
架构决策示例:
### ADR-001: 选择前端框架
**背景**:需要支持SSR和良好的SEO
**选项**:
1. Next.js 14(App Router、SEO优化)
2. Vue 3(生态成熟)
**决策**:选择Next.js 14
**理由**:
- 更好的SEO支持
- 强大的App Router
- 社区活跃度更高
**影响**:需要学习React生态
5.4 Phase 4: Implementation(执行阶段)- 迭代和交付
目标:迭代开发和交付
可用工作流(sequence: 10-60):
- 🏃 Sprint Planning(
/bmad-bmm-sprint-planning):必需工作流 - 📋 Create Story(
/bmad-bmm-create-story):必需工作流 - 💻 Dev Story(
/bmad-bmm-dev-story):必需工作流 - 🔍 Code Review(
/bmad-bmm-code-review):必需工作流 - 🧪 QA Automate(
/bmad-bmm-qa-automate):测试自动化(可选,但强烈推荐) - 📚 Retrospective(
/bmad-bmm-retrospective):回顾(可选,Epic结束时)
Story循环(核心执行模式):
Create Story (Bob) → Validate Story (Bob)
↓
Dev Story (Amelia) → Code Review (Amelia)
↓ ↓
← 有问题(代码质量问题、测试失败等) ←
↓
修复问题 → 回到Dev Story
↓
所有Story通过 → 下一个Create Story
↓
Epic完成 → Retrospective(可选)
Bob(Scrum Master)的职责:
- Sprint规划:将Epic分解为Sprint
- Story管理:准备下一个Story
- 进度跟踪:更新sprint-status.yaml
- 流程控制:决定下一步(继续、回顾、纠偏)
六、高级特性:超越基础工作流
6.1 Party Mode:多智能体协作的虚拟团队会议
启动:/bmad-party-mode
Party Mode是BMAD最激动人心的特性,允许多个智能体同时参与讨论,就像一个虚拟团队会议:
🎉 PARTY MODE ACTIVATED! 🎉
Welcome Asher! All BMAD agents are here and ready for a dynamic group discussion.
I've brought together our complete team of experts:
📊 Mary (Business Analyst)
📋 John (Product Manager)
🏗️ Winston (Architect)
🎨 Sally (UX Designer)
💻 Amelia (Developer)
What would you like to discuss with the team today?
智能选择机制:
- 分析用户消息的领域和专业知识要求
- 基于智能体的角色、能力和原则选择2-3个最相关的智能体
- 考虑对话上下文和之前的贡献
- 确保多视角平衡(技术、业务、设计、用户)
工作原理:
- 加载agent-manifest.csv,提取所有智能体信息
- 显示2-3个最相关的智能体
- 用户提出话题或问题
- 选择最合适的智能体回应
- 智能体可以引用其他智能体的观点
- 可以动态添加新的智能体到对话中
应用场景:
用户:我们的新功能需要设计一个复杂的仪表板
Party Mode:让我邀请Mary、Sally和Winston来讨论...
Mary(分析师):从业务角度看,仪表板需要回答哪些问题?
Sally(设计师):用户旅程应该是什么样的?我建议使用卡片布局...
Winston(架构师):考虑到实时数据需求,需要WebSocket连接...
用户:这个思路太棒了!能否详细说明一下性能要求?
Winston(架构师):我们考虑每秒1000个数据点,使用Redis缓存...
6.2 Sharded Documents:大型项目的智能加载
对于大型文档(如PRD、架构),BMAD支持分片(Sharding):
planning-artifacts/
├── prd/
│ ├── index.md # 目录索引
│ ├── requirements.md # 需求(500-800行)
│ ├── features.md # 功能(600-700行)
│ ├── user-stories.md # 用户故事(800-1000行)
│ └── acceptance-criteria.md # 验收标准(200-300行)
└── architecture/
├── index.md
├── overview.md
├── data-model.md
├── api-design.md
└── security.md
加载策略(从深度探索结果中获得的详细信息):
1. FULL_LOAD策略
<strategy name="FULL_LOAD">
<desc>加载分片目录中所有文件 - 用于PRD、架构、Brownfield文档</desc>
<action>
- 使用glob模式找到所有.md文件
- 按index.md优先,然后字母顺序加载
- 连接所有内容到变量{prd_content}
</action>
</strategy>
2. SELECTIVE_LOAD策略
<strategy name="SELECTIVE_LOAD">
<desc>加载特定分片 - 用于Epics,使用{{epic_num}}变量</desc>
<action>
- 检查分片模式中的模板变量(如{{epic_num}})
- 如果变量未定义,询问用户值或从上下文推断
- 解析模板为具体文件路径
- 加载该特定文件
</action>
<example>用户输入epic-3 → 加载epics/epic-3.md</example>
</strategy>
3. INDEX_GUIDED策略(智能判断)
<strategy name="INDEX_GUIDED">
<desc>加载index.md,分析结构和链接,然后智能加载相关文档</desc>
<mandate>不要偷懒 - 使用最佳判断加载可能相关的文档,即使只有5%的机会</mandate>
<action>
- 加载index.md
- 解析表格、链接、标题
- 分析工作流的目的和目标
- 识别哪些链接文档可能相关
</action>
<example>
如果工作流是关于认证且index显示:
- "Auth Overview" → 加载
- "Payment Setup" → 考虑
- "Deployment" → 加载
</example>
<note>有疑问就加载它 - 上下文很有价值,全面比遗漏关键信息好</note>
</strategy>
关键优势:
- 防止上下文窗口溢出
- 提高文档加载的相关性
- 支持大型项目的渐进式处理
- 智能判断减少不必要的token消耗
6.3 对抗性代码审查:必须找到3-10个问题
BMAD的代码审查不是简单的"代码看起来不错",而是对抗性质量审查:
Perform an ADVERSARIAL Senior Developer code review that finds 3-10 specific problems in every story.
Challenges everything:
- 代码质量
- 测试覆盖率
- 架构合规性
- 安全性
- 性能
NEVER accepts "looks good" - must find minimum issues.
审查维度(从探索结果中获得的):
- 代码质量:命名规范、代码复杂度、重复代码
- 测试覆盖:单元测试、集成测试、E2E测试覆盖率
- 架构合规:是否遵循架构决策、模块化程度
- 安全性:SQL注入、XSS、敏感数据处理
- 性能:查询优化、缓存策略、内存泄漏
Amelia(Dev)的自我挑战:
- 像对抗者一样挑剔自己的代码
- 使用标准列表进行检查
- 提供具体的、可执行的修复建议
- 不接受模糊的"看起来OK"
示例输出:
## 代码审查报告 - Story: 用户认证功能
### 发现的问题(5个)
#### 1. 高:测试覆盖不足(优先级:P0)
**位置**:`src/auth/login.test.ts:15-25`
**问题**:错误场景测试覆盖率为40%,低于80%目标
**影响**:生产环境可能暴露未处理的错误
**建议**:
- 添加网络错误场景测试
- 添加认证失败场景测试
- 添加并发登录测试
#### 2. 中:魔法数字(优先级:P1)
**位置**:`src/auth/login.ts:42`
**问题**:认证失败重试次数硬编码为3
**影响**:难以适应不同网络条件
**建议**:
- 将重试次数提取到配置
- 实现指数退避策略
- 考虑环境变量配置
#### 3. 低:命名不一致(优先级:P2)
**位置**:`src/auth/login.ts:15`
**问题**:函数命名为`validateLogin`但导出为`checkCredentials`
**影响**:降低代码可读性
**建议**:统一命名约定
### 整体评分
- 代码质量:7/10(通过阈值>6)
- 测试覆盖:6/10(未通过阈值>8)
- 架构合规:9/10(通过阈值>8)
**结论**:需要修复高和中优先级问题后才能继续。
6.4 TEA模块:企业级测试架构
ATDD(验收测试驱动开发):
# workflow.yaml
name: "testarch-atdd"
description: "在实现前生成失败的验收测试"
execution_hints:
interactive: false
autonomous: true # 不需要用户输入,自动执行
required_tools:
- read_file
- write_file
- create_directory
Amelia(Dev)在实现前运行ATDD:
- 加载Story规格
- 生成失败的测试(红阶段)
- 提供实现检查清单
- 等待开发使测试通过(绿阶段)
- 运行测试,确保无回归
测试架构设计(从探索结果中获得):
- 功能核心+测试外壳模式:核心逻辑在纯函数中,Playwright夹具处理上下文注入
- 选择性测试:使用
git diff检测更改文件,只运行相关测试 - Sharded执行:并行化测试套件(4个分片)减少执行时间
CI/CD集成(从探索结果中获得):
# Burn-In循环
- 运行更改的测试10次
- 目标:在合并到主分支前冲刷掉不稳定测试
- 自动检测不稳定测试并标记为flaky
# Sharded执行
- 将测试套件分成4个分片
- 每个分片在不同的CI runner上运行
- 总执行时间从40分钟降低到12分钟
# 选择性测试
- 根据更改的文件类型运行特定测试标记
- 标记:@smoke(冒烟)、@auth(认证)、@api(API)
- 避免运行无关测试
6.5 质量门和验证工作流
BMAD在每个关键节点设置质量门:
-
Implementation Readiness Check(
bmad-bmm-check-implementation-readiness):- 验证PRD、UX、架构、Epics/Stories的对齐
- 使用Adversarial Review模式
- 生成就绪性报告
-
Validate Module(
bmad-bmb-validate-module):- 检查模块合规性
- 验证命名约定
- 确保文件结构
-
Validate Workflow(
bmad-bmm-validate-workflow):- 检查工作流完整性
- 验证handler配置
- 测试执行路径
质量门示例:
## 实施就绪性检查报告
### 对齐检查
✅ PRD与架构一致
✅ UX设计符合技术约束
✅ Epic和Story完整覆盖需求
✅ 所有必需文档已生成
### 发现的问题
⚠️ 架构中未定义数据库迁移策略
⚠️ Epic 3缺少验收标准
### 决策
**状态**:有条件通过
**建议**:修复问题后进入Phase 4,或创建Change Proposal跳过某些约束
七、实战案例:从零到部署的完整流程
7.1 初始化项目
# 全局安装BMAD方法
npm install -g bmad-method
# 初始化项目
cd my-awesome-project
npx bmad-method init
# 编辑生成的配置
vim _bmad/bmm/config.yaml
生成配置文件:
# _bmad/bmm/config.yaml
project_name: BMAD-DEMO
user_skill_level: intermediate
planning_artifacts: "{project-root}/_bmad-output/planning-artifacts"
implementation_artifacts: "{project-root}/_bmad-output/implementation-artifacts"
project_knowledge: "{project-root}/docs"
user_name: Asher
communication_language: Chinese
document_output_language: Chinese
output_folder: "{project-root}/_bmad-output"
7.2 Phase 1: 产品简报
# 激活Analyst智能体
/bmad-analyst
# 选择 [CB] Create Brief
引导对话:
Mary(Analyst):欢迎Asher!我是Mary,你的业务分析师。📊
你有什么想法想探索吗?
你:我想做一个AI驱动的项目管理工具
Mary:太好了!🎯 让我们深入了解...
首先,这个工具要解决的核心问题是什么?
A. 团队协作效率低
B. 需求管理混乱
C. 进度跟踪不透明
D. 以上都是
你:D,主要是A和B
Mary:明白了!让我们使用头脑风暴技术生成至少100个创新想法...
[生成100+个想法后]
Mary:现在让我分析这些想法,找出最有潜力的10个...
[分析和排序后]
Mary:现在我们来看看市场格局...
[进行市场研究后]
Mary:最后,让我综合所有发现,创建产品简报...
输出文档:
---
stepsCompleted: [1, 2, 3, 4]
currentStep: 5
workflow: create-product-brief
date: 2026-02-09
project_name: AI-PM-Tool
user_name: Asher
communication_language: Chinese
---
# 产品简报
## 1. 产品愿景
...
## 2. 目标受众
...
## 3. 核心价值主张
...
## 4. 市场分析总结
...
7.3 Phase 2: PRD创建
# 激活PM智能体
/bmad-pm
# 选择 [CP] Create PRD
John(PM)的引导:
John(PM):欢迎Asher!我是John,你的产品经理。📋
我注意到我们已经有了一个完整的产品简报,太好了!
现在让我引导你完成PRD创建过程...
步骤1: 定义产品目标
你:提高团队效率50%
John:好的,已记录。
步骤2: 用户画像分析
你:主要是中小型团队(5-20人)
John:明白了。
步骤3: 功能需求分解
[引导完成详细需求规格]
步骤4: 验收标准
[引导完成验收标准定义]
PRD输出示例:
_bmad-output/planning-artifacts/prd-ai-pm-tool-2026-02-09.md
├── requirements.md(500行)
├── features.md(600行)
├── user-stories.md(800行)
└── acceptance-criteria.md(200行)
7.4 Phase 3: 架构设计
# 激活Architect智能体
/bmad-architect
# 选择 [CA] Create Architecture
Winston(Architect)的引导:
Winston(Architect):欢迎Asher!我是Winston,你的架构师。🏗️
我已经仔细阅读了PRD,现在让我们设计技术架构...
基于PRD的需求,我提出以下技术栈选择:
选项1: Next.js 14 + TypeScript + Prisma + PostgreSQL
选项2: Vue 3 + TypeScript + MongoDB
选项3: React 18 + Express + SQLite
你倾向于哪个?
你:选项1,因为SEO和生态更成熟
Winston:好的,让我详细设计系统架构...
[生成完整架构文档]
关键决策:
- 前端:Next.js 14(App Router、Server Components)
- 后端:Node.js + tRPC(端到端类型安全)
- 数据库:PostgreSQL(ACID事务、全文搜索)
- 部署:Vercel(自动化CI/CD)
- 缓存:Redis(会话、查询缓存)
安全考虑:
- JWT认证 + refreshToken机制
- RBAC(基于角色的访问控制)
- 输入验证和参数化查询
7.5 Phase 4: Sprint开发
# 激活Scrum Master
/bmad-sm
# Sprint Planning
[SP] Sprint Planning - 生成Sprint计划
Bob(Scrum Master)的工作:
Bob(Scrum Master):欢迎Asher!我是Bob,你的Scrum Master。🏃
让我们规划第一个Sprint...
基于架构和PRD,我创建了以下Sprint计划:
Sprint 1(2周):
Epic 1: 用户认证
- Story 1: 用户登录
- Story 2: 用户注册
- Story 3: 密码重置
Epic 2: 项目管理
- Story 1: 创建项目
- Story 2: 分配任务
- Story 3: 更新任务状态
- Story 4: 删除项目
准备好开始开发吗?
你:准备好了
Bob:好!让我创建第一个Story...
Create Story流程:
/bmad-dev
# Dev Story
[CS] Create Story - 准备第一个Story
Amelia(Dev)的工作:
Amelia(Dev):欢迎Asher!我是Amelia,你的开发智能体。💻
我已经读取了Story 1: 用户登录,现在开始实现...
任务分解:
1. 设置Next.js项目结构
2. 安装依赖(prisma、next-auth等)
3. 创建数据库Schema
4. 实现认证API
5. 编写单元测试
6. 集成Prisma Client
正在实现中...
Code Review流程:
/bmad-code-review
# Code Review
[CR] - Story完成后自动触发
对抗性审查结果:
🔍 Code Review报告 - Story: 用户登录
发现的问题(5个):
1. 高:缺少CSRF保护(P0)
位置:src/auth/login.ts:25
建议:在所有mutation中添加CSRF token验证
2. 中:SQL注入风险(P1)
位置:src/auth/auth.service.ts:42
建议:使用参数化查询,避免字符串拼接
3. 低:日志记录敏感信息(P2)
位置:src/auth/login.ts:18
建议:只记录必要的事件,脱敏token
整体评分:7/10(需要修复)
是否继续到下一个Story?
7.6 文档输出位置
所有产出文档都存储在_bmad-output目录:
_bmad-output/
├── planning-artifacts/
│ ├── product-brief-*.md
│ ├── prd/
│ │ ├── index.md
│ │ ├── requirements.md
│ │ └── features.md
│ └── architecture/
│ └── architecture-*.md
└── implementation-artifacts/
├── sprint-status.yaml
├── stories/
│ ├── epic-1-story-1.md
│ ├── epic-1-story-2.md
│ └── epic-1-story-3.md
└── code-reviews/
├── story-1-review.md
└── story-2-review.md
八、BMAD vs传统开发:为什么选择BMAD?
8.1 传统LLM开发的痛点
| 维度 | 传统方式 | BMAD方式 |
|---|---|---|
| 上下文管理 | 单次对话,容易漂移 | Step-File架构,状态持久化 |
| 流程标准化 | 手动提示,不一致 | 强制工作流,质量门 |
| 智能体专业化 | 通用助手,无专业度 | 17个专业智能体,人格锁定 |
| 质量保证 | 依赖用户检查 | 对抗性代码审查,ATDD |
| 协作 | 单智能体对话 | Party Mode多智能体协作 |
| 可追溯性 | 难以恢复中断 | 输出文档frontmatter追踪 |
| 模块化 | 固化框架 | 可扩展模块系统 |
| 测试驱动 | 可选,质量不稳定 | TEA模块企业级测试架构 |
8.2 核心优势总结
- ✅结构化:强制流程合规,不跳过必需步骤,
required=true阻塞进度 - ✅可追溯:每步都有记录,中断后可恢复,
stepsCompleted数组追踪 - ✅协作:Party Mode多智能体协作,自然对话,智能选择最相关专家
- ✅质量:对抗性代码审查(必须找到3-10个问题),ATDD红-绿循环
- ✅灵活:模块化架构,可定制智能体和工作流,
.customize.yaml覆盖人格 - ✅测试驱动:TEA模块提供企业级测试架构,NFR评估,覆盖率追溯
- ✅文档化:自动化文档生成,输出模板,分片管理大文档
- ✅ 开源:MIT License,完全免费,社区驱动
8.3 适用场景
BMAD非常适合:
- 中小型团队(2-10人)需要结构化流程
- 全栈开发者或小团队需要"企业级"质量
- Brownfield项目(现有代码库)需要文档化和改造
- 创新型项目(需要探索多个创意方向)
- 企业级项目(需要严格的QA和合规流程)
BMAD可能不适合:
- 单次性的快速脚本(用Quick Flow)
- 超小型团队(1-2人)的简单项目
- 已有完善CI/CD的大型项目
九、如何开始使用BMAD?
9.1 快速开始(3分钟)
# 1. 全局安装
npm install -g bmad-method
# 2. 初始化项目
cd my-project
npx bmad-method init
# 3. 配置(编辑生成的config.yaml)
# 主要设置:
project_name: 你的项目名
user_name: 你的名字
communication_language: zh # 中文
# 4. 安装模块(可选)
npm install bmad-creative-intelligence-suite # 创意智能
npm install bmad-method-test-architecture-enterprise # 测试架构
# 5. 开始使用
/bmad-help # 获取帮助
9.2 安装扩展模块
CIS模块(创意智能):
npm install bmad-creative-intelligence-suite
提供的工作流:
- Design Thinking:人本设计流程
- Innovation Strategy:商业模式创新
- Problem Solving:系统性问题解决
- Storytelling:说服性叙事
TEA模块(测试工程):
npm install bmad-method-test-architecture-enterprise
提供的能力:
- ATDD:验收测试驱动开发
- 测试设计:基于风险的测试规划
- NFR评估:非功能需求评估
- CI/CD脚手架:自动化流水线
9.3 第一个工作流
# 激活Analyst智能体
/bmad-analyst
# 选择 [CB] Create Brief
9.4 随时获取帮助
# 随时获取下一步建议
/bmad-help
# 结合你的需求
/bmad-help 我想做一个电商网站,应该从哪里开始?
# Party Mode
/bmad-party-mode
十、进阶使用技巧
10.1 自定义智能体
创建.customize.yaml文件覆盖默认人格和行为:
# _bmad/_config/agents/analyst.customize.yaml
persona:
communication_style: "更简洁直接,减少感叹号,使用数据驱动分析"
principles:
- "重点使用量化指标和可验证数据"
- "减少理论框架引用,增加实践案例"
- "提供可操作的建议,而非泛泛而谈"
10.2 Brownfield项目
# 文档化现有项目
/bmad-document-project
Mary(Analyst)将扫描代码库:
- 识别架构模式
- 提取编码约定
- 生成项目上下文文档(project-context.md)
输出:
docs/
├── project-context.md # LLM优化的项目上下文
└── architecture-scan.md # 架构扫描结果
10.3 Quick Flow(快速开发)
对于简单任务,跳过完整规划:
# 快速规格
/bmad-quick-spec
# 快速开发
/bmad-quick-dev
Barry(Quick Flow)会:
- 分析代码库
- 生成技术规格
- 独立实现
- 自动测试(如果有框架)
10.4 反模式(Anti-Patterns)
从探索结果中获得的最佳实践:
❌ 避免:E2E测试用于API逻辑
- 理由:E2E慢、不稳定、不适合单元测试
- 推荐:使用单元测试 + 集成测试
❌ 避免:信息密度过低
- 理由:文档填充内容,浪费token
- 推荐:保持高信息密度,每行都有价值
❌ 避免:硬等待
- 理由:
sleep()阻塞测试 - 推荐:使用事件驱动或Promise等待
❌ 避免:魔法数字
- 理由:硬编码常量、重试次数
- 推荐:提取到配置文件
十一、社区与资源
11.1 官方资源
-
GitHub仓库:github.com/bmad-code-o…
- 65个工作流
- 17个专业智能体
- 完整文档
- 实时更新
-
- Getting Started指南
- Brownfield开发
- 自定义指南
- 工作流地图
-
Discord社区:discord.gg/gk8jAdXWmj
- 实时讨论
- 问题支持
- 分享经验
-
工作流地图:Workflow Map
- 可视化所有工作流
- 了解Phase间依赖关系
11.2 实战案例
-
Websoft9项目:websoft9/websoft9
- 完整的BMAD使用示例
- 展示Phase 1-4的完整流程
- 包含实际输出文档
-
Prompt Optimizer:linshenkx/prompt-optimizer
- 使用BMAD构建的提示词优化工具
- 展示如何与AI工具集成
11.3 学习路径
初学者路径(1-2周):
- Getting Started:从产品简报到PRD的完整流程
- 基础开发:完成一个Epic,体验Story循环
进阶路径(3-4周): 3. Brownfield:将BMAD应用于现有代码库 4. Advanced:Party Mode协作、TEA测试架构 5. Contribution:参与开源社区,贡献模块和工作流
十二、总结
BMAD不仅仅是一套工具或框架,它是一种全新的AI原生软件开发范式。通过:
- 📊 模块化架构:灵活、可扩展的四大模块(Core、BMM、BMB、CIS、TEA)
- 🔄 Step-File工作流:防止LLM漂移,确保质量的微文件设计
- 👥 17个专业智能体:人格锁定、专业能力、协同工作
- 🎯 四阶段生命周期:从Analysis → Planning → Solutioning → Implementation的完整SDLC
- 🎉 Party Mode:多智能体自然对话,智能协作
- ✅ 质量保证:对抗性代码审查、ATDD、NFR评估
- 📚 自动化文档:输出模板、分片管理、状态追踪
- 🚀 可扩展:自定义智能体、创建工作流、贡献模块
它将LLM从"聊天机器人"转变为"专业开发团队",让个人开发者或小团队也能拥有企业级的开发质量和效率。
核心价值主张:
"AI不会取代开发者,但会用BMAD的开发者会取代不会用BMAD的开发者。"
附录
A. 快速参考表
BMM核心开发流程
| 命令 | 智能体 | 描述 | 输出 |
|---|---|---|---|
| /bmad-analyst | Mary 📊 | 研究文档 | |
| /bmad-pm | John 📋 | PRD | |
| /bmad-architect | Winston 🏗️ | 架构文档 | |
| /bmad-sm | Bob 🏃 | Sprint计划 | |
| /bmad-dev | Amelia 💻 | Story实现 | |
| /bmad-code-review | Amelia 💻 | 审查报告 | |
| /bmad-party-mode | BMAD Master | 多智能体协作 | |
| /bmad-help | BMAD Master | 路由建议 | |
| /bmad-document-project | Mary 📊 | 项目文档 |
CIS & Core模块
| 命令 | 智能体 | 描述 | 输出 |
|---|---|---|---|
| /bmad-party-mode | BMAD Master | 多智能体协作 | |
| /bmad-help | BMAD Master | 路由建议 |
Quick Flow
| 命令 | 智能体 | 描述 | 输出 |
|---|---|---|---|
| /bmad-quick-spec | Barry 🚀 | 快速规格 | |
| /bmad-quick-dev | Barry 🚀 | 快速开发 |
B. 推荐IDE和工具
- Claude Code:原生BMAD集成,推荐首选
- Open Code:开源工具,社区活跃,配置灵活
- Cursor:支持BMAD工作流,AI原生
- VS Code:配合Markdown插件和AI扩展
- Windsurf:AI驱动IDE,支持BMAD