BMAD-Method 如何在 Trae 中用于“产品规划阶段”（新手版）

这份文档专门讲 产品规划阶段：从想法/问题整理，到产出 `product-brief`、`PRD`（可选 `ux-spec`）。 不展开后续架构和开发实现，只讲你在 Trae 里如何把 BMAD 跑顺。

定位说明：本页是补充教程（教程版）。整体主线请以同目录的 `index.html` 为准； 执行过程中需要快速查询命令/阶段/产物时，配合使用 速查版。

你会学到
安装 BMAD 到 Trae、理解规则文件、执行规划 workflow
适合对象
新手产品经理、独立开发者、技术负责人做前期规划
输出结果
`product-brief.md` / `PRD.md` / 可选 `ux-spec.md`

1. 这份教程解决什么问题

你现在的问题通常不是“不会写需求”，而是：

  • 不知道 BMAD 在产品规划阶段到底先跑哪个 workflow。
  • 官方文档多用 slash command 表达，但你实际在用 Trae，不清楚怎么落地。
  • 会生成很多内容，但不知道哪些文档是“规划阶段必需品”。
本教程目标
  • 讲清 BMAD 的规划流程顺序（先分析、再规划）。
  • 讲清 Trae 里的实际操作入口（Rules 文件）。
  • 给出新手最小可执行路径，避免一开始就跑太多流程。
不包含内容
  • 不展开 Phase 3 架构设计（architecture）。
  • 不展开 Phase 4 开发故事流（create-story/dev-story）。
  • 不讨论企业级治理/合规流程。
与另外两份文档的关系
  • `index.html`：主线资料（安装、模块、Trae 使用方式、案例驱动产品流程、交付）。
  • 本页（教程版）：产品规划阶段的详细步骤与 Trae 实操说明。
  • 速查版：执行过程中随时查询命令/阶段/产物/排错。

2. BMAD-Method 是什么（规划视角）

BMAD-Method 的核心价值不是“直接替你写文档”，而是通过一组有角色分工的 workflow，把上下文逐步沉淀， 让后续 AI 产出更稳定、更可追溯。

BMAD 官方四阶段（你当前重点是前两阶段）

阶段 作用 你现在要不要做 典型产出
Phase 1 Analysis 想法澄清、研究、产品 brief 建议做（至少做 product brief） `product-brief.md`、研究结果
Phase 2 Planning 需求与范围定义 必须做 `PRD.md`、可选 `ux-spec.md`
Phase 3 Solutioning 架构与 Epic/Story 拆分 本教程不展开 `architecture.md` 等
Phase 4 Implementation 按 story 开发与评审 本教程不展开 代码、测试、评审结果

为什么新手在规划阶段适合用 BMAD

  • 先固定“问题和目标”，再写需求，减少功能堆砌。
  • workflow 有顺序，能避免你跳步骤（比如没目标就写 PRD）。
  • `/bmad-help`（或对应规则）可以在卡住时提示下一步。

3. Trae 中如何理解 BMAD 命令（重点）

BMAD 官方文档经常写成 slash command（例如 `/bmad-bmm-create-prd`）。在 Trae 集成里， 安装器会把这些入口生成到 `.trae/rules/` 下，作为规则文件使用。

关键映射关系
  • 官方文档中的“命令名” = 你在 Trae 中要找到/启用的规则名（文件名通常一致）。
  • 例如：`/bmad-bmm-create-prd` 对应 `.trae/rules/bmad-bmm-create-prd.md`。
  • 例如：`/bmad-help` 对应 `.trae/rules/bmad-help.md`。

Trae 里的调用方式（版本可能有差异）

  • 常见方式 1：在 Trae 的 Rules 面板里选择对应 `bmad-*` 规则。
  • 常见方式 2：在 AI 对话里用规则引用（部分版本支持快捷引用）。
  • 如果你不确定入口：先打开 `.trae/rules/` 看是否生成了 `bmad-*.md` 文件，再按 Trae 当前版本 UI 调用。
实操建议

教程中我会继续使用 BMAD 的官方命令名（如 `bmad-bmm-create-prd`）描述流程。 在 Trae 里，你把它理解为“调用同名规则文件”即可。

4. 安装与环境准备（Trae）

4.1 前置条件

  • Node.js 20+
  • Trae（打开你的项目目录）
  • Git（推荐）
  • 一个明确的问题或产品想法（哪怕很粗糙）

4.2 安装 BMAD（在你的项目目录执行）

npx bmad-method install

安装过程中：

  • 选择安装目录（通常当前项目目录）。
  • 选择 AI 工具时，选择 Trae。
  • 选择模块时，新手一般选择 BMad Method (BMM) 即可。

