bmad-method 6.0.4 → 6.0.5-next.0

package/docs/zh-cn/reference/workflow-map.md

@@ -0,0 +1,104 @@
+---
+title: "工作流程图"
+description: BMad Method 工作流程阶段与输出的可视化参考
+sidebar:
+  order: 1
+---
+
+BMad Method（BMM）是 BMad 生态系统中的一个模块，旨在遵循上下文工程与规划的最佳实践。AI 智能体在清晰、结构化的上下文中表现最佳。BMM 系统在 4 个不同阶段中逐步构建该上下文——每个阶段以及每个阶段内的多个可选工作流程都会生成文档，这些文档为下一阶段提供信息，因此智能体始终知道要构建什么以及为什么。
+
+其基本原理和概念来自敏捷方法论，这些方法论在整个行业中被广泛用作思维框架，并取得了巨大成功。
+
+如果您在任何时候不确定该做什么，`/bmad-help` 命令将帮助您保持正轨或了解下一步该做什么。您也可以随时参考此文档以获取参考信息——但如果您已经安装了 BMad Method，`/bmad-help` 是完全交互式的，速度要快得多。此外，如果您正在使用扩展了 BMad Method 或添加了其他互补非扩展模块的不同模块——`/bmad-help` 会不断演进以了解所有可用内容，从而为您提供最佳即时建议。
+
+最后的重要说明：以下每个工作流程都可以通过斜杠命令直接使用您选择的工具运行，或者先加载智能体，然后使用智能体菜单中的条目来运行。
+
+<iframe src="/workflow-map-diagram.html" title="BMad Method Workflow Map Diagram" width="100%" height="100%" style="border-radius: 8px; border: 1px solid #334155; min-height: 900px;"></iframe>
+
+<p style="font-size: 0.8rem; text-align: right; margin-top: -0.5rem; margin-bottom: 1rem;">
+  <a href="/workflow-map-diagram.html" target="_blank" rel="noopener noreferrer">在新标签页中打开图表 ↗</a>
+</p>
+
+## 阶段 1：分析（可选）
+
+在投入规划之前探索问题空间并验证想法。
+
+| 工作流程                        | 目的                                                                    | 产出                  |
+| ------------------------------- | -------------------------------------------------------------------------- | ------------------------- |
+| `bmad-brainstorming`            | 在头脑风暴教练的引导协助下进行项目想法头脑风暴 | `brainstorming-report.md` |
+| `bmad-bmm-research`             | 验证市场、技术或领域假设                          | 研究发现         |
+| `bmad-bmm-create-product-brief` | 捕捉战略愿景                                                   | `product-brief.md`        |
+
+## 阶段 2：规划
+
+定义要构建什么以及为谁构建。
+
+| 工作流程                    | 目的                                  | 产出     |
+| --------------------------- | ---------------------------------------- | ------------ |
+| `bmad-bmm-create-prd`       | 定义需求（FRs/NFRs）           | `PRD.md`     |
+| `bmad-bmm-create-ux-design` | 设计用户体验（当 UX 重要时） | `ux-spec.md` |
+
+## 阶段 3：解决方案设计
+
+决定如何构建它并将工作分解为故事。
+
+| 工作流程                                  | 目的                                    | 产出                    |
+| ----------------------------------------- | ------------------------------------------ | --------------------------- |
+| `bmad-bmm-create-architecture`            | 明确技术决策          | 包含 ADR 的 `architecture.md` |
+| `bmad-bmm-create-epics-and-stories`       | 将需求分解为可实施的工作 | 包含故事的 Epic 文件     |
+| `bmad-bmm-check-implementation-readiness` | 实施前的关卡检查           | PASS/CONCERNS/FAIL 决策 |
+
+## 阶段 4：实施
+
+逐个故事地构建它。即将推出完整的阶段 4 自动化！
+
+| 工作流程                   | 目的                                                                  | 产出                         |
+| -------------------------- | ------------------------------------------------------------------------ | -------------------------------- |
+| `bmad-bmm-sprint-planning` | 初始化跟踪（每个项目一次，以排序开发周期）         | `sprint-status.yaml`             |
+| `bmad-bmm-create-story`    | 准备下一个故事以供实施                                    | `story-[slug].md`                |
+| `bmad-bmm-dev-story`       | 实施该故事                                                      | 工作代码 + 测试             |
+| `bmad-bmm-code-review`     | 验证实施质量                                          | 批准或请求更改    |
+| `bmad-bmm-correct-course`  | 处理冲刺中的重大变更                                    | 更新的计划或重新路由       |
+| `bmad-bmm-automate`        | 为现有功能生成测试 - 在完整的 epic 完成后使用 | 端到端 UI 专注测试套件 |
+| `bmad-bmm-retrospective`   | 在 epic 完成后回顾                                             | 经验教训                  |
+
+## 快速流程（并行轨道）
+
+对于小型、易于理解的工作，跳过阶段 1-3。
+
+| 工作流程              | 目的                                    | 产出                                      |
+| --------------------- | ------------------------------------------ | --------------------------------------------- |
+| `bmad-bmm-quick-spec` | 定义临时变更                    | `tech-spec.md`（小型变更的故事文件） |
+| `bmad-bmm-quick-dev`  | 根据规范或直接指令实施 | 工作代码 + 测试                          |
+
+## 上下文管理
+
+每个文档都成为下一阶段的上下文。PRD 告诉架构师哪些约束很重要。架构告诉开发智能体要遵循哪些模式。故事文件为实施提供专注、完整的上下文。没有这种结构，智能体会做出不一致的决策。
+
+### 项目上下文
+
+:::tip[推荐]
+创建 `project-context.md` 以确保 AI 智能体遵循您项目的规则和偏好。该文件就像您项目的宪法——它指导所有工作流程中的实施决策。这个可选文件可以在架构创建结束时生成，或者在现有项目中也可以生成它，以捕捉与当前约定保持一致的重要内容。
+:::
+
+**如何创建它：**
+
+- **手动** — 使用您的技术栈和实施规则创建 `_bmad-output/project-context.md`
+- **生成它** — 运行 `/bmad-bmm-generate-project-context` 以从您的架构或代码库自动生成
+
+[**了解更多关于 project-context.md**](../explanation/project-context.md)
+
+---
+## 术语说明
+
+- **agent**：智能体。在人工智能与编程文档中，指具备自主决策或执行能力的单元。
+- **BMad Method (BMM)**：BMad 方法。BMad 生态系统中的一个模块，用于上下文工程与规划。
+- **FRs/NFRs**：功能需求/非功能需求。Functional Requirements/Non-Functional Requirements 的缩写。
+- **PRD**：产品需求文档。Product Requirements Document 的缩写。
+- **UX**：用户体验。User Experience 的缩写。
+- **ADR**：架构决策记录。Architecture Decision Record 的缩写。
+- **Epic**：史诗。大型功能或用户故事的集合，通常需要多个冲刺才能完成。
+- **Story**：用户故事。描述用户需求的简短陈述。
+- **Sprint**：冲刺。敏捷开发中的固定时间周期，用于完成预定的工作。
+- **Slug**：短标识符。URL 友好的标识符，通常用于文件命名。
+- **Context**：上下文。为 AI 智能体提供的环境信息和背景资料。

