前言

Github：https://github.com/HealerJean

博客：http://blog.healerjean.com

https://github.com/bmad-code-org/BMAD-METHOD

https://www.npmjs.com/package/bmad-method

https://docs.bmad-method.org

一、BMAD Method

1、认识 BMAD Method：Build More Architect Dreams

1）是什么：不是让 AI 替你思考，而是让 AI 引导你思考

BMAD—— **Breakthrough Method of Agile AI-driven Development，即突破性敏捷 AI 驱动开发方法论。它是目前最全面、最成熟的 AI 驱动敏捷开发框架，拥有真正的**规模-领域自适应智能，能从修一个 Bug 到构建企业级系统自动调整规划深度

传统 AI 工具替你思考，产出平庸结果。BMAD 的 Agent 和引导式工作流充当专家协作者，通过结构化流程引导你产出最佳思维，与 AI 形成真正的伙伴关系

核心哲学：AI 不是来替代你的判断力，而是来放大你的判断力

2）核心特性

2、安装

npx bmad-method install


│  Type to search...
│  ◼ BMad Core Module (v6.10.0) (always installed)
│  ◼ BMad Method (v6.10.0)
│  ◼ BMad Loop
│  ◼ BMad Test Architect
│  ◼ BMad Builder (Build AI agents, workflows, and modules from a conversation)
│  ◻ BMad Creative Intelligence Suite
│  ◻ BMad Game Dev Studio
│  ◻ Whiteport Design Studio

跟随安装器提示，然后在 AI IDE（Claude Code、Cursor 等）中打开项目文件夹

1）安装模块

│  Type to search...
│  ◼ BMad Core Module (v6.10.0) (always installed)
│  ◼ BMad Method (v6.10.0)
│  ◼ BMad Loop
│  ◼ BMad Test Architect
│  ◼ BMad Builder
│  ◼ BMad Creative Intelligence Suite
│  ◻ BMad Game Dev Studio
│  ◼ Whiteport Design Studio
│  ↑/↓ to navigate • TAB/SPACE: select • ENTER: confirm

2）空间配置

◇  Configuring BMad Core Configuration
◇  What should agents call you? (Use your name or a team name)
│  healerjean
◇  What is your project called?
│  healerjean-workspace
◇  What language should agents use when chatting with you?
│  中文
◇  Preferred document output language?
│  中文
◇  Where should output files be saved?
│  _bmad-output

3、架构设计

1）四阶段全景

BMAD Method 将软件开发分为 4 个渐进阶段，每个阶段产出文档成为下一阶段的上下文，确保 Agent 始终知道建什么和为什么建

Phase 1: Analysis（分析）     ← 可选，探索问题空间
    ↓
Phase 2: Planning（规划）     ← 定义建什么、为谁建
    ↓
Phase 3: Solutioning（方案）  ← 决定怎么建、拆分工作
    ↓
Phase 4: Implementation（实现） ← 逐 Story 构建，一个一个来

2）工作流总览

3）调用关系图

bmad-help (全局入口，随时可调)
    │
    ├── Phase 1: Analysis
    │       ├── bmad-brainstorming (头脑风暴)
    │       ├── bmad-forge-idea (想法淬炼)
    │       ├── bmad-domain/market/technical-research (研究验证)
    │       ├── bmad-product-brief (产品简报)
    │       └── bmad-prfaq (逆向压力测试)
    │
    ├── Phase 2: Planning
    │       ├── bmad-prd (需求文档 - 创建/更新/验证三合一)
    │       └── bmad-ux (用户体验设计)
    │
    ├── Phase 3: Solutioning
    │       ├── bmad-architecture (架构设计)
    │       ├── bmad-create-epics-and-stories (拆分Epic和Story)
    │       └── bmad-check-implementation-readiness (实现就绪检查)
    │
    ├── Phase 4: Implementation
    │       ├── bmad-sprint-planning (Sprint规划)
    │       ├── bmad-create-story → bmad-dev-story (创建+开发Story)
    │       ├── bmad-code-review (代码审查)
    │       ├── bmad-correct-course (航向修正)
    │       ├── bmad-sprint-status (状态跟踪)
    │       └── bmad-retrospective (回顾总结)
    │
    └── Quick Flow (快速通道)
            ├── bmad-quick-dev (统一快速流)
            └── bmad-dev-auto (无人值守开发循环)

