BMAD-METHOD如何使用？

BMAD-METHOD是一个AI驱动的敏捷开发框架，它通过模拟一个由多个专业化AI代理组成的完整团队，来覆盖从需求分析到代码实现的软件开发全流程。其核心目标是让个人开发者或小团队也能具备一个完整敏捷团队的协作能力。

项目地址：https://github.com/bmad-code-org/BMAD-METHOD

为了帮助你快速建立整体认知，下图清晰地展示了BMAD-METHOD标志性的“规划-执行”双阶段核心工作流。

flowchart LR
    A[项目启动] --> B[规划阶段<br>Web UI环境]

    B --> C[分析师<br>创建项目简报]
    C --> D[产品经理<br>生成PRD]
    D --> E[架构师<br>设计系统架构]

    E --> F[执行阶段<br>IDE环境]

    F --> G
    subgraph G [循环: 故事驱动开发]
        direction LR
        H[Scrum Master<br>创建用户故事] --> I[开发者<br>实现故事代码]
        I --> J[QA<br>审查与测试]
        J --> H
    end

    G --> K[项目完成]

下面，我们来详细了解这个框架的核心构成以及如何开始使用它。

🧩 认识框架的核心构成¶

BMAD-METHOD的强大能力建立在几个关键创新点上。

• 专业化的AI代理团队：框架内预置了扮演不同角色的AI代理，包括进行市场调研的分析师、定义产品需求的产品经理、负责技术选型和系统设计的架构师、编写具体开发任务的Scrum Master、实现代码的开发者以及负责质量保证的QA专家等。这就像一个虚拟的敏捷团队。

• 两大关键技术机制：

  1. 代理规划：在开发开始前，由分析师、产品经理、架构师等代理协作，生成详尽且一致的产品需求文档和系统架构设计，从源头上保证规划的清晰可靠。
  2. 上下文工程化开发：这是框架的亮点，能有效解决传统AI辅助开发中常见的“上下文丢失”问题。它通过将大型需求文档拆分成以“用户故事”为单位的独立任务，确保开发代理在实现每个功能时，所需的上下文信息都是精准和完整的。

• 模块化与可扩展性：框架采用模块化设计，其代理、工作流、模板等都可以自定义或通过扩展包进行增强，能够适应不同复杂度的项目需求。

🛠️ 如何使用BMAD-METHOD¶

使用BMAD-METHOD开发项目，就像在指挥一个专业的AI团队。

1. 环境准备与安装¶

首先，你需要在项目中安装BMAD-METHOD框架。通常可以通过简单的命令完成，安装过程会自动创建必要的目录结构和配置文件。

npx bmad-method install

2. 规划阶段：在Web UI中完成设计¶

这个阶段对应于上图左侧部分，主要在Web界面中完成。你需要依次启动不同的AI代理角色：
* 启动分析师：使用 /analyst 命令，与AI讨论项目背景、目标用户和核心需求，生成一份项目简报。
* 启动产品经理：使用 /pm 命令，基于项目简报进行深入分析，生成详细的产品需求文档，明确功能优先级。
* 启动架构师：使用 /architect 命令，根据产品需求文档设计系统架构，确定技术栈、数据库设计等。

此阶段的所有产出文档（如PRD、架构图）都会保存在项目的 docs/ 目录下，为开发提供蓝图。

3. 执行阶段：在IDE中实现代码¶

规划完成后，进入上图右侧的IDE执行阶段。
* 关键切换：文档分片：这是衔接规划与开发的关键步骤。由产品负责人代理将大型设计文档“分片”，拆解成一个个具体的、可执行的用户故事。
* 循环开发：接下来便进入“创建故事 -> 实现故事”的循环：
* Scrum Master 使用 /sm 命令，根据分片后的文档创建具体的用户故事，明确验收标准。
* 开发者 使用 /dev 命令，领取用户故事并进行编码实现、单元测试。
* QA专家 则对代码进行审查和测试验证，确保质量。

💡 最佳实践与适用场景¶

为了让框架发挥最大效能，这里有一些实践建议：
* 计划先行：严格遵守“先规划，后执行”的原则，避免直接开始编码。
* 小处着手：从一个功能明确的小型项目开始试用，逐步熟悉工作流。
* 善用模板：充分利用框架提供的各类文档和代码模板，保证规范性和一致性。

BMAD-METHOD特别适用于以下场景：
* 个人开发者或初创小团队，希望以有限资源完成全功能开发。
* 需要快速构建原型，验证产品想法。
* 规范化交付，有明确质量、性能要求的工程项目。