BMAD-METHOD（Breakthrough Method for Agile AI-Driven Development）是一个完全免费开源的AI驱动敏捷开发框架。它旨在通过多个专业化AI智能体（如产品经理、架构师、开发者、UX设计师、QA等）的深度协作，辅助用户完成从项目头脑风暴、需求分析、架构设计到代码实现与部署的软件开发全生命周期。
与传统仅依靠单一对话窗口生成代码的AI工具不同，BMAD将敏捷开发的最佳实践转化为结构化的工作流（Workflows）。智能体不仅能生成代码，还能主动提问、挖掘隐性需求，并维护严格的架构和上下文一致性，有效解决了AI编程中常见的“上下文丢失”和“黑盒化”问题。该框架可无缝集成到Claude Code、Cursor、Windsurf等AI IDE中，具备自适应项目规模的智能规划能力，并支持让多个智能体角色在同一会话中联合讨论的“派对模式”。无论你是修复一个简单的Bug，还是从零构建企业级系统，BMAD都能为你提供规范化、可预测的AI专家协同开发体验。
Funktionsliste
- 多角色专业智能体协作：内置12+领域专家智能体，包括产品经理（John）、架构师（Winston）、开发者、UX设计师、Scrum Master、QA工程师等，各司其职，协同完成项目生命周期。
- 结构化敏捷工作流（Workflows）：提供34种以上的引导式工作流，涵盖创建产品需求文档（PRD）、架构设计文档（ADR）、用户故事拆解及代码实现，确保AI输出不偏离项目核心目标。
- 派对模式（Party Mode）：支持将多个智能体角色引入同一个会话中，让AI专家们联合进行头脑风暴和技术讨论，通过多视角碰撞出更优的系统设计方案。
- 规模自适应智能（Scale-Adaptive Intelligence）：引擎能够根据项目的复杂程度自动调整规划和执行深度，从小巧的Bug修复到庞大的企业级平台开发，自动匹配合理的颗粒度。
- 上下文一致性保护机制：通过Scrum Master智能体将高级架构规划转化为带有详尽上下文的开发任务（Story文件），为Dev智能体提供完整的实现细节和架构指导，消除AI编程中常见的上下文断层。
- AI智能向导（bmad-help）：内置智能帮助技能，随时在终端或IDE调用，AI会分析当前项目状态并给出下一步操作的精准建议。
- BMad生态模块扩展：包含强大的官方扩展模块，如BMad Builder（零代码创建自定义智能体）、Test Architect（测试策略与自动化）、Game Dev Studio（游戏开发专项模块）及创新智能套件。
- IDE原生无缝集成：作为指令或技能直接集成至Claude Code、Cursor、Windsurf等现代AI IDE中，无需离开开发环境即可直接操作代码库。
Hilfe verwenden
BMAD-METHOD 旨在将您的开发环境转变为一个拥有完整产研团队的数字工作室。为了让您能够顺利上手并发挥出该框架100%的威力，请仔细阅读以下详尽的安装与操作指南。
一、 环境准备与安装流程
在安装BMAD框架之前，请确保您的本地计算机已安装以下基础运行环境：
- Node.js: 需安装 v20 或更高版本（用于运行核心框架与包管理）。
- Python: 需安装 3.10 或更高版本。
- uv: 高性能的Python包管理和解析工具。
1. 交互式安装（推荐初学者）
打开终端（Terminal），进入您想要初始化项目的目标文件夹，运行以下命令：
npx bmad-method install
系统会启动交互式安装向导：
- 确认安装路径：输入您的项目根目录的绝对路径或直接回车确认当前目录。
- 模块选择：向导会询问您是否需要安装额外的官方模块（如 BMad Builder 或 Test Architect）。
- 成功安装后，您的项目根目录下会生成一个隐藏的
.bmad-core文件夹，其中包含了所有的智能体配置（如pm.md,architect.md）和工作流定义模板。
2. 非交互式安装（适用于CI/CD或自动化脚手架）
如果您希望通过单条命令快速完成安装，可以直接使用参数指定目录和所需工具（以Claude Code环境为例）：
npx bmad-method install --directory /path/to/your/project --modules bmm --tools claude-code --yes
二、 核心操作流程：如何与数字团队协作
安装完成后，在您的 AI IDE（如 Cursor 或 Claude Code）中打开该项目。接下来，您将通过 / 斜杠命令或直接对话的方式调用智能体。
步骤 1：迷茫时的第一步 —— 呼叫智能向导
如果您不知道从何开始，请在对话框中输入：
调用 bmad-help，我刚刚初始化了项目，接下来该做什么？
系统会自动分析当前的项目状态，并告诉您当前处于敏捷开发的哪个阶段，并推荐您下一步应该呼叫哪个智能体。
步骤 2：产品定义与需求分析（PM智能体）
开发的第一步不是写代码，而是明确需求。
- 在 AI IDE 聊天框中呼叫产品经理：
@PM智能体，我想要开发一个在线漫画阅读应用，请帮我梳理需求。 - Laufende Workflows：PM智能体会引导您执行
/create-prd工作流。它不会直接扔给你一堆废话，而是会通过一系列有针对性的问题（如核心用户群体、商业化考量等）来挖掘您的隐性需求。 - 最终，系统会在项目中自动生成一份标准化的产品需求文档（PRD）。
步骤 3：系统架构设计（Architect智能体）
拿到 PRD 后，我们需要技术设计。
- 呼叫架构师：
@Architect智能体，请根据刚刚生成的 PRD，为系统进行技术选型和架构设计。 - 架构师会读取 PRD 作为前置依赖，开始运行架构工作流。它会考虑数据库结构、API规范和前端框架，并生成详尽的架构决策记录（ADR文档）和系统蓝图。
步骤 4：任务拆解与上下文锁定（Scrum Master智能体）
这是BMAD最核心的防错机制。
- 让 Scrum Master 将庞大的架构拆解为具体任务：
@Scrum Master，请根据架构蓝图，创建开发阶段的用户故事（User Stories）。 - 它会生成包含完整上下文的 Story 任务文件。这意味着后续写代码时，AI 不会“忘记”之前定下的数据库结构或框架限制。
步骤 5：代码实现与测试（Dev与QA智能体）
- 呼叫开发者：
@Dev智能体，请执行 Story #1 进行代码编写。Dev 智能体会精准读取任务文件并开始写代码。 - 呼叫测试：
@QA智能体，请为刚才编写的功能补充单元测试并进行代码覆盖率检查。
三、 特色功能操作指南
1. 开启“派对模式”（Party Mode）
当遇到复杂的技术决策（例如：是否应该从 RESTful API 切换到 GraphQL）时，您可以同时召唤多个智能体展开辩论。
Beispiel für den Betrieb：
进入派对模式。@PM @Architect，请针对项目是否引入GraphQL进行讨论。PM请从交付周期和产品迭代角度出发，Architect请从系统性能和可维护性角度出发，最后给我一个统一的结论。
此时，您的 IDE 聊天窗口将变成一个会议室，您可以看到不同角色的思考碰撞，最终得出最优解。
2. 使用 BMad Builder 创建自定义智能体
如果您需要一个特定领域的AI助手（例如：一个严厉的代码审查员）。您可以调用内置的 BMad Builder 模块：
Beispiel für den Betrieb：
运行 create-agent 工作流，我要创建一个名叫“严厉的导师”的代码审查智能体。
框架会以互动问答的方式，帮您定义该智能体的人设、语气、技能边界，并自动将其整合进您的 .bmad-core 生态库中，使其可以无缝参与未来的代码审查工作。
Anwendungsszenario
- 从零构建全栈软件项目
对于独立开发者或初创团队，面对白板无从下手时。BMAD的结构化引导能帮助用户从粗略的“一句话想法”出发，逐步梳理出可执行的需求文档和系统架构，并稳定地输出高质量代码，有效避免了无休止的重构。 - 团队协作与需求对齐
在多人的企业级开发中，产品经理与程序员常常存在认知偏差。通过BMAD的架构师和Scrum Master智能体自动生成标准的系统边界说明和任务拆解文档，可以作为开发团队的执行圣经，保证团队对目标的理解完全一致。 - 遗留系统重构与维护
接手陈旧、无文档的复杂代码库时。可以指派“分析师”与“架构师”智能体对现有代码进行逆向工程，梳理业务逻辑和数据流向，生成可视化的架构文档，然后再安全地进行代码重构或迁移。 - 自定义AI开发流程建设
对于拥有特殊研发规范的公司（如特殊的合规审计、独特的代码提交规范等），可以通过 BMad Builder 创建自定义的智能体和专有工作流，将企业的开发规范硬编码到AI协作流程中，实现合规与效率的双赢。 - 复杂游戏项目的并行开发
利用BMAD的游戏开发扩展模块（Game Dev Studio），游戏设计师可以与专用的游戏架构智能体讨论Unity或Unreal中的渲染管道、实体组件系统（ECS）设计，并将策划案精准转化为游戏逻辑代码。
QA
- BMAD-METHOD是免费的吗？
完全免费且100%开源。没有付费墙，没有高级功能的订阅限制，旨在赋予每一个开发者使用顶级AI架构思维的能力。 - BMAD支持哪些开发环境或工具？
BMAD被设计为AI IDE的底层框架，它可以无缝集成到目前主流的AI代码编辑器中，包括但不限于 Cursor、Claude Code、Windsurf 等，利用这些工具的原生特性发挥最大效用。 - BMAD和传统的AI辅助工具（如普通对话或自动补全）有什么区别？
传统工具是你下达指令，AI去补全代码，极度依赖用户的提示词水平，且在长线开发中容易丢失上下文。BMAD不是替代你写代码的简单工具，而是提供了一套“AI专家团队”和“敏捷开发流水线”。它会主动引导你思考、拆解架构、锁定开发上下文，解决的是“软件工程规范”问题，而不仅是“代码生成”问题。 - 如果我在项目推进中卡壳了，不知道下一步该怎么做怎么办？
您可以随时在输入框中调用bmad-help技能。它是整个框架的智能向导，会读取当前项目目录下的文档状态，准确告诉你接下来应该补充哪个文档或指派哪位智能体干活。 - 我不懂Python，框架基于Node和Python可以只开发前端项目吗？
可以的。Node.js 和 Python 仅仅是 BMAD 框架自身运行时所依赖的底层环境工具。安装完毕后，您完全可以使用它来指导和开发任何语言、任何领域的技术项目，如纯前端的 Vue/React 项目、Rust后端服务或是移动端App。