package/docs/zh-cn/roadmap.mdx

@@ -0,0 +1,152 @@
+---
+title: 路线图
+description: BMad 的下一步计划——功能、改进与社区贡献
+---
+
+# BMad 方法：公开路线图
+
+BMad 方法、BMad 方法模块（BMM）和 BMad 构建器（BMB）正在持续演进。以下是我们正在开展的工作以及即将推出的内容。
+
+<div class="roadmap-container">
+
+  <h2 class="roadmap-section-title">进行中</h2>
+
+  <div class="roadmap-future">
+    <div class="roadmap-future-card">
+      <span class="roadmap-emoji">🧩</span>
+      <h4>通用技能架构</h4>
+      <p>一个技能，任意平台。一次编写，随处运行。</p>
+    </div>
+    <div class="roadmap-future-card">
+      <span class="roadmap-emoji">🏗️</span>
+      <h4>BMad 构建器 v1</h4>
+      <p>打造生产级 AI 智能体与工作流，内置评估、团队协作与优雅降级。</p>
+    </div>
+    <div class="roadmap-future-card">
+      <span class="roadmap-emoji">🧠</span>
+      <h4>项目上下文系统</h4>
+      <p>AI 真正理解你的项目。框架感知的上下文，随代码库共同演进。</p>
+    </div>
+    <div class="roadmap-future-card">
+      <span class="roadmap-emoji">📦</span>
+      <h4>集中式技能</h4>
+      <p>一次安装，随处使用。跨项目共享技能，告别文件杂乱。</p>
+    </div>
+    <div class="roadmap-future-card">
+      <span class="roadmap-emoji">🔄</span>
+      <h4>自适应技能</h4>
+      <p>技能懂你的工具。为 Claude、Codex、Kimi、OpenCode 等提供优化变体，以及更多。</p>
+    </div>
+    <div class="roadmap-future-card">
+      <span class="roadmap-emoji">📝</span>
+      <h4>BMad 团队专业博客</h4>
+      <p>来自团队的指南、文章与见解。即将上线。</p>
+    </div>
+  </div>
+
+  <h2 class="roadmap-section-title">入门阶段</h2>
+
+  <div class="roadmap-future">
+    <div class="roadmap-future-card">
+      <span class="roadmap-emoji">🏪</span>
+      <h4>技能市场</h4>
+      <p>发现、安装与更新社区构建的技能。一条 curl 命令即可获得超能力。</p>
+    </div>
+    <div class="roadmap-future-card">
+      <span class="roadmap-emoji">🎨</span>
+      <h4>工作流定制</h4>
+      <p>打造属于你的工作流。集成 Jira、Linear、自定义输出——你的工作流，你的规则。</p>
+    </div>
+    <div class="roadmap-future-card">
+      <span class="roadmap-emoji">🚀</span>
+      <h4>阶段 1-3 优化</h4>
+      <p>通过子智能体上下文收集实现闪电般快速的规划。YOLO 模式遇上引导式卓越。</p>
+    </div>
+    <div class="roadmap-future-card">
+      <span class="roadmap-emoji">🌐</span>
+      <h4>企业级就绪</h4>
+      <p>SSO、审计日志、团队工作空间。那些让企业点头同意的无聊但必要的东西。</p>
+    </div>
+    <div class="roadmap-future-card">
+      <span class="roadmap-emoji">💎</span>
+      <h4>社区模块爆发</h4>
+      <p>娱乐、安全、治疗、角色扮演以及更多内容。扩展 BMad 方法平台。</p>
+    </div>
+    <div class="roadmap-future-card">
+      <span class="roadmap-emoji">⚡</span>
+      <h4>开发循环自动化</h4>
+      <p>可选的开发自动驾驶。让 AI 处理流程，同时保持质量高企。</p>
+    </div>
+  </div>
+
+  <h2 class="roadmap-section-title">社区与团队</h2>
+
+  <div class="roadmap-future">
+    <div class="roadmap-future-card">
+      <span class="roadmap-emoji">🎙️</span>
+      <h4>BMad 方法播客</h4>
+      <p>关于 AI 原生开发的对话。2026 年 3 月 1 日上线！</p>
+    </div>
+    <div class="roadmap-future-card">
+      <span class="roadmap-emoji">🎓</span>
+      <h4>BMad 方法大师课</h4>
+      <p>从用户到专家。深入每个阶段、每个工作流、每个秘密。</p>
+    </div>
+    <div class="roadmap-future-card">
+      <span class="roadmap-emoji">🏗️</span>
+      <h4>BMad 构建器大师课</h4>
+      <p>构建你自己的智能体。当你准备好创造而不仅仅是使用时的高级技巧。</p>
+    </div>
+    <div class="roadmap-future-card">
+      <span class="roadmap-emoji">⚡</span>
+      <h4>BMad 原型优先</h4>
+      <p>一次会话从想法到可用原型。像创作艺术品一样打造你的梦想应用。</p>
+    </div>
+    <div class="roadmap-future-card">
+      <span class="roadmap-emoji">🌴</span>
+      <h4>BMad BALM！</h4>
+      <p>AI 原生的生活管理。任务、习惯、目标——你的 AI 副驾驶，无处不在。</p>
+    </div>
+    <div class="roadmap-future-card">
+      <span class="roadmap-emoji">🖥️</span>
+      <h4>官方 UI</h4>
+      <p>整个 BMad 生态系统的精美界面。CLI 的强大，GUI 的精致。</p>
+    </div>
+    <div class="roadmap-future-card">
+      <span class="roadmap-emoji">🔒</span>
+      <h4>BMad 一体机</h4>
+      <p>自托管、气隙隔离、企业级。你的 AI 助手、你的基础设施、你的控制。</p>
+    </div>
+  </div>
+
+  <div style="text-align: center; margin-top: 3rem; padding: 2rem; background: var(--color-bg-card); border-radius: 12px; border: 1px solid var(--color-border);">
+    <h3 style="margin: 0 0 1rem;">想要贡献？</h3>
+    <p style="color: var(--slate-color-400); margin: 0;">
+      这只是计划内容的一部分。BMad 开源团队欢迎贡献者！{" "}<br />
+      <a href="https://github.com/bmad-code-org/BMAD-METHOD" style="color: var(--color-in-progress);">在 GitHub 上加入我们</a>，共同塑造 AI 驱动开发的未来。
+    </p>
+    <p style="color: var(--slate-color-400); margin: 1.5rem 0 0;">
+      喜欢我们正在构建的东西？我们感谢一次性与月度{" "}<a href="https://buymeacoffee.com/bmad" style="color: var(--color-in-progress);">支持</a>。
+    </p>
+    <p style="color: var(--slate-color-400); margin: 1rem 0 0;">
+      如需企业赞助、合作咨询、演讲邀请、培训或媒体咨询：{" "}
+      <a href="mailto:contact@bmadcode.com" style="color: var(--color-in-progress);">contact@bmadcode.com</a>
+    </p>
+  </div>
+</div>
+
+---
+## 术语说明
+
+- **agent**：智能体。在人工智能与编程文档中，指具备自主决策或执行能力的单元。
+- **SSO**：单点登录。一种用户认证机制，允许用户使用一组凭据访问多个应用程序。
+- **air-gapped**：气隙隔离。指系统与外部网络完全物理隔离的安全措施。
+- **YOLO**：You Only Live Once 的缩写，此处指快速、大胆的执行模式。
+- **evals**：评估。对 AI 模型或智能体性能的测试与评价。
+- **graceful degradation**：优雅降级。系统在部分功能失效时仍能保持基本功能的特性。
+- **sub-agent**：子智能体。在主智能体协调下执行特定任务的辅助智能体。
+- **context**：上下文。AI 理解任务所需的相关信息与环境背景。
+- **workflow**：工作流。一系列有序的任务或操作流程。
+- **skills**：技能。AI 智能体可执行的具体能力或功能模块。
+- **CLI**：命令行界面。通过文本命令与计算机交互的方式。
+- **GUI**：图形用户界面。通过图形元素与计算机交互的方式。

