# 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](./02-核心架构.md) 了解技术架构细节