作者：黑夜路人

时间：2025年11月

BMad Method 介绍

BMad Method (Breakthrough Method of Agile AI-Driven Development) 是一个通用的 AI 代理框架，旨在实现人机协作的敏捷开发。它最初是为软件开发设计的方法论，现已发展成为一个跨领域的、与工具无关的框架，可以创建专业化的 AI 代理来指导用户完成各种结构化工作流程。

核心特性

• 🚀 通用框架
  • 跨领域应用：从软件开发扩展到创意写作、商业策略等各个领域。
  • 工具无关：支持在多种 IDE 和 Web 平台上进行部署。
  • 自然语言定义：通过简单的 Markdown 文件即可定义 AI 代理的行为和工作流。

• 🎯 双重部署模式
  1. 1.IDE 集成：可在 Claude Code, Cursor, Windsurf 等 IDE 中使用，拥有完整的项目文件访问权限。
  2. 2.Web 平台：支持 ChatGPT, Google Gemini 等平台，通过打包系统生成独立的 Markdown 文件进行交互。

安装和使用

快速安装

推荐使用 npx 进行快速安装和配置。

# 推荐使用 npx 安装npx install bmad-method

或者，你也可以从源码克隆并进行安装。

# 或从源码克隆安装git clone https://github.com/bmad-code-org/BMAD-METHOD.gitcd BMAD-METHODnpm run install:bmad

安装程序将会引导你完成以下配置：

• 输入你的用户名
• 选择你使用的 IDE (Claude Code, Cursor, Windsurf 或通用)
• 选择 BMad Method 的安装目录
• 选择需要额外包含的扩展包

项目结构

安装完成后，会在你的项目目录中创建以下结构：

my-project/├── bmad-core/        # 核心代理和工作流├── bmad-expansion-*/   # 可选的扩展包├── CLAUDE.md         # IDE 特定的指令文件├── .claudeignore     # 文件排除规则，用于控制代理访问范围└── output/           # AI 代理的输出内容

核心代理团队

BMad Method 提供了一套模拟敏捷软件开发团队的 AI 代理，各司其职，协同工作。

• 规划阶段: Analyst (分析师), PM (产品经理), Architect (架构师) 等。
• 开发阶段: Scrum Master (敏捷教练), Developer (开发者), QA (质量保证) 等。
• 协调代理: BMad Master (主协调器) 负责在 IDE 环境中调度和协调不同代理的工作。

规划阶段代理

• Analyst (分析师)：负责业务分析、需求收集和头脑风暴。
• PM (产品经理)：负责产品管理和产品需求文档 (PRD) 的创建。
• PO (产品负责人)：负责产品所有权和待办事项 (Backlog) 管理。
• Architect (架构师)：负责解决方案架构和技术选型设计。
• UX Expert (用户体验专家)：负责用户体验和界面设计。

开发阶段代理

• Scrum Master (敏捷教练)：负责用户故事创建和开发流程管理。
• Developer (开发者)：负责具体功能的代码实现。
• QA (质量保证)：负责测试和确保产品质量。

协调代理

• BMad Master：在 IDE 环境中作为主协调器，调度其他代理。
• BMad Orchestrator：在 Web 平台环境中作为协调器。

工作流程示例

阶段 1：分析 (Web 平台)

加载分析师代理，进行项目初期的头脑风暴。

*brainstorm-project

• 输出: 生成初始的项目概念和想法。

接着，生成一份简洁的产品简介。

*brief

• 输入: 头脑风暴产生的想法。
• 输出: 一份结构化的产品简介文档。

阶段 2：规划 (Web 平台)

加载产品经理代理，制定详细的项目计划。

*plan-project

• 输入: 产品简介文档。
• 过程: 根据项目复杂度 (0-4级) 进行自适应规划。
• 输出: 完整的产品需求文档 (PRD)。

阶段 3：架构设计

加载架构师代理，进行技术架构设计。

*solution-architecture

• 输入: 产品需求文档 (PRD)。
• 过程: 根据项目类型 (如 web, 移动, 游戏, 嵌入式) 进行适配。
• 输出: 系统架构设计文档。

阶段 4：开发 (需要 IDE 环境)

由敏捷教练创建用户故事。

*create-story

• 输入: 架构文档、史诗 (Epic) 定义。
• 输出: 包含详细验收标准的具体用户故事。

开发者根据用户故事进行功能实现。

*develop

• 输入: 用户故事。
• 过程: 实现功能、编写单元测试、提交代码审查。
• 输出: 完整的代码、测试用例和相关文档。

QA 团队进行质量检查。

*qa-gate

• 输入: 已完成的故事和代码库。
• 输出: 质量保证 (QA) 报告。

实战教程：使用 BMad 在 Claude Code 中构建任务管理系统

本教程将带你从零开始，在 Claude Code 环境中利用 BMad Method 的 AI 代理团队，一步步构建一个任务管理（To-Do）应用。

步骤 1：项目初始化与 BMad 安装

