BMad Method 工作流地图Workflow Map完全指南四阶段渐进式上下文构建与实战工作流详解【免费下载链接】BMAD-METHODBreakthrough Method for Agile Ai Driven Development项目地址: https://gitcode.com/gh_mirrors/bm/BMAD-METHOD导读BMad MethodBMM是 BMAD-METHOD 开源仓库中专注于上下文工程Context Engineering与规划最佳实践的模块它通过 4 个截然不同的阶段让 AI Agent 在每一步都拿到该建什么、为什么建的清晰上下文。本文以 docs/vi-vn/reference/workflow-map.md 为核心骨架完整梳理分析、规划、解决方案设计、实施四个阶段的全部工作流workflow与产出物并结合仓库内真实 skill 源码与交互式图表帮你掌握何时调用哪个bmad-*技能、如何用project-context.md约束 Agent 行为从而在自己项目中直接落地这套可复制的 AI 驱动交付流水线。一、BMad Method一张地图看懂四阶段交付BMad MethodBMM的核心设计哲学是AI Agent 只有在拥有清晰、结构化上下文时才能高效工作。因此 BMM 将交付过程划分为 4 个独立阶段每个阶段内部包含若干可选工作流workflow而每个工作流都会产出文档——这些文档正是下一阶段的输入。文档链由此递进Agent 始终知道建什么、为什么建。这一设计的思想来源是行业中被广泛验证的Agile 方法论BMM 只是把敏捷的上下文传递环节用文档产物显式固化下来。若在任何时刻不确定下一步该做什么可直接运行bmad-helpskill——它会根据你当前的项目状态与已安装模块给出实时的、完全交互式的下一步建议比翻阅文档更快如果你额外安装了扩展模块bmad-help也会随之扩展始终了解全部可用能力。注意以下所有工作流都可以直接用你选择的工具通过 skill 运行或者先加载 Agent 再通过其菜单中的触发器trigger调用。两种方式对应 docs/vi-vn/reference/commands.md 中介绍的 Skill 与 Agent Menu Trigger 机制——前者适合你已明确知道要跑哪个工作流后者适合已在某个 Agent 会话中想切换任务而不退出对话。仓库在docs-site/public/workflow-map-diagram.html提供了对应的可视化交互图表由 Astro 文档站点生成样式配色对应四个阶段分析#0ea5e9、规划#22c55e、解决方案设计#eab308、实施#ef4444原文档通过iframe内嵌该图也可在新标签页打开查看。二、阶段 1分析可选——在承诺规划前验证问题空间分析阶段的目标是在投入规划之前探索问题空间并验证想法。此阶段所有工具均为可选但如果完全跳过分析PRD 将建立在假设而非真实理解之上——正如 docs/vi-vn/explanation/analysis-phase.md 所警告的模糊输入 → 模糊 PRD → 风险层层传导到架构与 story。工作流目的产出bmad-brainstorming由头脑风暴引导者brainstorming coach主持进行受控的创意发散brainstorming-report.mdbmad-deep-recon验证假设或在方案间做选择——可为你的深度研究工具起草提示词、加工其报告或直接在此研究覆盖市场、领域业务、技术、竞争、用户之声、学术研究结果经过核实、带有引用、可刷新研究报告或摘要 可选的 HTML 简报bmad-product-brief记录战略愿景——最适合 concept 已较为清晰时product-brief.mdbmad-prfaqWorking Backwards亚马逊倒推法——对产品概念进行压力测试与打磨prfaq-{project}.md各工具适用场景速查结合分析阶段说明文档四个工具分别从不同角度切入可按下表选择你的处境推荐工具我有一个模糊想法不知从何开始Brainstorming我需要先理解市场再决策Researchdeep-recon我已经知道要建什么只需记录Product Brief我要确认这个想法真的值得做PRFAQ我想先探索、再验证、再记录Brainstorming → Research → PRFAQ 或 BriefProduct Brief 与 PRFAQ 都产出 PRD 的输入二选一即可Brief 是协作式 discoveryPRFAQ 是严苛的考验——写不出有说服力的新闻稿说明产品还没准备好FAQ 暴露的空白正是你日后会在实施期以更高成本发现的空白。仓库中对应 skill 的真实目录结构印证了这些能力例如 skills/bmad-brainstorming/含brain-methods.csv方法库、brain.py选择脚本及其单元测试 test_brain.py、skills/bmad-deep-recon/内置 6 类研究模板types/与recon_kit.py、skills/bmad-product-brief/含brief-template.md以及 skills/bmad-prfaq/含 press-release、customer-faq、internal-faq、verdict 等参考文件。三、阶段 2规划——确定建什么、为谁建规划阶段回答两个问题建什么、为谁建。本阶段的产出直接决定后续架构与实现的质量。工作流目的产出bmad-prd定义需求功能需求 FR / 非功能需求 NFRPRD.mdbmad-ux当 UX 是关键要素时设计用户体验DESIGN.md、EXPERIENCE.mdbmad-spec将任意意图输入brief、PRD、转录稿、笔记蒸馏为精炼的SPEC.md契约及配套文件——先锁定做什么再谈怎么做SPEC.md 配套文件位于{output_folder}/specs/spec-{slug}/从源码看这三个工作流的实现PRDskills/bmad-prd/ 提供prd-template.md模板、prd-validation-checklist.md校验清单、headless-schemas.md无头模式 schema以及validate.md参考——PRD 是后续所有文档的上游事实来源。UXskills/bmad-ux/ 是仓库中最丰富的模块之一assets/下包含design-directions.md、key-screens.md、color-themes.md及多个设计示例editorial / mobile / shadcn同时提供headless-schemas.md与validate.md说明 UX 工作流既可产出面向人的设计文档也可产出结构化 schema 供后续实现消费。SPECskills/bmad-spec/ 实现了意图蒸馏能力——spec-template.mdstories-schema.md把 PRD、brief 等松散输入收敛成单一契约文件。SPEC 是 BMM 中连接规划与实现的关键桥梁它把 CO 与 HOW 分离让实现阶段无需回溯大量上游文档。四、阶段 3解决方案设计Solutioning——决定怎么建、拆成哪些 story本阶段决定如何构建并把需求拆解为可交付的工作单元。工作流目的产出bmad-architecture明确技术决策architecture.md含 ADRbmad-create-epics-and-stories将需求分解为可实施的 epic / story包含 story 的 epic 文件bmad-sprint-planning实施前的就绪门禁readiness gate检查随后跟踪 story 并查看 sprint 状态PASS / CONCERNS / FAIL sprint-status.yaml就绪门禁的判定逻辑源码级sprint-planning的三态判定并非随意输出而是有明确的判定规则。在 skills/bmad-sprint-planning/references/readiness-gate.md 中定义PASS计划可以构建用一句话陈述结论若用户请求的是完整 sprint 规划意图继续进入generate-tracking.md生成跟踪CONCERNS简要列出缺口及所在位置询问用户是继续还是先修复FAIL计划按当前记录不可实施按严重程度排序呈现发现指出可修复该问题的 skill相关规划 skill或用于跨切面变更的bmad-correct-course并可将结论保存为{planning_artifacts}/implementation-readiness.md后停止。该模块还提供sprint-status-template.yaml模板与scripts/sprint_plan.py实现配套测试见 test_sprint_plan.py并有generate-tracking.md、status-view.md、validate.md、fix-sprint-status.md等参考覆盖生成跟踪 → 查看状态 → 校验 → 修复的完整闭环。五、阶段 4实施——所有输入汇入 bmad-build实施阶段遵循一个关键原则所有实施入口都汇入bmad-build。它接收直接意图、issue、规格或已规划的 story并自行选择所需的澄清、规划、实现和审查深度。工作流目的产出bmad-build将直接意图或已规划 story 转化为已实现并经过审查的代码spec-*.md 代码bmad-code-review检验实现质量通过或请求变更bmad-correct-course处理 sprint 中途的重大变更更新的计划或重新路由bmad-retrospectiveepic 完成后复盘经验教训直接入口 vs 规划入口目标清晰的小任务可以直接进入bmad-build而更大的项目则可以先在前面阶段准备好 PRD、UX、架构、epics、stories、就绪检查与 sprint 计划。关键区别在于上游产物只是为实施提供更丰富的上下文并不会选择另一条实施工作流——实施路径始终收敛于bmad-build。仓库中对应 skill 均真实存在skills/bmad-code-review/含 step-01 至 step-04 的分步流程与 review-prompts/ 下的 edge-case-hunter、verification-gap 审查视角、skills/bmad-correct-course/含 checklist.md、skills/bmad-retrospective/含git_evidence.py、sprint_status.py及其测试、多份复盘文档模板。此外 skills/bmad-walkthrough/ 提供了构建完成后的代码走查能力对应交互图数据可在 docs-site/src/diagrams/walkthrough-run.labels.json 中查看其五步流程Orientation → Walkthrough → Detail Pass → Testing → Wrap-Up。六、上下文管理文档即上下文链式驱动 Agent 决策BMM 最重要的隐性机制是上下文链每一份文档都会成为下一阶段的上下文。PRD告诉架构师哪些约束重要架构文档告诉开发 Agent 该遵循哪些模式story 文件为实施提供聚焦而完整的上下文。如果缺少这套结构Agent 会做出不一致的决策——这正是 docs/vi-vn/explanation/project-context.md 中反复强调的问题没有明确指引时Agent 可能套用与代码库不匹配的通用最佳实践、在 story 之间风格漂移、遗漏项目特有约束。project-context.md项目的宪法:::tip[官方建议] 创建project-context.md确保 AI Agent 遵循你项目的规则与偏好。这个文件就像项目的宪法贯穿所有工作流指导实施决策。它是可选文件可在架构产出阶段末尾创建也可在既有项目中生成以记录需要与现有约定保持同步的关键事项。 :::两种创建方式手动创建——在_bmad-output/project-context.md写入技术栈与实施规则mkdir -p _bmad-output touch _bmad-output/project-context.md自动生成——运行bmad-generate-project-context从 architecture 文档或现有代码库自动提取生成。该文件在任何项目阶段都有价值新项目可在架构前手动创建以让架构师尊重你的技术偏好架构完成后可自动生成以记录已定决策既有项目可运行bmad-generate-project-context让 Agent 探测并遵循既有代码约定。其默认位置为_bmad-output/project-context.md各工作流会在此查找同时也会检查项目中任意位置的**/project-context.md。从文档结构看该文件包含两个核心章节Technology Stack Versions记录框架、语言与工具及具体版本例如Node.js 20.x, TypeScript 5.3, React 18.2Critical Implementation Rules记录 Agent 仅凭阅读代码难以推断的模式与约定——如 strict mode 开启、禁止未经批准的any、组件目录组织、测试模式、统一错误处理handleError等。原则是只记录不明显的规则无需重复放之四海皆准的标准实践。各实施类工作流bmad-architecture、bmad-code-review、bmad-build、bmad-sprint-planning、bmad-retrospective、bmad-correct-course都会在存在该文件时自动加载它以确保决策与项目规则对齐。七、Agent 视角谁负责执行这些工作流工作流地图中的每个 skill 均可由默认 Agent 通过菜单触发器调用。根据 docs/vi-vn/reference/agents.mdBMMAgile suite随 BMad Method 一同安装的默认 Agent 如下AgentSkill IDTrigger 示例主要工作流AnalystMarybmad-analystBP、MR、DR、TR、CB、WB、DPBrainstorm、市场/领域/技术研究、Create Brief、PRFAQ Challenge、Document ProjectProduct ManagerJohnbmad-pmCP、VP、EP、CE、IR、CCCreate/Validate/Edit PRD、Create Epics and Stories、Implementation Readiness、Correct CourseArchitectWinstonbmad-architectCA、IRCreate Architecture、Implementation ReadinessDeveloperAmeliabmad-agent-devBD、QA、CR、SP、ERBuild、QA Test Generation、Code Review、Sprint Planning、Epic RetrospectiveUX DesignerSallybmad-ux-designerCUCreate UX Design例如在 Agent 会话中输入CPCreate PRD即可进入规划阶段工作流输入BDBuild则直接进入实施。这与工作流地图形成了完美的对应关系地图告诉你有哪些工作流Agent 参考页告诉你由谁、用什么触发器来执行它们。八、一张图的落地实践如何用这张地图驱动你的项目综合以上内容将工作流地图应用到实际项目中的推荐路径是不确定从哪开始运行bmad-help或输入bmad-help 你的处境描述它会结合项目状态推荐起点想法模糊→ 走阶段 1 分析bmad-brainstorming发散 →bmad-deep-recon验证市场/技术假设 → 需要记录愿景用bmad-product-brief需要严苛考验用bmad-prfaq进入阶段 2 规划bmad-prd定 FR/NFRUX 敏感场景补bmad-ux需要单一契约时用bmad-spec蒸馏出SPEC.md阶段 3 解决方案设计bmad-architecture记录技术决策含 ADR→bmad-create-epics-and-stories拆 story →bmad-sprint-planning执行就绪门禁PASS/CONCERNS/FAIL并生成sprint-status.yaml跟踪阶段 4 实施所有工作汇入bmad-build完成实现与自审bmad-code-review把关质量中途重大变更走bmad-correct-courseepic 收官用bmad-retrospective沉淀教训全程维护_bmad-output/project-context.md让每个阶段、每个 Agent 都对齐同一套项目规则。九、相关参考分析阶段各工具深度说明docs/vi-vn/explanation/analysis-phase.mdproject-context 完整指南docs/vi-vn/explanation/project-context.mdSkill 与 Agent Menu Trigger 机制docs/vi-vn/reference/commands.md默认 Agent 与触发器对照表docs/vi-vn/reference/agents.md交互式工作流地图docs-site/public/workflow-map-diagram.html全部 BMM skill 源码目录skills/每个bmad-*子目录均含SKILL.md、customize.toml与module-manifest.toml可对照查看工作流细节与可定制配置项【免费下载链接】BMAD-METHODBreakthrough Method for Agile Ai Driven Development项目地址: https://gitcode.com/gh_mirrors/bm/BMAD-METHOD创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考