4.3 安装完成后你应该看到什么

路径 作用 为什么重要
`_bmad/` BMAD 的 agents/workflows/task 配置 规则文件会指向这里的真实 workflow
`_bmad-output/` 产物输出目录 你的 `PRD.md` 等文档会出现在这里
`.trae/rules/` Trae 规则入口（BMAD 集成生成） 你在 Trae 里调用 BMAD 的“入口清单”

4.4 快速自检（建议做）

# 在项目根目录执行 ls -la ls -la .trae/rules | head ls -la _bmad ls -la _bmad-output

你至少应确认：`.trae/rules/` 中已经出现多个 `bmad-*.md` 文件。

5. 新手产品规划流程（BMAD + Trae）

这是面向新手的最小可执行路径。原则：先跑通主线，再补可选项。

先用 `bmad-help` 定位起点 在 Trae 中调用 `bmad-help` 对应规则（官方文档写法是 `/bmad-help`），让它根据当前项目状态告诉你下一步。
（可选）Brainstorming：先把问题空间讲清楚 如果你的想法还很散、还没明确要解决谁的问题，可以先用 `bmad-brainstorming`。
（可选）Research：补证据而不是拍脑袋 用 `bmad-bmm-research` 做市场/场景/技术限制研究，避免 PRD 建在错误假设上。
建议：先做 Product Brief 用 `bmad-bmm-create-product-brief` 形成战略层面简版说明，给 PRD 提供稳定上文。
必须：创建 PRD 用 `bmad-bmm-create-prd` 定义需求、范围、约束、验收口径，这是规划阶段核心产物。
（可选）UI 产品做 UX Spec 如果是 Web/App 界面产品，再用 `bmad-bmm-create-ux-design` 产出 `ux-spec.md`。
停止在规划阶段，做交接确认 本教程到这里结束。你应已具备进入架构设计（Phase 3）的输入材料。

6. 每一步怎么在 Trae 里执行（详细版）

BMAD 官方建议：每个 workflow 使用新会话（fresh chat）。 在 Trae 中照样适用。原因很简单：减少上下文污染，避免前一个流程的语气/假设误导后一个流程。

6.1 Step A：先调用 `bmad-help`（推荐固定起手式）

在 Trae 里做什么
  • 打开项目根目录（确保能访问 `_bmad` 和 `_bmad-output`）。
  • 在 AI 对话中调用 `bmad-help` 对应规则（或选择 `.trae/rules/bmad-help.md`）。
  • 告诉它你的目标：例如“我要在产品规划阶段为一个 SaaS 想法产出 PRD”。
建议输入（新手可直接改）
我在用 Trae + BMAD，当前目标是完成产品规划阶段（Analysis + Planning）。 我有一个想法：为中小团队做一个轻量任务协作工具。 请告诉我应该先跑哪些 BMAD workflow，并按新手路径给出顺序。

6.2 Step B：`bmad-bmm-create-product-brief`（建议执行）

这是新手最容易跳过、但实际上最值钱的一步。它能把“想法”收敛成“规划输入”。

你要提供的信息
  • 目标用户是谁
  • 核心问题是什么
  • 为什么现在要做
  • 成功大概怎么判断
你要拿到的结果
  • 问题/机会描述
  • 目标用户与场景
  • 高层目标与范围边界
  • 为后续 PRD 提供统一口径
Trae 实操建议
  • 单独开新会话执行该规则。
  • 先给事实，再给判断（比如反馈、数据、竞品观察）。
  • 让它输出后，你先人工删掉空话，再继续下一步。

6.3 Step C：`bmad-bmm-create-prd`（规划阶段核心）

这一步是主菜。BMAD 的 PM workflow 会围绕需求、约束、FR/NFR、边界等生成 PRD。

执行前检查（建议）
  • `product-brief` 已完成（至少有一版）。
  • 你已经能清楚说出“这轮要解决什么问题”。
  • 你知道哪些内容明确不做（哪怕只是第一版）。
建议输入（新手版）
请使用 BMAD 的 PRD workflow 帮我生成产品规划阶段 PRD。 上下文： - 产品方向：轻量任务协作工具 - 目标用户：10-50人团队负责人 - 当前主要问题：注册后首次建任务路径不清晰，激活率低 - 本轮目标：提高首次建任务完成率与邀请成员率 - 本轮不做：复杂自动化规则、多端改版 请在生成过程中优先确保： 1) 范围边界明确 2) 功能优先级可解释 3) 验收标准可验证 4) 风险和依赖单独列出
新手重点关注（不是“文档字数”）
  • 目标和指标是否可验证，而不是“提升体验”。
  • 本期不做的内容是否写清楚。
  • FR / NFR 是否与目标相关，而不是需求堆砌。
  • 依赖项是否能让研发/设计提前识别风险。

