BMAD-METHOD/icsc/report/01-项目概述.md

8.8 KiB
Raw Blame History

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

重大改进:

  1. 3轨制度简化 - 从 5 个复杂等级简化为 3 个清晰轨道
  2. 工作流现代化 - 使用显式任务调用
  3. BMGD 模块独立 - 游戏开发成为独立模块
  4. Web 打包改进 - 更好的依赖解析
  5. 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. 适用场景

最适合的场景

  1. AI 驱动软件开发 - Bug 修复到企业级系统
  2. 游戏开发 - 概念到生产完整流程
  3. 创意工作 - 头脑风暴、设计思维、故事叙述
  4. 团队协作 - Party Mode 多代理讨论
  5. 自定义领域 - 使用 BMB 扩展到法律、医疗、金融等

不适合的场景

  1. 需要完全自动化的场景BMAD 强调人类参与)
  2. 简单的代码生成(过于轻量级的任务)
  3. 不需要结构化流程的场景

9. 企业价值主张

对企业的核心价值

1. 标准化 AI 使用

  • 统一的工作流程和最佳实践
  • 减少团队学习曲线
  • 提高协作效率

2. 质量保证

  • 结构化的规划和实现流程
  • 内置的检查和验证机制
  • 减少返工和错误

3. 知识传承

  • 工作流程文档化
  • 代理承载领域知识
  • 新人快速上手

4. 可扩展性

  • 模块化架构易于定制
  • 可适应不同项目规模
  • 支持企业特定需求

5. 投资回报

  • 开源 MIT 许可证(无授权费)
  • 提高开发效率
  • 减少培训成本

10. 小结

BMAD-METHOD 代表了 AI 辅助开发的新范式:

不是自动化,而是放大 不是替代,而是协作 不是工具,而是方法论

这是一个成熟的、经过实战检验的框架,适合希望系统化地将 AI 集成到开发流程中的企业和团队。


下一步: 阅读 02-核心架构.md 了解技术架构细节