BMAD 实战指南：让 AI 成为你的敏捷开发团队

从 Bug 修复到企业级系统，让 AI 按照软件工程最佳实践为你工作

快速了解 BMAD

BMAD = Breakthrough Method of Agile AI-Driven Development（敏捷 AI 驱动开发的突破性方法）

GitHub 32,000+ Star 开源项目 | 通过 AI 智能体协作实现工程化开发

一句话说清楚

传统 AI 工具：你让 AI 写代码 → AI 直接给结果 → 质量不稳定

BMAD 方式：你做决策 → AI 引导流程 → 生成文档 → 生成代码 → 审查质量

核心差异：BMAD 不是全自动工具，而是"智能项目教练 + 专家团队"，引导你完成软件开发的每个环节。

为什么需要 BMAD？

现实挑战

使用传统 AI 编程工具时，你是否遇到过：

❌ AI 缺乏工程思维 - 修复一个 Bug 引入三个新 Bug，前后逻辑不一致 ❌ 质量不可控 - AI 说代码没问题，上线就崩 ❌ 复杂项目力不从心 - 简单功能还行，复杂系统就出错 ❌ 流程缺失 - 想到哪做到哪，没有文档和测试

BMAD 的解决方案

✅ 21 个专业 AI Agent - PM、Architect、DEV、QA 等角色协作 ✅ 文档优先机制 - 先写 PRD 和架构设计，确保前后一致 ✅ 对抗性审查 - AI 主动找问题，多角度检查代码质量 ✅ 规模自适应 - Bug 修复 10 分钟，企业系统按完整流程

真实效果

BMAD 适合谁？

独立开发者 - 一个人做全栈，需要专业团队协作

小型团队 - 资源有限，想要提升效率和质量

AI 工具用户 - 用过 Claude/Cursor，但质量不稳定

技术决策者 - 评估在企业中引入 AI 辅助开发

核心概念

四阶段工作流

Analysis（分析） → Planning（规划） → Solutioning（解决方案） → Implementation（实施）
理解需求         制定计划           开发实现            测试上线

三种规划路径

BMAD 的工作方式

你 vs BMAD 的分工

你负责（决策）：

• 提供项目方向和需求
• 选择技术方案和架构
• 审核生成的文档和代码
• 最终批准是否上线

BMAD 负责（执行）：

• 分析代码库，理解项目结构
• 生成 PRD、架构图、测试计划
• 编写具体代码实现
• 进行代码审查和质量检查

工作流程示例

场景：修复登录 Bug（Quick Flow）

你：/quick-spec
BMAD：分析代码，发现问题，提供修复方案 A/B
你：选择方案 A
你：/dev-story --id="fix-login"
BMAD：生成修复代码
你：审核通过
你：/code-review
BMAD：检查逻辑、测试、安全性，通过 ✅

耗时：10-15 分钟

安装与配置

前置要求

Node.js v20+ + Claude Code / Cursor / Windsurf

安装命令

bash
复制
# 交互式安装
npx bmad-method install

# 自动化安装（CI/CD）
npx bmad-method install --directory /path/to/project --modules bmm --tools claude-code --yes

开始使用

bash
复制
# 获取个性化建议
/bmad-help

核心模块

BMad Method (BMM) - 核心框架

• 34+ 工作流：覆盖分析、规划、开发、测试全流程
• 12+ 专业 Agent：PM、Architect、DEV、QA、UX、Scrum Master 等
• 内置测试：Quinn (QA) 随时可用

扩展模块示例

Test Architect (TEA) - 企业级测试策略

• 8 个工作流覆盖完整测试生命周期
• 基于风险的测试规划、质量门控
• 适用于：合规要求、复杂系统、需要严格测试策略的项目

安装：npx bmad-method install --modules bmm,tea

更多模块：Game Dev Studio（游戏开发）、Creative Intelligence（创新思维）

关键技术

文档优先原则

传统方式：直接生成代码 → 前后不一致

BMAD 方式：
  1. 生成架构文档（作为"地图"）
  2. 基于文档生成代码 → 前后一致