6.4 Step D：`bmad-bmm-create-ux-design`（UI产品建议做）

如果你的产品涉及明显的用户界面流程（Web/App/后台系统），建议在 PRD 后做这一步。

何时该做
  • 你有多页面/多步骤流程。
  • 你担心信息架构或交互路径不清晰。
  • 你需要先对齐 UX 再进入架构/开发拆解。

如果是纯后端能力或非常小的功能变更，这一步可以先跳过。

6.5 何时停下（你已经完成规划阶段）

停止条件

当你已经有一版稳定的 `product-brief`（建议）+ `PRD`（必须）+ `ux-spec`（可选），并且团队能回答： “这轮做什么、不做什么、为什么这样排优先级、成功怎么判断”，就可以结束本教程范围，进入架构阶段。

7. 你应该产出的文档（规划阶段）

以下是新手最实用的产物清单。不是越多越好，而是要支持后续阶段使用。

文档 对应 BMAD workflow 规划阶段是否必须 用途
`product-brief.md` `bmad-bmm-create-product-brief` 建议 统一问题定义、目标和高层范围，给 PRD 做上文
`PRD.md` `bmad-bmm-create-prd` 必须（BMad Method 轨道） 明确需求、范围、约束、验收口径，是规划核心文档
`ux-spec.md` `bmad-bmm-create-ux-design` 按需 补充界面流程与用户体验细节，减少后续反复

输出目录怎么看

  • BMAD 会把产物写入 `_bmad-output/`（通常在其子目录中组织）。
  • 新手不要手工在多个地方复制粘贴版本，保持单一权威文档版本。
  • 每完成一个 workflow，先做一次人工审阅，再进入下一步。

规划阶段交付完成检查（给自己/团队）

  • 团队能复述本轮目标用户和核心问题，且表述一致。
  • PRD 中有明确范围边界（做什么 / 不做什么）。
  • 至少 1-2 个成功指标可观察且有统计口径。
  • 关键依赖和风险已写入文档，不是口头约定。

8. 常见错误与纠偏（新手高频）

错误 1
一上来直接跑 `create-prd`

结果通常是 PRD 很长但目标模糊。纠偏：先至少完成一版 `product-brief`，再进 PRD。

错误 2
把 BMAD 当成“自动写稿器”

你不提供约束和边界，AI 会补全成泛化内容。纠偏：输入时明确目标、范围、不做项、验收标准。

错误 3
在一个 Trae 会话里跑完所有流程

上下文会混乱，后面的 workflow 容易继承错误假设。纠偏：每个 workflow 新会话。

错误 4
不知道 Trae 如何“调用命令”

BMAD 在 Trae 里主要表现为 `.trae/rules` 规则文件。纠偏：先确认文件生成，再从 Rules 面板调用对应规则。

一个务实的执行节奏（建议）

第1次会话：bmad-help（确认路径） 第2次会话：create-product-brief（拿到第一版） 第3次会话：create-prd（生成 PRD 初稿） 第4次会话：create-prd（基于你的修订意见做第二版） 第5次会话：create-ux-design（如果是 UI 产品）

这样做比“一次出终稿”更稳，且更符合 BMAD 的结构化协作方式。

9. FAQ

Q1：官方文档写 `/bmad-help`，但我在 Trae 里没看到 slash command，怎么办？

先检查 `.trae/rules/` 是否存在 `bmad-help.md` 与其他 `bmad-*.md` 文件。BMAD 在 Trae 的集成是通过规则文件落地的。 你需要在 Trae 当前版本的 Rules 入口调用它，而不是强依赖 slash command UI。

Q2：产品规划阶段一定要做 research 吗？

不一定，但如果你对用户、场景、竞品、技术约束缺乏把握，建议做。Research 的价值是减少“错方向的高质量 PRD”。

Q3：小功能也要走 PRD 吗？

不一定。BMAD 有 Quick Flow（`bmad-bmm-quick-spec`）适合小改动。你这次是“产品规划阶段”教程场景，因此重点讲 BMad Method 轨道的 `PRD`。

Q4：我应该先写自己的草稿，还是先让 BMAD 生成？

先写一个短草稿（目标、问题、范围、不做项），再让 BMAD workflow 扩展。这样比完全空白输入更稳定。

Q5：什么时候进入下一阶段（架构）？

当 `PRD` 稳定、范围边界明确、目标可验证、关键风险已记录，且团队对“这轮做什么”没有根本分歧时，就可以进入 Phase 3（架构）。