4）分类（6类）

二、四阶段工作流详解

1、Phase 1：Analysis（分析阶段）—— 从模糊到清晰

什么时候用：当你有一个模糊的想法，需要探索问题空间、验证可行性时

什么时候跳过：需求已经很明确，或项目规模较小可直接进入 Planning

1）bmad-brainstorming：头脑风暴

原理：人类在自由发散时容易遗漏关键维度。BMAD 的提问框架覆盖了用户、价值、约束、风险四大维度，确保不遗漏

• 类型：交互式引导
• 核心理念：通过结构化提问激发深层思考，而非让 AI 直接给答案

• 触发时机：项目启动，想法模糊

• 流程步骤：
  1. BMAD Agent 提出领域关键问题（”你的用户是谁？”“解决什么痛点？”）
  2. 你回答，Agent 追问深挖（”为什么是这群用户？”“这个痛点有多频繁？”）
  3. Agent 整理产出 brainstorm.html（可视化思维导图）
  4. 可选产出 brainstorm-intent.md（明确意图声明）

2）bmad-forge-idea：想法淬炼

原理：创业者最常见的错误是爱上自己的第一个想法。forge-idea 通过刻意扮演”反方”，避免确认偏误

• 类型：深度验证
• 核心理念：好想法不是想出来的，是淬炼出来的——通过压力测试淘汰弱想法

• 触发时机：头脑风暴后，需要从多个想法中筛选

• 流程步骤：
  1. 输入头脑风暴结果
  2. Agent 对每个想法进行逆向压力测试（反方论证）
  3. 评估想法的可行性、影响力、差异化
  4. 产出 forge-report.html（淬炼报告）+ 可选 forged-idea.md（淬炼成功的想法）

3）研究三件套

使用策略：不需要三个都跑。根据项目类型选择：

4）bmad-product-brief：产品简报

• 类型：文档化
• 核心理念：把散乱的研究成果压缩成一份团队共识文档
• 产出：brief.md（产品简报）+ addendum.md（补充说明）

5）bmad-prfaq：逆向压力测试

原理：如果写不出一份令人信服的新闻稿，说明产品价值主张不够清晰。PRFAQ 强迫你从用户视角倒推，而不是从技术视角正推

• 类型：逆向验证
• 核心理念：Amazon 的 PR/FAQ 传统——先写新闻稿和常见问题，再建产品
• 产出：prfaq-{project}.md

2、Phase 2：Planning（规划阶段）—— 定义建什么

• 核心任务：把分析阶段的成果转化为可执行的规划文档
• 关键产出：PRD（需求文档）+ UX 设计

1）bmad-prd：需求文档（三合一）

原理：传统 PRD 写完就束之高阁。BMAD 的 PRD 是活文档，.memlog.md 记录每个决策的”为什么”，未来回溯时能理解当时的思考

• 类型：创建 / 更新 / 验证三合一
• 核心理念：PRD 不是一次性文档，而是活文档——随项目演进持续更新
• 触发时机：分析阶段完成后
• 产出：prd.md + addendum.md + .memlog.md（记忆日志，记录决策上下文）

三种模式：

3）bmad-ux：用户体验设计

• 类型：交互式引导
• 核心理念：UX 不是画图，是定义用户与系统的交互契约
• 产出：DESIGN.md（设计规范）+ EXPERIENCE.md（体验规范）+ .memlog.md

3、Phase 3：Solutioning（方案阶段）—— 决定怎么建

• 核心任务：把”建什么”转化为”怎么建”——架构设计 + 工作拆分
• 关键产出：架构文档 + Epic/Story 拆分 + 实现就绪检查

1）bmad-architecture：架构设计