package/docs/zh-cn/tutorials/getting-started.md

@@ -0,0 +1,300 @@
+---
+title: "快速入门"
+description: 安装 BMad 并构建你的第一个项目
+---
+
+使用 AI 驱动的工作流更快地构建软件，通过专门的智能体引导你完成规划、架构设计和实现。
+
+## 你将学到
+
+- 为新项目安装并初始化 BMad Method
+- 使用 **BMad-Help** —— 你的智能向导，它知道下一步该做什么
+- 根据项目规模选择合适的规划路径
+- 从需求到可用代码，逐步推进各个阶段
+- 有效使用智能体和工作流
+
+:::note[前置条件]
+- **Node.js 20+** — 安装程序必需
+- **Git** — 推荐用于版本控制
+- **AI 驱动的 IDE** — Claude Code、Cursor 或类似工具
+- **一个项目想法** — 即使是简单的想法也可以用于学习
+:::
+
+:::tip[最简单的路径]
+**安装** → `npx bmad-method install`
+**询问** → `/bmad-help 我应该先做什么？`
+**构建** → 让 BMad-Help 逐个工作流地引导你
+:::
+
+## 认识 BMad-Help：你的智能向导
+
+**BMad-Help 是开始使用 BMad 的最快方式。** 你不需要记住工作流或阶段 —— 只需询问，BMad-Help 就会：
+
+- **检查你的项目**，看看已经完成了什么
+- **根据你安装的模块显示你的选项**
+- **推荐下一步** —— 包括第一个必需任务
+- **回答问题**，比如"我有一个 SaaS 想法，应该从哪里开始？"
+
+### 如何使用 BMad-Help
+
+只需在 AI IDE 中使用斜杠命令运行它：
+
+```
+/bmad-help
+```
+
+或者结合问题以获得上下文感知的指导：
+
+```
+/bmad-help 我有一个 SaaS 产品的想法，我已经知道我想要的所有功能。我应该从哪里开始？
+```
+
+BMad-Help 将回应：
+- 针对你的情况推荐什么
+- 第一个必需任务是什么
+- 其余流程是什么样的
+
+### 它也驱动工作流
+
+BMad-Help 不仅回答问题 —— **它会在每个工作流结束时自动运行**，告诉你确切地下一步该做什么。无需猜测，无需搜索文档 —— 只需对下一个必需工作流的清晰指导。
+
+:::tip[从这里开始]
+安装 BMad 后，立即运行 `/bmad-help`。它将检测你安装了哪些模块，并引导你找到项目的正确起点。
+:::
+
+## 了解 BMad
+
+BMad 通过带有专门 AI 智能体的引导工作流帮助你构建软件。该过程遵循四个阶段：
+
+| 阶段 | 名称           | 发生什么                                           |
+| ---- | -------------- | -------------------------------------------------- |
+| 1    | 分析           | 头脑风暴、研究、产品简报 *（可选）*                |
+| 2    | 规划           | 创建需求（PRD 或技术规范）                         |
+| 3    | 解决方案设计   | 设计架构 *（仅限 BMad Method/Enterprise only）*         |
+| 4    | 实现           | 逐个史诗、逐个故事地构建                           |
+
+**[打开工作流地图](../reference/workflow-map.md)** 以探索阶段、工作流和上下文管理。
+
+根据项目的复杂性，BMad 提供三种规划路径：
+
+| 路径           | 最适合                                               | 创建的文档                              |
+| --------------- | ---------------------------------------------------- | --------------------------------------- |
+| **Quick Flow**  | 错误修复、简单功能、范围清晰（1-15 个故事）          | 仅技术规范                              |
+| **BMad Method** | 产品、平台、复杂功能（10-50+ 个故事）                | PRD + 架构 + UX                         |
+| **Enterprise**  | 合规、多租户系统（30+ 个故事）                       | PRD + 架构 + 安全 + DevOps              |
+
+:::note
+故事数量是指导，而非定义。根据规划需求选择你的路径，而不是故事数学。
+:::
+
+## 安装
+
+在项目目录中打开终端并运行：
+
+```bash
+npx bmad-method install
+```
+
+当提示选择模块时，选择 **BMad Method**。
+
+安装程序会创建两个文件夹：
+- `_bmad/` — 智能体、工作流、任务和配置
+- `_bmad-output/` — 目前为空，但这是你的工件将被保存的地方
+
+:::tip[你的下一步]
+在项目文件夹中打开你的 AI IDE 并运行：
+
+```
+/bmad-help
+```
+
+BMad-Help 将检测你已完成的内容，并准确推荐下一步该做什么。你也可以问它诸如"我的选项是什么？"或"我有一个 SaaS 想法，我应该从哪里开始？"之类的问题。
+:::
+
+:::note[如何加载智能体和运行工作流]
+每个工作流都有一个你在 IDE 中运行的**斜杠命令**（例如 `/bmad-bmm-create-prd`）。运行工作流命令会自动加载相应的智能体 —— 你不需要单独加载智能体。你也可以直接加载智能体进行一般对话（例如，加载 PM 智能体使用 `/bmad-agent-bmm-pm`）。
+:::
+
+:::caution[新对话]
+始终为每个工作流开始一个新的对话。这可以防止上下文限制导致问题。
+:::
+
+## 步骤 1：创建你的计划
+
+完成阶段 1-3。**为每个工作流使用新对话。**
+
+:::tip[项目上下文（可选）]
+在开始之前，考虑创建 `project-context.md` 来记录你的技术偏好和实现规则。这确保所有 AI 智能体在整个项目中遵循你的约定。
+
+在 `_bmad-output/project-context.md` 手动创建它，或在架构之后使用 `/bmad-bmm-generate-project-context` 生成它。[了解更多](../explanation/project-context.md)。
+:::
+
+### 阶段 1：分析（可选）
+
+此阶段中的所有工作流都是可选的：
+- **头脑风暴**（`/bmad-brainstorming`） — 引导式构思
+- **研究**（`/bmad-bmm-research`） — 市场和技术研究
+- **创建产品简报**（`/bmad-bmm-create-product-brief`） — 推荐的基础文档
+
+### 阶段 2：规划（必需）
+
+**对于 BMad Method 和 Enterprise 路径：**
+1. 在新对话中加载 **PM 智能体**（`/bmad-agent-bmm-pm`）
+2. 运行 `prd` 工作流（`/bmad-bmm-create-prd`）
+3. 输出：`PRD.md`
+
+**对于 Quick Flow 路径：**
+- 使用 `quick-spec` 工作流（`/bmad-bmm-quick-spec`）代替 PRD，然后跳转到实现
+
+:::note[UX 设计（可选）]
+如果你的项目有用户界面，在创建 PRD 后加载 **UX-Designer 智能体**（`/bmad-agent-bmm-ux-designer`）并运行 UX 设计工作流（`/bmad-bmm-create-ux-design`）。
+:::
+
+### 阶段 3：解决方案设计（BMad Method/Enterprise）
+
+**创建架构**
+1. 在新对话中加载 **Architect 智能体**（`/bmad-agent-bmm-architect`）
+2. 运行 `create-architecture`（`/bmad-bmm-create-architecture`）
+3. 输出：包含技术决策的架构文档
+
+**创建史诗和故事**
+
+:::tip[V6 改进]
+史诗和故事现在在架构*之后*创建。这会产生更高质量的故事，因为架构决策（数据库、API 模式、技术栈）直接影响工作应该如何分解。
+:::
+
+1. 在新对话中加载 **PM 智能体**（`/bmad-agent-bmm-pm`）
+2. 运行 `create-epics-and-stories`（`/bmad-bmm-create-epics-and-stories`）
+3. 工作流使用 PRD 和架构来创建技术信息丰富的故事
+
+**实现就绪检查** *（强烈推荐）*
+1. 在新对话中加载 **Architect 智能体**（`/bmad-agent-bmm-architect`）
+2. 运行 `check-implementation-readiness`（`/bmad-bmm-check-implementation-readiness`）
+3. 验证所有规划文档之间的一致性
+
+## 步骤 2：构建你的项目
+
+规划完成后，进入实现阶段。**每个工作流应该在新对话中运行。**
+
+### 初始化冲刺规划
+
+加载 **SM 智能体**（`/bmad-agent-bmm-sm`）并运行 `sprint-planning`（`/bmad-bmm-sprint-planning`）。这将创建 `sprint-status.yaml` 来跟踪所有史诗和故事。
+
+### 构建周期
+
+对于每个故事，使用新对话重复此周期：
+
+| 步骤 | 智能体 | 工作流       | 命令                    | 目的                            |
+| ---- | ------ | ------------ | ----------------------- | ------------------------------- |
+| 1    | SM     | `create-story` | `/bmad-bmm-create-story`  | 从史诗创建故事文件              |
+| 2    | DEV    | `dev-story`    | `/bmad-bmm-dev-story`     | 实现故事                        |
+| 3    | DEV    | `code-review`  | `/bmad-bmm-code-review`   | 质量验证 *（推荐）*             |
+
+完成史诗中的所有故事后，加载 **SM 智能体**（`/bmad-agent-bmm-sm`）并运行 `retrospective`（`/bmad-bmm-retrospective`）。
+
+## 你已完成的工作
+
+你已经学习了使用 BMad 构建的基础：
+
+- 安装了 BMad 并为你的 IDE 进行了配置
+- 使用你选择的规划路径初始化了项目
+- 创建了规划文档（PRD、架构、史诗和故事）
+- 了解了实现的构建周期
+
+你的项目现在拥有：
+
+```text
+your-project/
+├── _bmad/                                   # BMad 配置
+├── _bmad-output/
+│   ├── planning-artifacts/
+│   │   ├── PRD.md                           # 你的需求文档
+│   │   ├── architecture.md                  # 技术决策
+│   │   └── epics/                           # 史诗和故事文件
+│   ├── implementation-artifacts/
+│   │   └── sprint-status.yaml               # 冲刺跟踪
+│   └── project-context.md                   # 实现规则（可选）
+└── ...
+```
+
+## 快速参考
+
+| 工作流                              | 命令                                    | 智能体   | 目的                                         |
+| ----------------------------------- | --------------------------------------- | -------- | -------------------------------------------- |
+| **`help`** ⭐                       | `/bmad-help`                            | 任意     | **你的智能向导 —— 随时询问任何问题！**        |
+| `prd`                               | `/bmad-bmm-create-prd`                  | PM       | 创建产品需求文档                             |
+| `create-architecture`               | `/bmad-bmm-create-architecture`         | Architect | 创建架构文档                                 |
+| `generate-project-context`          | `/bmad-bmm-generate-project-context`    | Analyst  | 创建项目上下文文件                           |
+| `create-epics-and-stories`          | `/bmad-bmm-create-epics-and-stories`    | PM       | 将 PRD 分解为史诗                            |
+| `check-implementation-readiness`    | `/bmad-bmm-check-implementation-readiness` | Architect | 验证规划一致性                               |
+| `sprint-planning`                   | `/bmad-bmm-sprint-planning`             | SM       | 初始化冲刺跟踪                               |
+| `create-story`                      | `/bmad-bmm-create-story`                | SM       | 创建故事文件                                 |
+| `dev-story`                         | `/bmad-bmm-dev-story`                   | DEV      | 实现故事                                     |
+| `code-review`                       | `/bmad-bmm-code-review`                 | DEV      | 审查已实现的代码                             |
+
+## 常见问题
+
+**我总是需要架构吗？**
+仅对于 BMad Method 和 Enterprise 路径。Quick Flow 从技术规范跳转到实现。
+
+**我可以稍后更改我的计划吗？**
+可以。SM 智能体有一个 `correct-course` 工作流（`/bmad-bmm-correct-course`）用于处理范围变更。
+
+**如果我想先进行头脑风暴怎么办？**
+在开始 PRD 之前，加载 Analyst 智能体（`/bmad-agent-bmm-analyst`）并运行 `brainstorming`（`/bmad-brainstorming`）。
+
+**我需要遵循严格的顺序吗？**
+不一定。一旦你了解了流程，你可以使用上面的快速参考直接运行工作流。
+
+## 获取帮助
+
+:::tip[第一站：BMad-Help]
+**随时运行 `/bmad-help`** —— 这是摆脱困境的最快方式。问它任何问题：
+- "安装后我应该做什么？"
+- "我在工作流 X 上卡住了"
+- "我在 Y 方面有什么选项？"
+- "向我展示到目前为止已完成的工作"
+
+BMad-Help 检查你的项目，检测你已完成的内容，并确切地告诉你下一步该做什么。
+:::
+
+- **在工作流期间** — 智能体通过问题和解释引导你
+- **社区** — [Discord](https://discord.gg/gk8jAdXWmj) (#bmad-method-help, #report-bugs-and-issues)
+
+## 关键要点
+
+:::tip[记住这些]
+- **从 `/bmad-help` 开始** — 你的智能向导，了解你的项目和选项
+- **始终使用新对话** — 为每个工作流开始新对话
+- **路径很重要** — Quick Flow 使用 quick-spec；Method/Enterprise 需要 PRD 和架构
+- **BMad-Help 自动运行** — 每个工作流结束时都会提供下一步的指导
+:::
+
+准备好开始了吗？安装 BMad，运行 `/bmad-help`，让你的智能向导为你引路。
+
+---
+## 术语说明
+
+- **agent**：智能体。在人工智能与编程文档中，指具备自主决策或执行能力的单元。
+- **epic**：史诗。软件开发中用于组织和管理大型功能或用户需求的高级工作项。
+- **story**：故事。敏捷开发中的用户故事，描述用户需求的小型工作项。
+- **PRD**：产品需求文档（Product Requirements Document）。详细描述产品功能、需求和目标的文档。
+- **workflow**：工作流。一系列有序的任务或步骤，用于完成特定目标。
+- **sprint**：冲刺。敏捷开发中的固定时间周期，用于完成预定的工作。
+- **IDE**：集成开发环境（Integrated Development Environment）。提供代码编辑、调试等功能的软件工具。
+- **artifact**：工件。软件开发过程中产生的文档、代码或其他可交付成果。
+- **retrospective**：回顾。敏捷开发中的会议，用于反思和改进团队工作流程。
+- **tech-spec**：技术规范（Technical Specification）。描述系统技术实现细节的文档。
+- **UX**：用户体验（User Experience）。用户在使用产品过程中的整体感受和交互体验。
+- **PM**：产品经理（Product Manager）。负责产品规划、需求管理和团队协调的角色。
+- **SM**：Scrum Master。敏捷开发中的角色，负责促进 Scrum 流程和团队协作。
+- **DEV**：开发者（Developer）。负责编写代码和实现功能的角色。
+- **Architect**：架构师。负责系统架构设计和技术决策的角色。
+- **Analyst**：分析师。负责需求分析、市场研究等工作的角色。
+- **npx**：Node Package eXecute。Node.js 包执行器，用于运行 npm 包而无需安装。
+- **Node.js**：基于 Chrome V8 引擎的 JavaScript 运行时环境。
+- **Git**：分布式版本控制系统。
+- **SaaS**：软件即服务（Software as a Service）。通过互联网提供软件服务的模式。
+- **DevOps**：开发运维（Development and Operations）。强调开发和运维协作的实践和方法。
+- **multi-tenant**：多租户。一种软件架构，允许单个实例为多个客户（租户）提供服务。
+- **compliance**：合规性。遵守法律、法规和行业标准的要求。

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "bmad-method",
-  "version": "6.0.4",
+  "version": "6.0.5-next.0",
   "description": "Breakthrough Method of Agile AI-driven Development",
   "keywords": [
     "agile",

package/src/bmm/agents/analyst.agent.yaml

@@ -39,5 +39,5 @@ agent:
       description: "[CB] Create Brief: A guided experience to nail down your product idea into an executive brief"
 
     - trigger: DP or fuzzy match on document-project
-      workflow: "{project-root}/_bmad/bmm/workflows/document-project/workflow.yaml"
+      exec: "{project-root}/_bmad/bmm/workflows/document-project/workflow.md"
       description: "[DP] Document Project: Analyze an existing project to produce useful documentation for both human and LLM"

package/src/bmm/agents/bmad-skill-manifest.yaml

@@ -0,0 +1,39 @@
+analyst.agent.yaml:
+  canonicalId: bmad-analyst
+  type: agent
+  description: "Business Analyst for market research, competitive analysis, and requirements elicitation"
+
+architect.agent.yaml:
+  canonicalId: bmad-architect
+  type: agent
+  description: "Architect for distributed systems, cloud infrastructure, and API design"
+
+dev.agent.yaml:
+  canonicalId: bmad-dev
+  type: agent
+  description: "Developer Agent for story execution, test-driven development, and code implementation"
+
+pm.agent.yaml:
+  canonicalId: bmad-pm
+  type: agent
+  description: "Product Manager for PRD creation, requirements discovery, and stakeholder alignment"
+
+qa.agent.yaml:
+  canonicalId: bmad-qa
+  type: agent
+  description: "QA Engineer for test automation, API testing, and E2E testing"
+
+quick-flow-solo-dev.agent.yaml:
+  canonicalId: bmad-quick-flow-solo-dev
+  type: agent
+  description: "Quick Flow Solo Dev for rapid spec creation and lean implementation"
+
+sm.agent.yaml:
+  canonicalId: bmad-sm
+  type: agent
+  description: "Scrum Master for sprint planning, story preparation, and agile ceremonies"
+
+ux-designer.agent.yaml:
+  canonicalId: bmad-ux-designer
+  type: agent
+  description: "UX Designer for user research, interaction design, and UI patterns"

package/src/bmm/agents/dev.agent.yaml

@@ -30,9 +30,9 @@ agent:
 
   menu:
     - trigger: DS or fuzzy match on dev-story
-      workflow: "{project-root}/_bmad/bmm/workflows/4-implementation/dev-story/workflow.yaml"
+      exec: "{project-root}/_bmad/bmm/workflows/4-implementation/dev-story/workflow.md"
       description: "[DS] Dev Story: Write the next or specified stories tests and code."
 
     - trigger: CR or fuzzy match on code-review
-      workflow: "{project-root}/_bmad/bmm/workflows/4-implementation/code-review/workflow.yaml"
+      exec: "{project-root}/_bmad/bmm/workflows/4-implementation/code-review/workflow.md"
       description: "[CR] Code Review: Initiate a comprehensive code review across multiple quality facets. For best results, use a fresh context and a different quality LLM if available"

package/src/bmm/agents/pm.agent.yaml

@@ -40,5 +40,5 @@ agent:
       description: "[IR] Implementation Readiness: Ensure the PRD, UX, and Architecture and Epics and Stories List are all aligned"
 
     - trigger: CC or fuzzy match on correct-course
-      workflow: "{project-root}/_bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml"
+      exec: "{project-root}/_bmad/bmm/workflows/4-implementation/correct-course/workflow.md"
       description: "[CC] Course Correction: Use this so we can determine how to proceed if major need for change is discovered mid implementation"

package/src/bmm/agents/qa.agent.yaml

@@ -29,7 +29,7 @@ agent:
 
   menu:
     - trigger: QA or fuzzy match on qa-automate
-      workflow: "{project-root}/_bmad/bmm/workflows/qa-generate-e2e-tests/workflow.yaml"
+      exec: "{project-root}/_bmad/bmm/workflows/qa-generate-e2e-tests/workflow.md"
       description: "[QA] Automate - Generate tests for existing features (simplified)"
 
   prompts: