企业官网建设流程全解析

BMad Method 工作流地图（Workflow Map）完全指南：四阶段渐进式上下文构建与实战工作流详解

【免费下载链接】BMAD-METHODBreakthrough Method for Agile Ai Driven Development项目地址: https://gitcode.com/gh_mirrors/bm/BMAD-METHOD

导读

BMad Method（BMM）是 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 Method（BMM）的核心设计哲学是：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。

各工具适用场景速查

结合分析阶段说明文档，四个工具分别从不同角度切入，可按下表选择：

Product Brief 与 PRFAQ 都产出 PRD 的输入，二选一即可：Brief 是协作式 discovery，PRFAQ 是严苛的考验——写不出有说服力的新闻稿说明产品还没准备好；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：规划——确定建什么、为谁建

规划阶段回答两个问题：建什么、为谁建。本阶段的产出直接决定后续架构与实现的质量。

从源码看这三个工作流的实现

• PRD：skills/bmad-prd/ 提供prd-template.md模板、prd-validation-checklist.md校验清单、headless-schemas.md无头模式 schema，以及validate.md参考——PRD 是后续所有文档的"上游事实来源"。
• UX：skills/bmad-ux/ 是仓库中最丰富的模块之一，assets/下包含design-directions.md、key-screens.md、color-themes.md及多个设计示例（editorial / mobile / shadcn），同时提供headless-schemas.md与validate.md，说明 UX 工作流既可产出面向人的设计文档，也可产出结构化 schema 供后续实现消费。
• SPEC：skills/bmad-spec/ 实现了"意图蒸馏"能力——spec-template.md+stories-schema.md把 PRD、brief 等松散输入收敛成单一契约文件。SPEC 是 BMM 中连接"规划"与"实现"的关键桥梁：它把 CO 与 HOW 分离，让实现阶段无需回溯大量上游文档。

四、阶段 3：解决方案设计（Solutioning）——决定怎么建、拆成哪些 story

本阶段决定如何构建，并把需求拆解为可交付的工作单元。

就绪门禁的判定逻辑（源码级）

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，并自行选择所需的澄清、规划、实现和审查深度。

直接入口 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 遵循你项目的规则与偏好。这个文件就像项目的"宪法"，贯穿所有工作流指导实施决策。它是可选文件，可在架构产出阶段末尾创建，也可在既有项目中生成，以记录需要与现有约定保持同步的关键事项。 :::

两种创建方式：

1. 手动创建——在_bmad-output/project-context.md写入技术栈与实施规则：

   mkdir -p _bmad-output touch _bmad-output/project-context.md

2. 自动生成——运行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.2；
• Critical 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.md，BMM（Agile suite）随 BMad Method 一同安装的默认 Agent 如下：

例如在 Agent 会话中输入CP（Create PRD）即可进入规划阶段工作流；输入BD（Build）则直接进入实施。这与工作流地图形成了完美的对应关系：地图告诉你有哪些工作流，Agent 参考页告诉你由谁、用什么触发器来执行它们。

八、一张图的落地实践：如何用这张地图驱动你的项目

综合以上内容，将工作流地图应用到实际项目中的推荐路径是：

1. 不确定从哪开始？运行bmad-help（或输入bmad-help <你的处境描述>），它会结合项目状态推荐起点；
2. 想法模糊→ 走阶段 1 分析：bmad-brainstorming发散 →bmad-deep-recon验证市场/技术假设 → 需要记录愿景用bmad-product-brief，需要严苛考验用bmad-prfaq；
3. 进入阶段 2 规划：bmad-prd定 FR/NFR，UX 敏感场景补bmad-ux，需要单一契约时用bmad-spec蒸馏出SPEC.md；
4. 阶段 3 解决方案设计：bmad-architecture记录技术决策（含 ADR）→bmad-create-epics-and-stories拆 story →bmad-sprint-planning执行就绪门禁（PASS/CONCERNS/FAIL）并生成sprint-status.yaml跟踪；
5. 阶段 4 实施：所有工作汇入bmad-build完成实现与自审，bmad-code-review把关质量，中途重大变更走bmad-correct-course，epic 收官用bmad-retrospective沉淀教训；
6. 全程维护_bmad-output/project-context.md：让每个阶段、每个 Agent 都对齐同一套项目规则。

九、相关参考

• 分析阶段各工具深度说明：docs/vi-vn/explanation/analysis-phase.md
• project-context 完整指南：docs/vi-vn/explanation/project-context.md
• Skill 与 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