8.8 KiB
8.8 KiB
01 - BMAD-METHOD 项目概述
1. 项目基本信息
1.1 项目标识
- 名称: BMAD-METHOD (Breakthrough Method of Agile AI-driven Development)
- 版本: v6.0.0-alpha.7 (2025-11-09)
- 状态: Alpha 版本,接近 Beta 质量,高度稳定
- 仓库: https://github.com/bmad-code-org/BMAD-METHOD
- 许可证: MIT
- npm 包: bmad-method@alpha
1.2 核心定位
BMAD-METHOD 是一个通用人-AI 协作平台,其核心是 BMad-CORE 框架(Collaboration Optimized Reflection Engine,协作优化反思引擎)。
关键定义:
这不是一个自动化工具,而是一个协作增强系统,通过专业化 AI 代理和结构化工作流程来放大人类能力,而非替代人类思考。
2. 核心目的和解决的问题
2.1 解决的痛点
问题 1: 人-AI 失衡
现状:
- AI 工具要么过度自动化(人类被边缘化)
- 要么缺乏专业指导(只是聊天机器人)
BMAD 解决方案:
- 双向指导:代理引导用户,用户推动代理
- 人类做决策,AI 提供专业建议和执行
问题 2: 缺乏系统化流程
现状:
- AI 辅助工作缺少战略性工作流程
- 每个人使用 AI 的方式各异
BMAD 解决方案:
- 63+ 个结构化工作流程
- 覆盖完整开发生命周期
- 基于敏捷最佳实践
问题 3: 知识碎片化
现状:
- 团队成员各自探索 AI 使用方式
- 缺乏统一的最佳实践
BMAD 解决方案:
- 19+ 个专业化代理,角色明确
- 标准化的协作模式
- 可定制但保持一致性
问题 4: 领域适应性不足
现状:
- 工具要么过于通用,要么局限于特定领域
BMAD 解决方案:
- 模块化架构,可扩展到任何领域
- BMad Builder 支持自定义代理和工作流
- 已支持:软件开发、游戏开发、创意工作
3. C.O.R.E. 哲学框架
BMAD 的核心设计哲学:
C - Collaboration (协作)
└─ 人-AI 伙伴关系,互补优势
├─ 人类:判断、创意、背景、决策
└─ AI:知识、规模、一致性、分析
O - Optimized (优化)
└─ 经过实战检验的协作流程
├─ 基于敏捷最佳实践
└─ 数千个项目验证
R - Reflection (反思)
└─ 战略性质问引导突破
├─ 不给答案,问正确的问题
└─ 激发深度思考
E - Engine (引擎)
└─ 强大框架编排 19+ 代理和 63+ 工作流
├─ 可扩展到任何领域
└─ 工具无关(IDE 适配)
关键原则
"人类放大"不是"自动化"
| 传统自动化 | BMAD 放大 |
|---|---|
| 减少人力投入 | 提高人类产出质量 |
| AI 做决定 | AI 协助人类决定 |
| "就这样做" | "考虑这个角度..." |
| 被动使用 | 主动协作 |
| 单向指导 | 双向对话 |
实例:
- ❌ 错误:AI 自动生成 PRD
- ✅ 正确:AI 通过有意义的问题引导用户发现 PRD 需求
4. 项目规模和组成
4.1 数量指标
| 类型 | 数量 | 说明 |
|---|---|---|
| AI 代理 | 19 个 | 专业化角色(PM、架构师、开发者等) |
| 工作流程 | 63 个 | 结构化引导流程 |
| 文档文件 | 273 个 | Markdown 格式的指南和模板 |
| 模块 | 5 个 | Core + BMM + BMB + CIS + BMGD |
| 支持 IDE | 15 个 | Claude Code、Cursor、Windsurf 等 |
| 源代码规模 | 3.5 MB | 包含所有模块 |
4.2 核心模块
BMad-CORE (核心框架)
- 所有模块的基础
- 提供代理和工作流引擎
- BMad Master 协调器
- Party Mode 多代理协作
BMad Method (BMM) - 主模块
- 规模: 2.3 MB,最大模块
- 用途: AI 驱动的敏捷软件开发
- 包含: 12 个代理,34 个工作流
- 特色: 3轨自适应系统
BMad Builder (BMB)
- 规模: 463 KB
- 用途: 创建自定义代理、工作流、模块
- 包含: 1 个代理,7 个工作流
Creative Intelligence Suite (CIS)
- 规模: 154 KB
- 用途: 创意促进和创新思维
- 包含: 5 个代理,5 个工作流
- 技术: 36 种头脑风暴技术
BMad Game Development (BMGD)
- 规模: 556 KB
- 用途: 游戏开发生命周期
- 包含: 4 个代理,游戏专项工作流
5. 关键特性总览
5.1 规模自适应系统(3轨)
BMAD 根据项目复杂度自动调整:
🚀 Quick Flow Track (快速轨)
- 适用: Bug 修复、小功能、清晰范围
- 输出: Tech Spec 文档(2-3 小时)
- 代理: 5 个(精简团队)
- 流程: Tech Spec → 实现 → 测试
📋 BMad Method Track (标准轨)
- 适用: 产品、平台、复杂功能
- 输出: PRD + Architecture + UX Design
- 代理: 8 个(完整团队)
- 流程: 完整 4 相方法(1-2 周规划)
- 使用率: 最常见选择
🏢 Enterprise Method Track (企业轨)
- 适用: 企业级系统、合规性要求
- 输出: BMad Method + Security/DevOps/Test Strategy
- 代理: 12 个(专业团队)
- 流程: 扩展规划和实现(2-4 周)
- 使用率: <5% 项目
5.2 4相开发方法论
Phase 1: 分析 (可选)
└─ 头脑风暴、市场研究、产品简报
Phase 2: 规划 (必需) ⭐
└─ PRD/Tech Spec、Epic 分解、UX 设计
Phase 3: 方案 (轨道依赖)
└─ 架构设计、方案验证
Phase 4: 实现 (迭代) 🔄
└─ Sprint 规划、Story 开发、Code Review
5.3 技术创新
Document Sharding (文档分片)
- 用途: 大项目节省 90%+ token
- 原理: 自动分割大文档为小片段
- 支持: 所有 Phase 4 工作流自动处理
Just-in-Time Context (即时上下文)
- 用途: 只加载当前需要的信息
- 好处: 降低 token 使用,提高 AI 专注度
Update-Safe Customization (更新安全定制)
- 位置:
bmad/_cfg/agents/ - 功能: 自定义代理名称、个性、语言
- 保证: 更新时保留所有定制
5.4 多 IDE 支持
支持 15 个主流 IDE:
| IDE | 工件位置 | 状态 |
|---|---|---|
| Claude Code | .claude/commands/ |
✅ 完整支持 |
| Cursor | .cursor/rules/ |
✅ 完整支持 |
| Windsurf | .windsurf/workflows/ |
✅ 完整支持 |
| VS Code + Copilot | .github/copilot/ |
✅ 支持 |
| 其他 11 个 IDE | 各自配置目录 | ✅ 支持 |
6. 版本演进
v6.0.0-alpha.7 (当前版本)
发布日期: 2025-11-09
重大改进:
- 3轨制度简化 - 从 5 个复杂等级简化为 3 个清晰轨道
- 工作流现代化 - 使用显式任务调用
- BMGD 模块独立 - 游戏开发成为独立模块
- Web 打包改进 - 更好的依赖解析
- IDE 工具修复 - Claude Code 和其他 IDE 安装优化
从 v4 到 v6 的变化
- ✅ 大幅简化工作流触发
- ✅ 更好的多语言支持
- ✅ 模块化架构重构
- ✅ 代理定制系统
- ✅ 文档质量提升
7. 社区和生态
开源社区
- GitHub Stars: 持续增长
- Discord: 活跃社区,#general-dev, #bugs-issues
- YouTube: @BMadCode 教程频道
- 贡献指南: 欢迎社区贡献
支持和文档
- 📚 完整文档: 273 个 Markdown 文件
- 🎥 视频教程: YouTube 频道
- 💬 实时支持: Discord 社区
- 📖 18 个 BMM 指南: Quick Start、FAQ、Troubleshooting
8. 适用场景
✅ 最适合的场景
- AI 驱动软件开发 - Bug 修复到企业级系统
- 游戏开发 - 概念到生产完整流程
- 创意工作 - 头脑风暴、设计思维、故事叙述
- 团队协作 - Party Mode 多代理讨论
- 自定义领域 - 使用 BMB 扩展到法律、医疗、金融等
❌ 不适合的场景
- 需要完全自动化的场景(BMAD 强调人类参与)
- 简单的代码生成(过于轻量级的任务)
- 不需要结构化流程的场景
9. 企业价值主张
对企业的核心价值
1. 标准化 AI 使用
- 统一的工作流程和最佳实践
- 减少团队学习曲线
- 提高协作效率
2. 质量保证
- 结构化的规划和实现流程
- 内置的检查和验证机制
- 减少返工和错误
3. 知识传承
- 工作流程文档化
- 代理承载领域知识
- 新人快速上手
4. 可扩展性
- 模块化架构易于定制
- 可适应不同项目规模
- 支持企业特定需求
5. 投资回报
- 开源 MIT 许可证(无授权费)
- 提高开发效率
- 减少培训成本
10. 小结
BMAD-METHOD 代表了 AI 辅助开发的新范式:
不是自动化,而是放大 不是替代,而是协作 不是工具,而是方法论
这是一个成熟的、经过实战检验的框架,适合希望系统化地将 AI 集成到开发流程中的企业和团队。
下一步: 阅读 02-核心架构.md 了解技术架构细节