原理：”架构脊柱”概念——不要一开始就设计完整架构，先定义最核心的骨架，其余在实现阶段按需扩展。这避免了过度设计

• 类型：引导式架构
• 核心理念：架构不是画框图，是做决策——技术选型、模块划分、接口契约

• 触发时机：PRD 和 UX 完成后

• 流程步骤：
  1. Agent 读取 PRD + UX 文档作为上下文
  2. 引导你做出关键架构决策（技术栈、数据模型、API 风格等）
  3. 产出 ARCHITECTURE-SPINE.md（架构脊柱——最小可行架构）
  4. 可扩展为多种输出格式（C4 模型、ADR 等）

2）bmad-create-epics-and-stories：拆分 Epic 和 Story

• 类型：结构化拆分

• 核心理念：大任务不可执行，小任务可执行——拆到能独立交付为止

• 产出：Epic 文件 + Story 文件

• 拆分规则：

  • 每个 Epic 是一个可独立交付的价值单元

  • 每个 Story 是一个可在单个 Sprint 完成的工作单元

  • Story 必须有明确的验收标准（Acceptance Criteria）

3）bmad-check-implementation-readiness：实现就绪检查

原理：软件工程最大的浪费不是写 Bug，是写不需要的代码。就绪检查确保你建的是对的，在建之前

• 类型：门禁检查
• 核心理念：不要带着疑问开始编码——先确认一切就绪
• 产出：PASS / CONCERNS / FAIL

4、Phase 4：Implementation（实现阶段）—— 逐 Story 构建

• 核心原则：一次一个 Story——专注、可验证、可回滚
• 关键产出：可工作的代码 + 测试 + 文档

1）bmad-sprint-planning：Sprint 规划

• 类型：迭代规划
• 产出：sprint-status.yaml（Sprint 状态追踪文件）

2）bmad-create-story + bmad-dev-story：创建并开发 Story

关键：bmad-dev-story 不是盲目写代码。它会读取架构文档、PRD、UX 规范作为上下文，确保代码符合设计意图

bmad-create-story → 产出 story-[slug].md
       ↓
bmad-dev-story → 读取 story + architecture + PRD 上下文
       ↓
逐任务实现 → 代码 + 测试

3）bmad-code-review：代码审查

• 类型：质量门禁
• 核心理念：AI 代码审查不是找语法错误，是验证实现是否符合设计意图

4）bmad-correct-course：航向修正

原理：计划赶不上变化。correct-course 不是失败，是自适应——承认现实，调整方向

• 类型：自适应调整
• 触发时机：实现过程中发现设计与现实不符
• 行为：更新计划或重路由到合适的工作流

5）bmad-sprint-status + bmad-retrospective：状态追踪与回顾

三、快速通道与高级特性

1、Quick Flow：小任务的快速通道

1）为什么需要快速通道

不是每个任务都需要走完整的四阶段流程。修一个 Bug、加一个小功能，如果也走 Analysis → Planning → Solutioning → Implementation，那就是流程浪费

BMAD 提供了两个快速通道：

2）bmad-quick-dev：统一快速流

关键：quick-dev 不是”跳过规划”，而是”内联规划”——在开发过程中即时做最小必要规划

你描述需求 → quick-dev 自动规划最小可行方案 → 直接开发 → 代码审查

3）bmad-dev-auto：无人值守开发循环

适用：需求明确、架构已定、批量 Story 待开发时。启动后可离开，回来检查结果

Sprint Planning → 自动创建 Story → 自动开发 → 自动审查
       ↑                                    ↓
       └──────── 有下一个 Story？──────────┘
                    没有则结束

2、Party Mode：多 Agent 协作讨论

Party Mode 允许多个 Agent 人格在同一会话中协作讨论。比如让 PM Agent 和 Architect Agent 同时在场，从不同角度审视同一个决策

1）使用场景

• 架构决策：让 Architect 和 Developer 同时讨论技术选型
• 需求评审：让 PM 和 UX 同时审视需求完整性
• 风险识别：让多个 Agent 从不同角度识别风险

