BMAD方法论 Claude Code 使用指南
从产品理念到代码实现的完整AI驱动敏捷开发工作流
🎯 什么是BMAD方法论？
BMAD (Business, Market, Architecture, Development) 是一个AI驱动的敏捷开发方法论，通过专业化代理团队实现从商业需求到技术实现的完整工作流程。
核心理念
- 智能体规划: 专门代理协作创建详细、一致的PRD和架构文档
- 上下文工程开发: 将详细计划转换为超详细的开发故事
- 角色专业化: 每个代理专注特定领域，避免角色切换导致的质量下降
🏗️ BMAD代理体系
代理角色说明
- PO (Product Owner) - 产品负责人Sarah：需求分析、用户故事、验收标准
- Analyst - 业务分析师Mary：市场研究、竞争分析、商业案例
- Architect - 系统架构师Winston：技术架构、系统设计、技术选择
- SM (Scrum Master) - 敏捷教练：任务分解、冲刺规划、流程协调
- Dev (Developer) - 开发工程师：代码实现、技术文档
- QA (Quality Assurance) - 质量保证：测试策略、质量验证
- UX Expert - 用户体验专家：交互设计、可用性测试
🚀 快速开始
安装配置
BMAD方法论已集成到您的Claude Code系统中，无需额外安装。
基本使用方法
1. 完整BMAD工作流
# 一键执行完整开发流程
/bmad-pilot "实现企业级用户管理系统，支持RBAC权限控制和LDAP集成"
# 执行流程：PO → Architect → SM → Dev → QA
2. 常用选项
# 跳过测试（PO → Architect → SM → Dev）
/bmad-pilot "实现支付网关API" --skip-tests
# 直接从架构进入开发（跳过 SM 规划）
/bmad-pilot "设计微服务电商平台" --direct-dev
# 跳过仓库扫描（不推荐）
/bmad-pilot "用户界面优化" --skip-scan
3. 直接开发与部分流程
# 技术焦点（架构后直接进入开发与测试）
/bmad-pilot "API网关实现" --direct-dev
# 完整设计流程（需求→架构→规划→开发→测试）
/bmad-pilot "系统重构规划"
# 仅业务相关分析 → 请使用下方“独立代理使用”中的 /bmad-po 与 /bmad-analyst
4. 独立代理使用
# 产品需求分析
/bmad-po "企业CRM系统功能需求定义"
# 市场调研分析
/bmad-analyst "SaaS市场竞争格局和机会分析"
# 系统架构设计
/bmad-architect "高并发分布式系统架构设计"
# 主协调器（可转换为任意代理）
/bmad-orchestrator "协调多代理完成复杂项目"
📋 详细命令说明
/bmad-pilot - 完整工作流执行
用法: /bmad-pilot <项目描述> [选项]
选项:
--skip-tests: 跳过 QA 阶段--direct-dev: 跳过 SM 冲刺计划，架构后直接进入开发--skip-scan: 跳过初始仓库扫描（不推荐）
示例:
/bmad-pilot "构建在线教育平台，支持直播、录播、作业系统"
/bmad-pilot "API网关设计" --direct-dev
/bmad-pilot "支付模块" --skip-tests
/bmad-po - 产品负责人
角色: Sarah - 技术产品负责人 & 流程管家 专长: 需求分析、用户故事、验收标准、冲刺规划
用法: /bmad-po <需求描述>
工作流程:
- 需求分解和功能点识别
- 用户故事创建（As a… I want… So that…）
- 验收标准定义和优先级排序
- 利益相关者验证和签署
示例:
/bmad-po "设计企业级权限管理系统，支持多租户和细粒度权限控制"
/bmad-po "移动端电商APP功能需求分析"
/bmad-analyst - 业务分析师
角色: Mary - 洞察分析师 & 战略合作伙伴 专长: 市场研究、竞争分析、商业案例开发、利益相关者分析
用法: /bmad-analyst <分析主题>
工作流程:
- 市场格局和竞争对手分析
- 商业案例开发和ROI分析
- 利益相关者分析和需求收集
- 项目简报和战略建议
示例:
/bmad-analyst "企业级认证市场分析，JWT vs OAuth2.0 vs SAML"
/bmad-analyst "云原生架构迁移的商业价值和风险评估"
/bmad-architect - 系统架构师
角色: Winston - 全栈系统架构师 & 技术领导者 专长: 系统设计、技术选择、API设计、基础架构规划
用法: /bmad-architect <系统设计需求>
工作流程:
- 系统需求和约束分析
- 技术栈和架构模式选择
- 组件设计和系统架构图
- 实施策略和开发指导
示例:
/bmad-architect "微服务架构设计，支持事件驱动和最终一致性"
/bmad-architect "高可用API网关架构，支持限流、熔断、监控"
/bmad-orchestrator - 主协调器
角色: BMAD主协调器 专长: 工作流协调、代理转换、多代理任务管理
用法: /bmad-orchestrator [命令] [参数]
功能:
- 动态转换为任意专门代理
- 协调复杂多代理工作流
- 管理代理间的上下文传递
- 提供工作流指导和建议
🔄 与现有系统集成
现有系统 vs BMAD方法论
| 特性 | Requirements-Pilot | BMAD方法论 |
|---|---|---|
| 执行时间 | 30分钟 | 1-2小时 |
| 适用场景 | 快速功能开发 | 企业级项目 |
| 覆盖范围 | 技术实现 | 商业+技术全流程 |
| 质量门控 | 90%技术质量 | 多维度质量验证 |
| 代理数量 | 4个技术代理 | 7个全角色代理 |
使用场景建议
🚅 快速开发（推荐现有系统）
# 简单功能快速实现
/requirements-pilot "添加用户登录功能"
/requirements-pilot "实现数据导出API"
🏢 企业级项目（推荐BMAD）
# 复杂系统完整流程
/bmad-pilot "构建企业级ERP系统，集成财务、人事、项目管理模块"
/bmad-pilot "设计多租户SaaS平台，支持自定义配置和第三方集成"
🔄 混合模式（规划+实现）
# 先用BMAD做规划（在 PRD/架构确认门停留）
/bmad-pilot "电商平台架构设计"
# 再用现有系统快速实现
/requirements-pilot "基于架构规格实现用户服务模块"
/requirements-pilot "基于架构规格实现订单服务模块"
🎯 典型工作流示例
示例1: 企业级认证系统
# 完整BMAD流程
/bmad-pilot "企业级JWT认证系统，支持RBAC权限控制、LDAP集成、审计日志、高可用部署"
# 预期输出：
# 1. PO: 详细用户故事和验收标准
# 2. Architect: 完整系统架构和技术选择
# 3. SM: 开发任务分解和冲刺计划
# 4. Dev: 生产就绪代码实现
# 5. QA: 测试策略与用例并执行（可选）
示例2: API网关开发
# 技术焦点流程（跳过SM，架构后直接进入开发）
/bmad-pilot "高性能API网关，支持限流、熔断、监控、服务发现" --direct-dev
# 执行流程：
# 1. Architect: 系统架构设计
# 2. Dev: 代码实现
# 3. QA: 性能测试和质量验证
示例3: 产品市场分析
# 业务分析流程（使用独立代理）
/bmad-po "云原生数据库市场机会分析的产品需求假设与范围界定"
/bmad-analyst "云原生数据库市场机会分析"
# 执行流程：
# 1. PO: 产品需求定义
# 2. Analyst: 市场研究和竞争分析
📊 质量保证体系
BMAD质量标准
- 需求完整性: 90+ 分需求清晰度评分
- 商业对齐: 明确的价值主张和市场定位
- 架构完善: 全面的系统设计和技术选择
- 实现就绪: 可执行的开发规格和质量标准
集成现有质量门控
- 保持90%技术质量阈值
- 增加商业价值验证维度
- 多代理交叉验证机制
- 自动化质量反馈循环
🔧 高级用法和最佳实践
1. 渐进式复杂度管理
# MVP阶段
/bmad-workflow "用户管理系统MVP版本" --phase=development
# 功能增强阶段
/bmad-analyst "用户反馈分析和功能增强建议"
/requirements-pilot "基于反馈实现增强功能"
# 企业级增强
/bmad-workflow "企业级安全增强和合规支持" --agents=architect,dev,qa
2. 跨项目知识管理
# 项目文档化
/bmad-orchestrator "将当前项目架构文档化，便于后续项目参考"
# 最佳实践提取
/bmad-architect "基于项目经验总结微服务架构最佳实践"
3. 团队协作优化
# 团队能力评估
/bmad-analyst "评估团队技术栈和能力匹配度"
# 开发计划调整
/bmad-po "根据团队能力调整功能优先级和实现计划"
🚦 故障排除
常见问题
Q: BMAD工作流执行时间较长，如何优化？ A:
- 简单功能使用
/requirements-pilot - 复杂项目使用分阶段执行
--phase=planning - 使用自定义代理序列减少不必要的步骤
Q: 如何在BMAD和现有系统间选择？ A:
- 项目复杂度 < 中等：使用
/requirements-pilot - 项目复杂度 ≥ 高：使用
/bmad-workflow - 需要商业分析：必须使用BMAD
- 纯技术实现：可选择任一系统
Q: 代理输出质量不符合预期怎么办？ A:
- 提供更详细的项目描述
- 使用分阶段执行，逐步细化
- 结合独立代理使用进行专项优化
🎉 开始你的BMAD之旅
第一次使用
# 体验完整BMAD工作流
/bmad-workflow "构建一个简单的博客系统，支持文章发布、评论、用户管理"
学习不同代理角色
# 产品思维
/bmad-po "分析博客系统的用户需求和使用场景"
# 商业思维
/bmad-analyst "个人博客vs企业CMS市场定位分析"
# 技术思维
/bmad-architect "可扩展博客系统架构设计"
📚 进阶学习资源
BMAD方法论 + Claude Code = 从理念到代码的完整AI开发工作流 🚀
开始使用BMAD方法论，体验专业化AI代理团队带来的开发效率和质量提升！