实战验证：Go → TS 迁移项目，先生成 1600 行架构文档，后续代码生成逻辑漏洞几乎全部被扫平。

对抗性审查

• AI Agent A：编写代码
• AI Agent B：必须找出问题
• 审查维度：逻辑、安全、性能、可维护性

Scale-Adaptive（规模自适应）

根据项目复杂度自动调整流程深度，小项目快速通道，大项目完整流程。

快速开始建议

新手

1. 阅读"BMAD 的工作方式"理解概念
2. 用 Quick Flow 修复一个小 Bug
3. 安装：npx bmad-method install
4. 使用 /bmad-help 开始

有经验者

1. 根据项目类型选择规划路径
2. 参考实战案例了解最佳实践
3. 按需安装扩展模块

实战案例

案例 1：从零构建待办事项应用（完整流程）

项目目标：开发一个简单的待办事项 Web 应用

使用路径：Quick Flow（小项目）

完整步骤

步骤 1：快速规格（5 分钟）

bash
复制
/quick-spec

BMAD 分析项目后生成：

功能列表：
- 添加待办事项
- 标记完成/未完成
- 删除待办事项

技术栈建议：
- 前端：React + TypeScript
- 后端：Node.js + Express
- 数据库：SQLite

用户故事：
1. 作为用户，我想要添加待办事项
2. 作为用户，我想要标记完成状态
3. 作为用户，我想要删除待办事项

步骤 2：开发故事 1 - 添加待办（15 分钟）

bash
复制
/dev-story --id="story-1"

BMAD 生成：

• 数据库表设计
• API 接口代码
• 前端组件代码

你审核代码，提出修改意见，BMAD 调整。

步骤 3：开发故事 2 - 标记完成（10 分钟）

bash
复制
/dev-story --id="story-2"

BMAD 基于故事 1 的架构继续开发。

步骤 4：开发故事 3 - 删除待办（10 分钟）

bash
复制
/dev-story --id="story-3"

步骤 5：代码审查（5 分钟）

bash
复制
/code-review

BMAD 检查：

• ✅ 逻辑正确性
• ✅ SQL 注入风险（无）
• ✅ XSS 风险（已转义）
• ✅ 测试覆盖（有单元测试）
• ✅ 代码风格一致

总耗时：45 分钟 质量：可部署到生产环境

案例 2：Steps 目标管理应用（企业级 SaaS）

项目规模：企业级系统

技术栈：SvelteKit + FastAPI + JWT

完整流程：产品简报 → PRD → 架构设计 → Sprint 规划 → 开发 → 测试

成果：

• 规划时间：2-3 周 → 6 小时（↓ 95%）
• 开发速度：提升 3 倍
• 架构一致性：70% → 100%（↑ 30%）

资源链接

官方文档

• 官方文档：https://docs.bmad-method.org/
• 快速入门：https://docs.bmad-method.org/tutorials/getting-started/
• 工作流图谱：https://docs.bmad-method.org/reference/workflow-map/

完整项目教程

• Task Manager 教程：https://bmadmethodguide.com/
• 案例研究：https://buildmode.dev/blog/mastering-bmad-method-2025/
• 商业分析师指南：https://medium.com/@hieutrantrung.it/the-complete-business-analysts-guide-to-bmad-method-from-zero-to-expert-project-planning-in-30-3cf3995a0480

视频教程

• BMAD v6 完整演示：https://www.youtube.com/watch?v=LorEJPrALcg
• AI 敏捷团队教程：YouTube 官方频道

扩展资源

• 游戏开发扩展包
• DevOps 扩展包
• 创意写作扩展包

中文资源

• GitHub：https://github.com/bmad-code-org/BMAD-METHOD（32,000+ Star）

核心理念

"让 AI 学会写代码不难，难的是让它学会像个工程师一样思考。"

BMAD = 人类决策 + AI 执行 + 结构化流程

你是船长，BMAD 是船员团队。

文档版本：V6 Beta | 更新时间：2026-02-13

开始使用：npx bmad-method install