本文由 莫潇羽@无忆研习社 原创撰写,全网独家深度解析。未经授权,禁止转载。如需转载,请联系 www.wuyi.wiki 获取授权并注明出处。
引言:AI 编程工具的「阿喀琉斯之踵」
从 Cursor 到 Claude Code,再到 GitHub Copilot,各种 AI 编程工具如雨后春笋般涌现,几乎将编程的入门门槛降到了前所未有的低点。一个完全不懂代码的普通人,现在也能通过自然语言描述自己的需求,让 AI 帮忙生成一段可运行的程序。这听起来像是程序员的福音,但在实际的生产环境中,问题却逐渐浮现。
当项目规模从几十行代码膨胀到几千甚至几万行时,你会发现 AI 开始「健忘」。它不记得之前讨论过的架构决策,忘记了你们约定的代码规范,甚至在修复一个 Bug 的同时,悄悄引入三个新的问题。这种现象在业内被戏称为「Vibe Coding」——一种凭感觉、随缘式的编程方式。你把需求扔给 AI,然后祈祷它能理解你的意图,产出符合预期的代码。运气好的时候,一切顺利;运气不好的时候,你可能需要花费比手写代码更多的时间来调试和修正 AI 的「杰作」。
莫潇羽在无忆研习社长期关注 AI 辅助开发领域,经过大量实践测试后发现:AI 编程工具真正缺失的,并不是写代码的能力——事实上,现在的大语言模型在代码生成方面已经相当出色。真正的痛点在于,AI 缺乏一套像人类专业开发团队那样严谨的「工程纪律」。它不知道什么时候该写需求文档,什么时候该进行架构设计,什么时候该开始编码,什么时候该进行测试和代码审查。
正是在这样的背景下,一个名为 BMAD-METHOD 的开源项目应运而生,它正在重新定义 AI 辅助开发的游戏规则。
BMAD-METHOD 是什么?
BMAD 的全称是 Breakthrough Method of Agile AI-Driven Development,翻译过来就是「敏捷 AI 驱动开发的突破性方法论」。这个名字本身就揭示了它的核心理念:这不仅仅是一个工具或插件,而是一整套将敏捷开发最佳实践与 AI 能力深度融合的协作框架。
传统的 AI 编程工具采用的是「一对一」的交互模式——你提问,AI 回答,你再提问,AI 再回答。这种模式在处理简单任务时效果不错,但在面对复杂项目时却显得力不从心。原因很简单:AI 没有角色意识,没有流程概念,也没有文档驱动的工程思维。
BMAD-METHOD 彻底改变了这种范式。它的核心操作思路,是把一个完整的线下研发团队「搬进」AI 工具中。框架为用户配备了多达 21 个专业化的 AI Agent(智能代理),涵盖了软件开发生命周期的每一个关键角色。这些 Agent 各司其职、协同工作,就像一个训练有素的敏捷开发团队。
截止莫潇羽撰写本文时(2026年初),BMAD-METHOD 项目已经在 GitHub 上累积获得了超过 32000+ Star,成为 AI 辅助开发领域最受关注的开源项目之一。更重要的是,它正在被越来越多的开发者应用到实际的生产级项目中,用真实的案例证明了这套方法论的有效性。
BMAD-METHOD 的核心架构与工作原理
两大支柱:Agentic Planning 与 Context-Engineered Development
BMAD-METHOD 的设计哲学建立在两个核心支柱之上,这两个支柱共同解决了 AI 辅助开发中最棘手的两个问题:规划不一致性和上下文丢失。
第一支柱:Agentic Planning(代理驱动规划)
在这个阶段,专门的 AI 代理(如分析师、产品经理、架构师)会协同工作,创建高度详细和一致的产品需求文档(PRD)和架构设计文档。与传统的 AI 工具不同,BMAD 的规划代理不是简单地根据你的描述生成文档,而是通过一系列结构化的提问和引导,帮助你深入思考和完善你的想法。
这种「教练式」的互动方式确保了最终产出的规划文档不仅完整详尽,而且逻辑自洽、前后一致。更重要的是,这个规划阶段是「人机协作」的——AI 提供专业的引导和建议,但最终的决策权始终在你手中。
第二支柱:Context-Engineered Development(上下文工程化开发)
规划完成后,BMAD 的 Scrum Master 代理会将那些庞大的规划文档转化为「超详细」的开发故事(Story)。这些故事文件是自包含的,每一个都嵌入了完整的上下文信息、实现细节和架构指导。
当开发代理开始实现某个功能时,它不需要你重新解释项目背景——所有必要的信息都已经在故事文件中了。这种方法从根本上解决了「上下文崩溃」的问题,即随着项目复杂度增加,AI 对项目理解逐渐衰减的现象。
21 个专业化 AI Agent 的角色分工
BMAD-METHOD 的 Agent 团队配置相当强大,莫潇羽在无忆研习社为大家整理了主要角色的职责说明:
核心规划团队:
- Analyst(分析师):负责市场调研、竞品分析和头脑风暴。它会像一个经验丰富的教练一样,通过结构化的提问帮助你探索问题空间,澄清项目的核心价值主张和约束条件。最终产出是一份项目简报(Project Brief)。
- Product Manager / PM(产品经理):基于项目简报,创建详尽的产品需求文档(PRD)。这份文档包含功能需求、非功能需求、用户史诗(Epics)、用户故事(User Stories)以及 MVP 范围定义。PM 代理会确保每个需求都是可测试、可追踪的。
- Architect(架构师):根据 PRD 设计系统架构。这不仅包括技术栈选择,还涵盖组件设计、数据流、API 规范、安全架构和部署策略。架构师代理会生成可执行的技术规范,包括 Mermaid 格式的架构图。
- Product Owner / PO(产品负责人):负责文档对齐和验证。PO 代理会运行一个主检查清单,确保 PRD、架构文档和 UX 规范之间没有矛盾或遗漏。如果发现问题,它会指导其他代理进行修订。
开发执行团队:
- Scrum Master / SM(敏捷教练):将规划文档「分片」成可管理的开发单元,然后为每个史诗创建详细的用户故事。SM 代理确保每个故事都是自包含的,包含完整的上下文、验收标准和实现指导。
- Developer / Dev(开发者):基于故事文件实现代码。开发者代理会遵循既定的编码标准和架构约束,逐步完成功能实现,并在完成后运行验证(测试、Lint、安全扫描)。
- QA(质量保证工程师):审查代码实现,确保它符合原始需求和架构设计。QA 代理不仅测试功能,还会检查代码质量、建议优化,并在必要时要求重构。
专业支持角色:
- UX Designer(用户体验设计师):负责用户界面设计和用户体验优化,确保最终产品不仅功能完善,而且易用友好。
- BMad Master(BMad 大师):作为通用协调者,可以执行各种跨领域的任务,是团队的「万金油」角色。
- BMad Orchestrator(BMad 编排者):方法论专家和总协调者,负责引导用户选择最适合当前任务的代理,并可以动态切换到其他代理角色。
- Tech Writer(技术文档作者):负责撰写和维护项目的技术文档。
- Test Architect(测试架构师):设计测试策略和测试架构,确保项目具有全面的测试覆盖。
- Builder(构建者):允许用户创建自定义的代理和工作流,扩展 BMAD 的能力。
工作流程详解:从想法到代码的完整旅程
理解 BMAD-METHOD 的最佳方式是跟随一个完整的工作流程。无忆研习社的莫潇羽将以开发一个「QuickBuy 电商平台」为例,演示整个流程。
阶段一:战略基础(Strategic Foundation)
首先,你需要与分析师代理进行头脑风暴。你可能只有一个模糊的想法:「我想为小型企业创建一个现代化的电商平台」。分析师代理会引导你探索:
目标市场是什么?(拥有 10-500 种产品的小型企业)
主要竞争对手有哪些?(Shopify、Square Online、WooCommerce)
你的差异化优势在哪里?(60 秒快速建店、AI 驱动的产品优化)
核心价值主张是什么?(简化的入门流程、内置库存管理)
经过 30-45 分钟的引导式对话,你会得到一份结构化的项目简报。
接下来,产品经理代理接手,将项目简报转化为详细的 PRD。这个过程可能需要 45-60 分钟,PM 代理会问你超过 20 个问题,涵盖假设、约束、用户画像、数据流、SLA、非功能需求、风险等方面。最终产出是一份 20+ 节的结构化 PRD。
然后是架构师代理。它会基于 PRD 设计完整的系统架构,包括技术栈选择(框架、库、版本)、组件图、数据库设计、API 端点定义、安全策略、部署架构等。最终产出是一份可执行的技术规范,其中包含 Mermaid 格式的架构图。
最后,产品负责人代理运行主检查清单,验证所有文档的一致性。如果发现任何矛盾或遗漏,它会指导相应的代理进行修订。
阶段二:文档分片(Document Sharding)
这是 BMAD-METHOD 的「魔法」所在。PO 代理会将那些可能长达数十页的 PRD 和架构文档「分片」成更小、更聚焦的单元。
例如,一个完整的 PRD 可能被分片为:
- 用户认证模块史诗
- 产品目录模块史诗
- 购物车模块史诗
- 订单管理模块史诗
- ...
每个分片都是自包含的,包含该模块所需的所有背景信息。这种分片策略有两个重要好处:
一是减少了 token 消耗——AI 不需要每次都加载完整的规划文档,只需加载当前任务相关的分片。
二是提高了上下文精确度——每个代理只看到与其任务直接相关的信息,减少了无关信息的干扰。
阶段三:迭代开发(Iterative Development)
现在进入真正的编码阶段。Scrum Master 代理会从分片后的史诗文件中,为每个功能点创建详细的用户故事。每个故事包含:
- 完整的业务上下文(这个功能为什么重要)
- 相关的架构决策(应该如何实现)
- 实现细节和代码示例
- 验收标准(用 Given/When/Then 格式)
- 依赖项和阻塞项
- 相关文件路径
开发者代理基于这个故事文件进行实现。由于所有必要的上下文都在故事文件中,它不需要你额外解释任何背景。实现完成后,它会运行所有验证(单元测试、Lint、类型检查),然后将故事状态标记为「待审查」。
QA 代理接手审查。它不仅验证功能是否正确,还会检查代码是否符合架构设计、是否遵循编码标准、是否有潜在的性能或安全问题。如果发现问题,它会将故事退回给开发者代理并提供具体的改进建议。
这个循环(SM 起草故事 → Dev 实现 → QA 审查)不断重复,直到所有史诗中的所有故事都完成。
BMAD-METHOD 的独特优势
Scale-Adaptive Intelligence:自适应项目规模
BMAD-METHOD 最令人印象深刻的特性之一是它的「规模自适应智能」。框架能够根据项目的复杂度自动调整规划深度和流程严谨度。
Level 0 - 原子变更:修复一个 Bug、修改一个配置项、更新单个文件。这种情况下,BMAD 提供「快速通道」——只需要 /quick-spec 命令就能分析代码库并生成带有故事的技术规范,三步搞定,绝不啰嗦。
Level 1 - 小型功能:新增一个 API 端点、创建一个 UI 组件、编写一个工具函数。工作流:技术规范 → Sprint 规划 → 实现。预计 1-10 个故事。
Level 2 - 中型功能集:用户认证系统、仪表板模块、第三方 API 集成。工作流:产品简报(可选)→ PRD → 架构 → Sprint 规划 → 实现。预计 5-15 个故事。
Level 3 - 复杂集成:企业系统迁移、多服务架构、遗留代码现代化。工作流完整:分析 → PRD → 架构 → 文档分片 → Sprint 规划 → 迭代实现。预计 12-40 个故事。
Level 4 - 企业级扩展:全新的 SaaS 平台、大规模重构、多团队协作项目。完整工作流加上更严格的审查和验证。预计 40+ 个故事。
莫潇羽在无忆研习社的测试中发现,这种自适应能力极大地提高了开发效率——小任务不会被繁琐的流程拖慢,大项目也不会因为缺乏结构而失控。
Party Mode:让 AI 代理们「开会讨论」
这可能是 BMAD-METHOD 最有趣的功能之一。Party Mode(派对模式)允许你将多个 AI 代理拉到同一个会话中,让它们围绕某个问题进行讨论和辩论。
想象一下这个场景:你正在设计一个新功能,但不确定应该使用微服务架构还是单体架构。在 Party Mode 下,你可以把架构师代理和产品经理代理同时召唤出来。架构师可能会从技术可扩展性的角度支持微服务,而产品经理可能会从开发速度和市场时机的角度支持单体。你可以观察它们的讨论,从中获得多元化的视角,然后做出更明智的决策。
这种模式特别适合:
- 技术方案评审
- 需求澄清和优先级排序
- 风险识别和缓解策略讨论
- 团队模拟和培训
上下文工程:解决 AI「健忘症」的根本方案
BMAD-METHOD 的上下文工程策略是整个框架的技术核心。它通过多种机制确保 AI 始终拥有足够且精确的上下文信息:
文档分片(Document Sharding):大型规划文档被分割成聚焦的小块,代理只在需要时加载相关的分片。这种策略可以节省高达 90% 的 token 消耗。
依赖链(Dependency Chains):当开发代理需要实现认证功能时,它会自动引用架构师关于安全的决策和产品经理关于需求的定义。这种链式引用确保了决策的一致性。
决策可追溯性(Decision Traceability):每一个选择都链接回它的原始理由。当需求变更时,影响可以正确地传播到整个系统。
活文档(Living Documentation):文档不是静态的,它们会随着项目的演进而自动更新。这确保了代理始终使用最新的信息。
多 IDE 支持与工具无关性
BMAD-METHOD 的另一个优势是它的工具无关性。框架可以与几乎所有主流的 AI 编码助手配合使用:
- Claude Code(推荐):Anthropic 的命令行工具,与 BMAD 有最佳的原生集成
- Cursor:流行的 AI 驱动 IDE,支持自定义代理指令
- Windsurf:新兴的 AI 编程环境
- VS Code + GitHub Copilot:通过结构化注释块触发角色工作流
- Gemini CLI:支持保存的代理配置文件
- Codex:可以将指令用作 Codex 代理
- 其他:Roo、Cline、Auggie、Qwen、Rovo Dev 等
安装程序会根据你选择的 IDE 自动创建相应的配置文件和命令触发器。无论你习惯使用哪种工具,都能享受到 BMAD 的全部能力。
详细安装与配置指南
环境准备
在开始安装之前,请确保你的系统满足以下要求:
- Node.js 20+:BMAD-METHOD 是一个基于 Node.js 的工作流工具
- npm 或 npx:用于运行安装命令
- Git(可选但推荐):用于版本控制和团队协作
你可以通过以下命令检查 Node.js 版本:
node --version
如果版本低于 20,请访问 Node.js 官网 下载最新的 LTS 版本。
安装步骤
BMAD-METHOD 的安装非常简单,只需要一行命令:
npx bmad-method install
运行这个命令后,安装程序会启动一个交互式向导,引导你完成以下步骤:
步骤 1:选择目标目录
安装程序会询问你要在哪个目录安装 BMAD。通常,这应该是你项目的根目录。
? Where do you want to install BMad? (./my-project)
步骤 2:检测现有安装
如果你之前安装过旧版本的 BMAD(如 V4 或 V5),安装程序会自动检测并提供升级选项。它会保留你的自定义配置,同时更新核心功能。
步骤 3:选择 IDE
安装程序会展示一个支持的 IDE 列表,你可以选择一个或多个:
? Which IDE(s) will you use? (Press space to select)
❯◉ Claude Code (recommended)
◯ Cursor
◯ Windsurf
◯ GitHub Copilot
◯ Others
如果你选择了 Claude Code,安装程序还会询问你是否要启用 TTS(文字转语音)功能。
步骤 4:选择模块
BMAD-METHOD 采用模块化设计,你可以选择需要的功能模块:
- BMM(BMad Method):核心软件开发模块,大多数用户只需要这个
- BMGD(BMad Game Development):游戏开发专用模块
- CIS(Creative Intelligence Suite):创意智能套件,用于头脑风暴和研究
- BMB(BMad Builder):用于创建自定义代理和工作流
? Which modules do you want to install? (Press space to select)
❯◉ BMad Method (BMM) - Software development (recommended)
◯ BMad Game Development (BMGD) - Game development
◯ Creative Intelligence Suite (CIS) - Brainstorming & research
◯ BMad Builder (BMB) - Custom agents & workflows
步骤 5:配置选项
安装程序还会询问一些可选配置,例如:
- 是否启用文档自动分片
- 默认的输出文件夹位置
- 项目特定的配置变量
完成所有选择后,安装程序会在几秒钟内完成安装。
安装后的目录结构
安装完成后,你的项目目录会新增以下结构:
your-project/
├── _bmad/ # BMAD 安装根目录
│ ├── _config/ # 系统配置
│ │ └── core-config.yaml # 核心配置文件
│ ├── bmm/ # BMad Method 模块
│ │ ├── agents/ # 代理定义
│ │ ├── templates/ # 文档模板
│ │ ├── tasks/ # 可复用任务
│ │ ├── checklists/ # 质量检查清单
│ │ ├── workflows/ # 工作流定义
│ │ └── config.yaml # 模块配置
│ ├── core/ # 核心模块(必需)
│ └── web-bundles/ # Web UI 捆绑包(可选)
├── _bmad-output/ # 生成的工件输出目录
│ ├── docs/ # 文档输出
│ │ ├── prd.md # 产品需求文档
│ │ ├── architecture.md # 架构文档
│ │ └── stories/ # 故事文件
│ └── ...
└── .claude/ # Claude Code 命令(如使用 Claude Code)
└── commands/
├── bmad-help.md
├── pm.md
├── architect.md
├── dev.md
└── ...
验证安装
安装完成后,重启你的 IDE 或终端(这很重要,因为需要加载新的配置)。然后运行以下命令验证安装:
/bmad-help
或者在 Claude Code 中:
/bmad-help
如果看到 BMAD 的帮助信息和工作流初始化提示,说明安装成功。
常见安装问题排查
问题 1:npx 命令找不到
确保 Node.js 已正确安装,并且 npm 的全局包目录在你的 PATH 环境变量中。
问题 2:权限错误
在 Windows 上,尝试以管理员身份运行 PowerShell。在 Linux/Mac 上,不要使用 sudo,而是确保你对项目目录有写权限。
问题 3:安装程序找不到 bmad-v6 目录
确保你在正确的目录中运行安装命令。如果是手动克隆的仓库,请确保在仓库根目录运行。
问题 4:Claude Code 没有加载 BMAD 技能
Claude Code 在启动时加载技能。安装后必须重启 Claude Code 才能看到新安装的 BMAD 技能。
实战教程:从零开始的完整项目演练
莫潇羽在无忆研习社为大家准备了一个完整的实战演练,我们将从头开始创建一个「任务管理 API」项目,演示 BMAD-METHOD 的完整工作流。
第一步:初始化项目
首先,创建一个新的项目目录并进入:
mkdir my-todo-api
cd my-todo-api
然后安装 BMAD:
npx bmad-method install
按照向导选择 Claude Code 作为 IDE,安装 BMM 模块。
第二步:初始化工作流
启动 Claude Code:
claude
运行工作流初始化命令:
/workflow-init
BMAD 会询问你关于项目的基本信息:
Claude: Let's set up your project. What type of project is this?
- api (Backend API)
- web (Web application)
- cli (Command-line tool)
- fullstack (Full-stack application)
You: api
Claude: What's the name of your project?
You: Todo REST API
Claude: How complex is this project?
- Level 0: Single atomic change (1 story)
- Level 1: Small feature (1-10 stories)
- Level 2: Medium feature set (5-15 stories)
- Level 3: Complex integration (12-40 stories)
- Level 4: Enterprise expansion (40+ stories)
You: 1
Claude: Created bmad/config.yaml:
project_name: "Todo REST API"
project_type: "api"
project_level: 1
output_folder: "docs"
Project initialized! Run /workflow-status to see recommended next steps.
第三步:查看工作流状态
运行状态命令查看推荐的下一步:
/workflow-status
输出:
## Todo REST API - Workflow Status
### Project Info
- Type: api
- Level: 1 (Small feature)
- Output: docs/
### Phase Status
| Phase | Status | Next Action |
|-------------------------|-------------|------------------------|
| Phase 1 - Analysis | Not started | Optional: /product-brief |
| Phase 2 - Planning | Not started | Recommended: /tech-spec |
| Phase 3 - Solutioning | Not started | Waiting for Phase 2 |
| Phase 4 - Implementation| Not started | Waiting for Phase 3 |
### Recommendation
For a Level 1 project, start with `/tech-spec` to define your API endpoints and data model.
第四步:创建技术规范
对于小型项目(Level 1),我们可以跳过完整的 PRD,直接创建技术规范:
/tech-spec
BMAD 的 PM 代理会引导你定义 API 规范:
Claude: I'll help you create a tech spec for your Todo REST API.
What are the core entities in your system?
You: Tasks with title, description, status, and due date. Users who own tasks.
Claude: What API operations do you need?
- CRUD for tasks?
- User authentication?
- Task filtering/sorting?
You: Yes to all. Also need task assignment and status transitions.
Claude: What's your preferred tech stack?
- Language/Framework: (e.g., Node.js/Express, Python/FastAPI, Go/Gin)
- Database: (e.g., PostgreSQL, MongoDB, SQLite)
You: Python with FastAPI, PostgreSQL database.
Claude: Creating tech spec...
几分钟后,BMAD 会在 docs/tech-spec.md 生成一份详细的技术规范,包含:
- API 端点定义(RESTful 设计)
- 数据模型和数据库 schema
- 认证方案(JWT)
- 故事分解(例如:US-001 用户注册、US-002 用户登录、US-003 创建任务...)
- 技术栈确认
第五步:Sprint 规划
技术规范创建后,运行 Sprint 规划:
/sprint-planning
Scrum Master 代理会分析技术规范,并创建详细的 Sprint 计划:
Claude: I'll help plan your sprint for the Todo REST API.
Based on your tech spec, I've identified these stories:
Sprint 1 - Core Foundation
1. US-001: User Registration
- Endpoint: POST /api/users
- Acceptance: Users can register with email/password
- Story Points: 2
2. US-002: User Login
- Endpoint: POST /api/auth/login
- Acceptance: Users receive JWT token on valid credentials
- Story Points: 2
3. US-003: Create Task
- Endpoint: POST /api/tasks
- Acceptance: Authenticated users can create tasks
- Story Points: 3
...
Sprint plan complete! Use `/dev-story US-001` to start implementing.
第六步:实现第一个故事
现在开始实现第一个用户故事:
/dev-story US-001
开发代理会加载故事文件(包含完整的上下文和验收标准),然后开始实现:
Claude: Starting implementation of US-001: User Registration
## Context
- Endpoint: POST /api/users
- Request body: {email, password, name}
- Response: {id, email, name, created_at}
- Password must be hashed before storage
- Email must be unique
## Implementation Plan
1. Create User model in models/user.py
2. Create registration endpoint in routes/users.py
3. Add password hashing utility
4. Add email validation
5. Write unit tests
Starting implementation...
开发代理会逐步创建所需的文件,运行测试,并在完成后更新故事状态:
Claude: Implementation complete!
Created files:
- app/models/user.py
- app/routes/users.py
- app/utils/auth.py
- tests/test_users.py
Ran tests: 4 passed, 0 failed
Updated: docs/stories/US-001.md (status: complete)
Next: Run `/dev-story US-002` to implement User Login.
第七步:持续迭代
重复上述步骤,实现所有故事。每个故事完成后,BMAD 会自动更新项目状态。你可以随时运行 /workflow-status 查看进度。
当所有故事完成后,你会得到一个功能完整、文档齐全、测试覆盖的项目。
高级用法与技巧
自定义代理配置
BMAD 允许你通过 .customize.yaml 文件自定义代理行为。例如,你可以修改开发代理的默认编码风格:
# _bmad/bmm/agents/dev.customize.yaml
preferences:
code_style: "functional"
test_framework: "pytest"
prefer_type_hints: true
max_function_length: 30
这些自定义会在 BMAD 更新时保留,不会被覆盖。
创建自定义工作流
如果默认的工作流不满足你的需求,你可以使用 BMad Builder 模块创建自定义工作流:
/create-workflow
工作流使用 YAML 格式定义,你可以指定步骤序列、代理分配、依赖关系等。
扩展包:超越软件开发
BMAD-METHOD 的一个独特优势是它的领域无关性。虽然核心模块面向软件开发,但框架可以通过扩展包扩展到任何领域:
- 游戏开发扩展:包含游戏设计师、关卡设计师、游戏 SM 等代理
- 创意写作扩展:包含小说家、编辑、世界构建者等代理
- 商业策略扩展:包含市场分析师、战略规划师等代理
- 健康与保健扩展:包含健康教练、营养规划师等代理
莫潇羽在无忆研习社看到,BMAD 社区正在快速成长,越来越多的领域专家在贡献自己的扩展包。你也可以创建并分享自己的扩展。
代码库扁平化工具
BMAD 包含一个强大的代码库扁平化工具,可以将整个项目打包成一个 AI 友好的 XML 文件:
npx bmad-method flatten
这个工具会:
- 智能过滤:自动遵循 .gitignore 规则,排除不必要的文件
- 二进制检测:识别并排除二进制文件,只保留源代码
- 进度跟踪:显示实时进度和完成统计
生成的 XML 文件可以用于:
- 代码审查(让 AI 审查整个代码库)
- 架构讨论(让 AI 分析项目结构)
- 知识迁移(将项目上下文传递给新的 AI 会话)
与其他工具集成
BMAD-METHOD 可以与你现有的开发工具链无缝集成:
Git 集成:每个 BMAD 生成的工件(PRD、架构文档、故事文件)都可以纳入版本控制。这确保了:
- 每个变更都有完整的历史记录
- 多人协作时的冲突解决
- 基于 PR 的审查流程
CI/CD 集成:BMAD 的 QA 代理可以与你的 CI/CD 管道集成,在代码合并前进行自动化审查。
项目管理工具集成:故事文件的格式与 Jira、Linear 等项目管理工具兼容,可以轻松导入。
真实案例分析
案例一:Go 语言项目迁移到 TypeScript
一位开发者使用 BMAD-METHOD 将一个复杂的 Go 语言项目完整迁移到 T