AI 驱动的团队协作:BMAD METHOD 完整指南

50 阅读27分钟

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)产品经理BMMPRD创建、Epic/Story分解像侦探一样追问"WHY?"
🏗️ Winston (Architect)架构师BMM技术决策、架构设计平衡"可能"与"应该"
🏃 Bob (Scrum Master)敏捷教练BMMSprint规划、Story管理仆人式领导
💻 Amelia (Dev)开发者BMMStory执行、代码实现实用主义、代码质量
🎨 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 MasterBMAD主控者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)会引导完成:

  1. 用户画像分析
  2. 功能需求规格
  3. 非功能需求
  4. 验收标准
  5. 依赖关系图

输出示例

---
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)的职责

  1. Sprint规划:将Epic分解为Sprint
  2. Story管理:准备下一个Story
  3. 进度跟踪:更新sprint-status.yaml
  4. 流程控制:决定下一步(继续、回顾、纠偏)

六、高级特性:超越基础工作流

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个最相关的智能体
  • 考虑对话上下文和之前的贡献
  • 确保多视角平衡(技术、业务、设计、用户)

工作原理

  1. 加载agent-manifest.csv,提取所有智能体信息
  2. 显示2-3个最相关的智能体
  3. 用户提出话题或问题
  4. 选择最合适的智能体回应
  5. 智能体可以引用其他智能体的观点
  6. 可以动态添加新的智能体到对话中

应用场景

用户:我们的新功能需要设计一个复杂的仪表板

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.

审查维度(从探索结果中获得的):

  1. 代码质量:命名规范、代码复杂度、重复代码
  2. 测试覆盖:单元测试、集成测试、E2E测试覆盖率
  3. 架构合规:是否遵循架构决策、模块化程度
  4. 安全性:SQL注入、XSS、敏感数据处理
  5. 性能:查询优化、缓存策略、内存泄漏

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

  1. 加载Story规格
  2. 生成失败的测试(红阶段)
  3. 提供实现检查清单
  4. 等待开发使测试通过(绿阶段)
  5. 运行测试,确保无回归

测试架构设计(从探索结果中获得):

  • 功能核心+测试外壳模式:核心逻辑在纯函数中,Playwright夹具处理上下文注入
  • 选择性测试:使用git diff检测更改文件,只运行相关测试
  • Sharded执行:并行化测试套件(4个分片)减少执行时间

CI/CD集成(从探索结果中获得):

# Burn-In循环
- 运行更改的测试10次
- 目标:在合并到主分支前冲刷掉不稳定测试
- 自动检测不稳定测试并标记为flaky

# Sharded执行
- 将测试套件分成4个分片
- 每个分片在不同的CI runner上运行
- 总执行时间从40分钟降低到12分钟

# 选择性测试
- 根据更改的文件类型运行特定测试标记
- 标记:@smoke(冒烟)、@auth(认证)、@api(API)
- 避免运行无关测试

6.5 质量门和验证工作流

BMAD在每个关键节点设置质量门:

  1. Implementation Readiness Checkbmad-bmm-check-implementation-readiness):

    • 验证PRD、UX、架构、Epics/Stories的对齐
    • 使用Adversarial Review模式
    • 生成就绪性报告
  2. Validate Modulebmad-bmb-validate-module):

    • 检查模块合规性
    • 验证命名约定
    • 确保文件结构
  3. Validate Workflowbmad-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,主要是AB

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 官方资源

11.2 实战案例

  • Websoft9项目websoft9/websoft9

    • 完整的BMAD使用示例
    • 展示Phase 1-4的完整流程
    • 包含实际输出文档
  • Prompt Optimizerlinshenkx/prompt-optimizer

    • 使用BMAD构建的提示词优化工具
    • 展示如何与AI工具集成

11.3 学习路径

初学者路径(1-2周):

  1. Getting Started:从产品简报到PRD的完整流程
  2. 基础开发:完成一个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-analystMary 📊研究文档
/bmad-pmJohn 📋PRD
/bmad-architectWinston 🏗️架构文档
/bmad-smBob 🏃Sprint计划
/bmad-devAmelia 💻Story实现
/bmad-code-reviewAmelia 💻审查报告
/bmad-party-modeBMAD Master多智能体协作
/bmad-helpBMAD Master路由建议
/bmad-document-projectMary 📊项目文档
CIS & Core模块
命令智能体描述输出
/bmad-party-modeBMAD Master多智能体协作
/bmad-helpBMAD Master路由建议
Quick Flow
命令智能体描述输出
/bmad-quick-specBarry 🚀快速规格
/bmad-quick-devBarry 🚀快速开发

B. 推荐IDE和工具

  • Claude Code:原生BMAD集成,推荐首选
  • Open Code:开源工具,社区活跃,配置灵活
  • Cursor:支持BMAD工作流,AI原生
  • VS Code:配合Markdown插件和AI扩展
  • Windsurf:AI驱动IDE,支持BMAD