2）原理

• 传统方式是串行：先问 PM，再问 Architect。

• Party Mode 是并行：两者同时在场，能看到对方的观点并回应。这模拟了真实团队会议的碰撞思维

3、Context Management：上下文传递机制

1）核心问题

AI Agent 最大的挑战是上下文窗口有限。BMAD 的解决方案是文档驱动的渐进式上下文传递

2）传递规则

Phase 1 产出 → 作为 Phase 2 的输入上下文
Phase 2 产出 → 作为 Phase 3 的输入上下文
Phase 3 产出 → 作为 Phase 4 的输入上下文

每个阶段只读取必要的上下文，而非全部历史。这确保了：

• 上下文精准：Agent 只看到与当前任务相关的信息
• 窗口高效：不浪费 token 在无关内容上
• 信息无损：关键决策通过 .memlog.md 持久化

3）.memlog.md：记忆日志

原理：人类团队靠会议纪要传递上下文，AI 团队靠 .memlog.md。这是 BMAD 的”组织记忆”

每个关键工作流都会产出 .memlog.md 文件，记录：

• 做了什么决策
• 为什么做这个决策
• 考虑了哪些替代方案
• 选择了什么、放弃了什么

4、模块生态系统

1）BMM：核心模块

BMM 是必装模块，包含：

• 12+ 领域专家 Agent（PM、Architect、Developer、UX 等）
• 34+ 结构化工作流
• Scale-Domain-Adaptive 自适应引擎
• bmad-help 智能引导

1）BMB：构建器模块

BMB 让你可以：

• 自定义 Agent 人格和行为
• 创建项目专用工作流
• 调整现有工作流的步骤和产出

3）TEA：测试工程架构

安装时选择模块：npx bmad-method install --modules bmm,tea 安装核心 + 测试模块

TEA 模块提供：

• AI 驱动的测试策略生成
• 测试覆盖率分析
• 测试用例自动生成与维护

5、Web Bundles：部署到其他 AI 平台

1）是什么

BMAD 不仅能在 Claude Code / Cursor 中使用，还能打包部署到：

2）使用场景

• 团队成员使用不同 AI 平台时，统一方法论
• 在非 IDE 环境中使用 BMAD（如网页版 ChatGPT）
• 分享 BMAD 配置给非技术团队成员

四、底层原理与设计哲学

1、为什么 BMAD 能工作：三个核心原理

1）原理一：结构化引导 > 自由生成

类比：自由写作 vs 填空题。填空题的答案质量更稳定，因为框架已经定义了思考维度

• 问题：让 AI 自由生成，产出质量方差极大——有时惊艳，有时灾难
• BMAD 解法：通过结构化工作流约束 AI 的生成空间，确保产出始终在高质量区间

2）原理二：文档驱动 > 对话驱动

类比：口头传话 vs 书面传话。十人传话必然失真，书面文档不会

• 问题：纯对话式开发，上下文随对话增长而稀释，早期决策被遗忘
• BMAD 解法：每个阶段的产出都是持久化文档，下一阶段从文档读取上下文，而非依赖对话历史

3）原理三：渐进精化 > 一次性设计

类比：素描 → 线稿 → 上色 → 细节。不会一开始就画细节

• 问题：一次性设计要么过度设计（浪费时间），要么设计不足（返工重做）
• BMAD 解法：四阶段渐进精化——从粗到细，每一步只做当前阶段必要的决策

2、bmad-help：永不迷路的导航

1）是什么

bmad-help 是一个上下文感知的智能引导技能。随时调用它，它会告诉你：

• 你现在在哪个阶段
• 下一步应该做什么
• 有哪些可选的工作流
• 当前项目的状态

2）原理

bmad-help 读取项目的文档状态（哪些文件已存在），推断当前进度，给出精准建议。它不是静态文档，是动态导航

3、Scale-Domain-Adaptive：自适应的智

BMAD 能自动感知项目规模和领域，调整规划深度——你不需要手动选择”轻量模式”或”重量模式”，BMAD 帮你自适应