1. 1.创建项目: 在你的本地文件系统中创建一个名为 task-manager 的文件夹，并用 Claude Code 打开它。
2. 2.初始化 Node.js 项目: 按下 Ctrl+~ 打开 Claude Code 的内置终端，然后运行以下命令来创建一个 package.json 文件：

   npm init -y

3. 3.安装 BMad: 在终端中运行安装命令。安装程序将引导你完成设置，请在 IDE 选择时指定 Claude Code。

   npx bmad-method install

   完成后，你的项目目录中会出现一个 bmad-core 文件夹，里面包含了所有核心 AI 代理的定义。

步骤 2：需求分析与架构设计

现在，我们利用 AI 代理来完成项目前期的规划工作。

1. 1.激活分析师 (Analyst): 在 Claude Code 的聊天（Chat）面板中，输入 @ 符号，此时会弹出一个文件搜索框。输入 analyst 并选择 bmad-core/agents/analyst.md 文件。

2. 2.进行头脑风暴: 代理加载后，会进行自我介绍。现在，向它发出第一个指令：

   *brainstorm-project 一个简单的任务管理系统

   Analyst 代理会立即输出一份包含核心功能（如添加任务、标记完成、任务列表等）的 Markdown 列表。

3. 3.激活架构师 (Architect): 再次输入 @ 切换代理，这次选择 bmad-core/agents/architect.md。

4. 4.生成架构: 告诉架构师你的需求，让它为你设计技术方案。

   *solution-architecture项目目标：一个具备任务添加和列表查看功能的简单任务管理系统。

   Architect 代理会返回一份技术架构建议，例如：

   • 前端: Vue.js
   • 后端: Node.js + Express
   • 数据存储: 暂时使用服务器内存中的数组
   • API: GET /api/tasks, POST /api/tasks

     请将这份架构文档保存为项目根目录下的 ARCHITECTURE.md 文件。

步骤 3：核心功能开发

这是我们将 AI 指令转化为实际代码的关键一步。

1. 1.创建用户故事: 加载 Scrum Master 代理 (@bmad-core/agents/scrum-master.md)，让它为我们创建第一个功能的用户故事。

   *create-story 作为用户，我希望添加新任务，以便跟踪我的待办事项。

   将输出的用户故事保存到 stories/01-add-task.md 文件中。

2. 2.激活开发者 (Developer): 加载核心的 Developer 代理 (@bmad-core/agents/developer.md)。
3. 3.下达开发指令: 这是最关键的一步。我们需要将架构和用户故事作为上下文，同时提供给开发者代理。在聊天框中输入：

       @ARCHITECTURE.md @stories/01-add-task.md    现在，请使用*develop命令实现此功能。你需要：    1. 为Vue应用创建基本的`index.html`和`main.js`。    2. 为Express后端创建`server.js`。    3. 前端应该有一个输入框和一个添加任务的按钮。    4. 后端应该处理POST请求并存储任务。

4. 4.代码生成与审查: Claude Code 会利用其对整个工作区的感知能力，执行 Developer 代理的指令。它不会直接写入文件，而是会在聊天框中以代码块的形式生成 index.html, main.js 和 server.js 的完整内容。你可以一键复制或直接创建这些文件，将代码粘贴进去。

步骤 4：质量保证与测试

代码完成后，我们需要确保其质量。

1. 1.激活 QA 代理: 加载 QA 代理 (@bmad-core/agents/qa.md)。
2. 2.请求测试用例: 引用刚刚生成的文件，让 QA 代理为我们编写测试。

       @server.js @main.js    *qa-gate 请为任务创建功能编写单元测试。前端和后端测试都使用Jest。

3. 3.生成测试代码: QA 代理会分析代码并提供 server.test.js 和 main.test.js 的测试代码。你可以再次复制这些代码，创建测试文件，并在终端中运行它们来验证功能的正确性。

通过以上步骤，你就在 Claude Code 中完成了一个由 AI 代理全程协作的开发闭环。你可以继续使用这种模式，迭代开发“任务列表展示”、“标记任务完成”等其他功能。

扩展包生态

BMad Method 通过扩展包支持不同领域的专业工作流。例如，你可以安装 bmad-expansion-gamedev 来获得针对 Unity 或 Godot 游戏开发的专业代理和工作流。

创建自定义扩展包

你也可以创建自己的扩展包来适应特定领域的需求。

expansion-packs/my-domain/├── package.json        # 扩展元数据├── agents/             # 领域专家代理定义└── tasks/              # 专业化任务指令

优势特点

1. 1.结构化方法：提供一套完整的、模拟敏捷开发团队的 AI 代理，使工作流程标准化。
2. 2.深度 IDE 集成：在 Claude Code 等环境中，能够读取项目上下文，实现精准的代码生成和修改。
3. 3.可扩展性：通过扩展包生态系统，可以轻松支持不同领域和专业。
4. 4.质量保证：内置的 QA 代理和检查清单确保了各阶段产出的高质量。
5. 5.易于维护：所有代理和工作流均基于 Markdown 定义，易于理解和修改。
6. 6.社区支持：拥有活跃的社区和持续的功能更新。