324 lines
8.8 KiB
Markdown
324 lines
8.8 KiB
Markdown
# 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) 了解技术架构细节
|