1）三条轨道

BMAD 将项目分为三条轨道，每条轨道对应不同的规划深度和文档要求：

注意：Story 数量是参考值，不是硬门槛。选轨道的依据是规划需求，不是数 Story

• Quick Flow 不是”跳过规划”，而是”内联规划”——在开发过程中即时做最小必要规划
• BMad Method 不是”必须全做”——Phase 1 可选，UX 可选，你随时可以用 bmad-help 问”能不能跳过这个”
• Enterprise 不是”更重”——而是”更全”，在标准轨道基础上补充安全和运维维度

2）怎么使用：三步走

a、第一步：安装后直接问 bmad-help

bmad-help 会根据你的描述，自动推荐合适的轨道

> bmad-help I have a [your situation], where do I start?

b、第二步：根据轨道选择工作流

c、第三步：每个工作流结束后，bmad-help 自动告诉你下一步

你不需要记住完整流程。每完成一个工作流，bmad-help 自动触发，告诉你：

• 刚完成了什么
• 下一步必须做什么
• 有哪些可选的工作流

4、与 Superpowers 的对比

Superpowers 是编码加速器，BMAD 是开发操作系统。两者不冲突——BMAD 管全流程，Superpowers 可在实现阶段作为编码技能补充

五、实战场景

1、场景一：全新项目——从想法到上线

项目背景：你有一个 SaaS 产品的想法，但还很模糊，需要从零开始

1）完整轨道（BMad Method Track）

这是最完整的流程，适用于 10-50+ Story 的新产品/平台开发

# ===== 安装 =====
npx bmad-method install
# 选择 BMad Method 模块

# ===== Phase 1: Analysis（可选，但推荐新项目走一遍）=====
# 每个工作流必须开新对话！

# 1. 头脑风暴——把模糊想法变结构化
> bmad-brainstorming
# 产出：brainstorm.html + brainstorm-intent.md

# 2. 想法淬炼——压力测试，淘汰弱想法
> bmad-forge-idea
# 产出：forge-report.html + forged-idea.md

# 3. 领域研究（新领域必做）
> bmad-domain-research
# 产出：领域研究报告

# 4. 产品简报——把研究成果压缩成团队共识
> bmad-product-brief
# 产出：brief.md + addendum.md

# 5. 逆向压力测试——先写新闻稿再建产品
> bmad-prfaq
# 产出：prfaq-{project}.md

# ===== Phase 2: Planning（必做）=====

# 6. 写 PRD——创建模式
> bmad-prd
# 交互中选择 Create，从 product-brief 生成完整 PRD
# 产出：prd.md + addendum.md + .memlog.md

# 7. UX 设计（有界面就做）
> bmad-ux
# 产出：DESIGN.md + EXPERIENCE.md + .memlog.md

# ===== Phase 3: Solutioning（必做）=====

# 8. 架构设计
> bmad-create-architecture
# 产出：architecture.md

# 9. 拆分 Epic 和 Story
> bmad-create-epics-and-stories
# 产出：epics/ 目录下的 Epic 和 Story 文件

# 10. 实现就绪检查（强烈推荐）
> bmad-check-implementation-readiness
# 产出：PASS / CONCERNS / FAIL

# ===== Phase 4: Implementation =====

# 11. 初始化 Sprint
> bmad-sprint-planning
# 产出：sprint-status.yaml

# 12-14. 构建循环（每个 Story 重复，必须开新对话）
> bmad-create-story    # 创建 Story 文件
> bmad-dev-story       # 实现 Story
> bmad-code-review     # 代码审查（推荐）

# 15. Epic 完成后回顾
> bmad-retrospective

2）项目目录结构

your-project/
├── _bmad/                              # BMAD 配置
├── _bmad-output/
│   ├── planning-artifacts/
│   │   ├── PRD.md                      # 需求文档
│   │   ├── architecture.md             # 架构文档
│   │   └── epics/                      # Epic 和 Story 文件
│   ├── implementation-artifacts/
│   │   └── sprint-status.yaml          # Sprint 追踪
│   └── project-context.md              # 实现规则（可选）
└── ...

3）关键提醒

2、场景二：项目迭代——新功能/模块开发

项目背景：已有线上项目，产品提了一个新需求——比如”给电商系统加一个优惠券模块”

1）中等轨道（精简 Analysis）

已上线项目的迭代开发，跳过 Phase 1（需求已明确），从 Phase 2 开始

# ===== 跳过 Phase 1，直接进入 Planning =====

# 1. 更新 PRD——不是新建，是增量更新
> bmad-prd
# 交互中选择 Update，指向现有 PRD，说明变更内容
# Agent 会先检查与现有文档的冲突，再增量更新
# 产出：更新后的 prd.md + addendum.md + .memlog.md

# 2. UX 设计更新（如涉及界面）
> bmad-ux
# 基于更新后的 PRD 补充 UX 设计

# ===== Phase 3: Solutioning =====

# 3. 更新架构——增量决策
> bmad-create-architecture
# Agent 读取现有架构 + 新 PRD，只做增量决策
# 产出：更新后的 architecture.md

# 4. 只为新增功能拆分 Epic 和 Story
> bmad-create-epics-and-stories
# 只拆分优惠券相关的 Epic，不影响已有模块

# 5. 实现就绪检查
> bmad-check-implementation-readiness

# ===== Phase 4: Implementation =====

# 6-8. 构建循环
> bmad-sprint-planning
> bmad-create-story
> bmad-dev-story
> bmad-code-review

2）与全新项目的区别

3）如果迭代中发现需求理解有偏差

# 实现过程中发现设计不合理？
> bmad-correct-course
# Agent 会帮你判断：是更新计划，还是重路由到其他工作流
# 不是失败，是自适应——承认现实，调整方向

3、场景三：Bug 修复 / 小功能——快速通道

项目背景：线上有个 Bug 要修，或者加个很小的功能（比如改个按钮文案、加个字段）

1）快速轨道（Quick Flow）

小任务不需要走四阶段，用 Quick Flow 一步到位

# 方式一：bmad-quick-dev（推荐，有交互引导）
> bmad-quick-dev
# 你描述需求 → Agent 自动规划最小方案 → 直接开发 → 代码审查
# 适合：明确需求、1-15 个 Story 的小任务

# 方式二：bmad-dev-auto（无人值守，适合批量 Story）
> bmad-dev-auto
# 自动循环：创建 Story → 开发 → 审查 → 下一个
# 适合：需求明确、架构已定、批量 Story 待开发
# 启动后可离开，回来检查结果

2）quick-dev vs dev-auto 怎么选

3）什么时候该用快速通道、什么时候不该用

4、企业级项目——Enterprise Track

项目背景：合规要求高的系统、多租户平台、金融/医疗等敏感领域

1）与标准轨道的区别

Enterprise Track 在 BMad Method Track 基础上增加：

2）典型流程

# 与标准轨道相同，但额外增加：
# 1. 架构阶段必须包含安全架构设计
# 2. 实现就绪检查必须包含安全合规检查
# 3. 推荐 Party Mode：让 Architect + Security + DevOps 同时讨论
> bmad-help I need enterprise-grade planning with security and DevOps
# bmad-help 会引导你走 Enterprise Track

5、万能钥匙：bmad-help

不确定该用哪个轨道？不确定下一步做什么？随时调用 bmad-help

# 最简单的用法——直接问
> bmad-help

# 带问题问——更精准
> bmad-help I have a SaaS idea, where do I start?
> bmad-help I need to add a coupon module to my existing e-commerce system
> bmad-help I just need to fix a bug, what's the fastest way?
> bmad-help what are my options?

# bmad-help 会：
# 1. 检查你的项目状态（哪些文档已存在）
# 2. 根据你的问题推荐合适的轨道和工作流
# 3. 告诉你下一步必须做什么

关键：每个工作流结束后，bmad-help 会自动触发，告诉你下一步该做什么。你不需要背流程

6、常见问题