bmad-method 6.0.4 → 6.0.5-next.0

package/docs/zh-cn/how-to/upgrade-to-v6.md

@@ -0,0 +1,120 @@
+---
+title: "如何升级到 v6"
+description: 从 BMad v4 迁移到 v6
+sidebar:
+  order: 3
+---
+
+使用 BMad 安装程序从 v4 升级到 v6，其中包括自动检测旧版安装和迁移辅助。
+
+## 何时使用本指南
+
+- 您已安装 BMad v4（`.bmad-method` 文件夹）
+- 您希望迁移到新的 v6 架构
+- 您有需要保留的现有规划产物
+
+:::note[前置条件]
+- Node.js 20+
+- 现有的 BMad v4 安装
+:::
+
+## 步骤
+
+### 1. 运行安装程序
+
+按照[安装程序说明](./install-bmad.md)操作。
+
+### 2. 处理旧版安装
+
+当检测到 v4 时，您可以：
+
+- 允许安装程序备份并删除 `.bmad-method`
+- 退出并手动处理清理
+
+如果您将 bmad method 文件夹命名为其他名称 - 您需要手动删除该文件夹。
+
+### 3. 清理 IDE 命令
+
+手动删除旧版 v4 IDE 命令 - 例如如果您使用 claude，查找任何以 bmad 开头的嵌套文件夹并删除它们：
+
+- `.claude/commands/BMad/agents`
+- `.claude/commands/BMad/tasks`
+
+### 4. 迁移规划产物
+
+**如果您有规划文档（Brief/PRD/UX/Architecture）：**
+
+将它们移动到 `_bmad-output/planning-artifacts/` 并使用描述性名称：
+
+- 在文件名中包含 `PRD` 用于 PRD 文档
+- 相应地包含 `brief`、`architecture` 或 `ux-design`
+- 分片文档可以放在命名的子文件夹中
+
+**如果您正在进行规划：** 考虑使用 v6 工作流重新开始。将现有文档作为输入——新的渐进式发现工作流配合网络搜索和 IDE 计划模式会产生更好的结果。
+
+### 5. 迁移进行中的开发
+
+如果您已创建或实现了故事：
+
+1. 完成 v6 安装
+2. 将 `epics.md` 或 `epics/epic*.md` 放入 `_bmad-output/planning-artifacts/`
+3. 运行 Scrum Master 的 `sprint-planning` 工作流
+4. 告诉 SM 哪些史诗/故事已经完成
+
+## 您将获得
+
+**v6 统一结构：**
+
+```text
+your-project/
+├── _bmad/               # 单一安装文件夹
+│   ├── _config/         # 您的自定义配置
+│   │   └── agents/      # 智能体自定义文件
+│   ├── core/            # 通用核心框架
+│   ├── bmm/             # BMad Method 模块
+│   ├── bmb/             # BMad Builder
+│   └── cis/             # Creative Intelligence Suite
+└── _bmad-output/        # 输出文件夹（v4 中为 doc 文件夹）
+```
+
+## 模块迁移
+
+| v4 模块                       | v6 状态                                   |
+| ----------------------------- | ----------------------------------------- |
+| `.bmad-2d-phaser-game-dev`    | 已集成到 BMGD 模块                        |
+| `.bmad-2d-unity-game-dev`     | 已集成到 BMGD 模块                        |
+| `.bmad-godot-game-dev`        | 已集成到 BMGD 模块                        |
+| `.bmad-infrastructure-devops` | 已弃用 — 新的 DevOps 智能体即将推出       |
+| `.bmad-creative-writing`      | 未适配 — 新的 v6 模块即将推出             |
+
+## 主要变更
+
+| 概念         | v4                                      | v6                                   |
+| ------------ | --------------------------------------- | ------------------------------------ |
+| **核心**     | `_bmad-core` 实际上是 BMad Method      | `_bmad/core/` 是通用框架             |
+| **方法**     | `_bmad-method`                          | `_bmad/bmm/`                         |
+| **配置**     | 直接修改文件                            | 每个模块使用 `config.yaml`           |
+| **文档**     | 需要设置分片或非分片                    | 完全灵活，自动扫描                   |
+
+---
+## 术语说明
+
+- **agent**：智能体。在人工智能与编程文档中，指具备自主决策或执行能力的单元。
+- **epic**：史诗。在敏捷开发中，指大型的工作项，可分解为多个用户故事。
+- **story**：故事。在敏捷开发中，指用户故事，描述用户需求的功能单元。
+- **Scrum Master**：Scrum 主管。敏捷开发 Scrum 框架中的角色，负责促进团队流程和移除障碍。
+- **sprint-planning**：冲刺规划。Scrum 框架中的会议，用于确定下一个冲刺期间要完成的工作。
+- **sharded**：分片。将大型文档拆分为多个较小的文件以便于管理和处理。
+- **PRD**：产品需求文档（Product Requirements Document）。描述产品功能、需求和特性的文档。
+- **Brief**：简报。概述项目目标、范围和关键信息的文档。
+- **UX**：用户体验（User Experience）。用户在使用产品或服务过程中的整体感受和交互体验。
+- **Architecture**：架构。系统的结构设计，包括组件、模块及其相互关系。
+- **BMGD**：BMad Game Development。BMad 游戏开发模块。
+- **DevOps**：开发运维（Development Operations）。结合开发和运维的实践，旨在缩短系统开发生命周期。
+- **BMad Method**：BMad 方法。BMad 框架的核心方法论模块。
+- **BMad Builder**：BMad 构建器。BMad 框架的构建工具。
+- **Creative Intelligence Suite**：创意智能套件。BMad 框架中的创意工具集合。
+- **IDE**：集成开发环境（Integrated Development Environment）。提供代码编辑、调试等功能的软件开发工具。
+- **progressive discovery**：渐进式发现。逐步深入探索和理解需求的过程。
+- **web search**：网络搜索。通过互联网检索信息的能力。
+- **plan mode**：计划模式。IDE 中的一种工作模式，用于规划和设计任务。

package/docs/zh-cn/index.md

@@ -0,0 +1,69 @@
+---
+title: 欢迎使用 BMad 方法
+description: 具备专业智能体、引导式工作流和智能规划的 AI 驱动开发框架
+---
+
+BMad 方法（**B**reakthrough **M**ethod of **A**gile AI **D**riven Development，敏捷 AI 驱动开发的突破性方法）是 BMad 方法生态系统中的一个 AI 驱动开发框架模块，帮助您完成从构思和规划到智能体实现的整个软件开发过程。它提供专业的 AI 智能体、引导式工作流和智能规划，能够根据您项目的复杂度进行调整，无论是修复错误还是构建企业平台。
+
+如果您熟悉使用 Claude、Cursor 或 GitHub Copilot 等 AI 编码助手，就可以开始使用了。
+
+:::note[🚀 V6 已发布，我们才刚刚起步！]
+技能架构、BMad Builder v1、开发循环自动化以及更多功能正在开发中。**[查看路线图 →](/roadmap/)**
+:::
+
+## 新手入门？从教程开始
+
+理解 BMad 的最快方式是亲自尝试。
+
+- **[BMad 入门指南](./tutorials/getting-started.md)** — 安装并了解 BMad 的工作原理
+- **[工作流地图](./reference/workflow-map.md)** — BMM 阶段、工作流和上下文管理的可视化概览
+
+:::tip[只想直接上手？]
+安装 BMad 并运行 `/bmad-help` — 它会根据您的项目和已安装的模块引导您完成所有操作。
+:::
+
+## 如何使用本文档
+
+本文档根据您的目标分为四个部分：
+
+| 部分           | 用途                                                                                                    |
+| ----------------- | ---------------------------------------------------------------------------------------------------------- |
+| **教程**     | 以学习为导向。通过分步指南引导您构建内容。如果您是新手，请从这里开始。 |
+| **操作指南** | 以任务为导向。解决特定问题的实用指南。"如何自定义智能体？"等内容位于此处。  |
+| **说明**   | 以理解为导向。深入探讨概念和架构。当您想知道*为什么*时阅读。       |
+| **参考**     | 以信息为导向。智能体、工作流和配置的技术规范。                   |
+
+## 扩展和自定义
+
+想要使用自己的智能体、工作流或模块来扩展 BMad 吗？**[BMad Builder](https://bmad-builder-docs.bmad-method.org/)** 提供了创建自定义扩展的框架和工具，无论是为 BMad 添加新功能还是从头开始构建全新的模块。
+
+## 您需要什么
+
+BMad 可与任何支持自定义系统提示词或项目上下文的 AI 编码助手配合使用。热门选项包括：
+
+- **[Claude Code](https://code.claude.com)** — Anthropic 的 CLI 工具（推荐）
+- **[Cursor](https://cursor.sh)** — AI 优先的代码编辑器
+- **[Codex CLI](https://github.com/openai/codex)** — OpenAI 的终端编码智能体
+
+您应该熟悉版本控制、项目结构和敏捷工作流等基本软件开发概念。无需具备 BMad 风格智能体系统的先验经验——这正是本文档的作用。
+
+## 加入社区
+
+获取帮助、分享您的构建内容，或为 BMad 做出贡献：
+
+- **[Discord](https://discord.gg/gk8jAdXWmj)** — 与其他 BMad 用户聊天、提问、分享想法
+- **[GitHub](https://github.com/bmad-code-org/BMAD-METHOD)** — 源代码、问题和贡献
+- **[YouTube](https://www.youtube.com/@BMadCode)** — 视频教程和演练
+
+## 下一步
+
+准备开始了吗？**[BMad 入门指南](./tutorials/getting-started.md)** 并构建您的第一个项目。
+
+---
+## 术语说明
+
+- **agent**：智能体。在人工智能与编程文档中，指具备自主决策或执行能力的单元。
+- **AI-driven**：AI 驱动。指由人工智能技术主导或驱动的系统或方法。
+- **workflow**：工作流。指一系列有序的任务或步骤，用于完成特定目标。
+- **prompt**：提示词。指输入给 AI 模型的指令或问题，用于引导其生成特定输出。
+- **context**：上下文。指在特定场景下理解信息所需的背景信息或环境。

package/docs/zh-cn/reference/agents.md

@@ -0,0 +1,41 @@
+---
+title: "智能体"
+description: 默认 BMM 智能体及其菜单触发器和主要工作流
+sidebar:
+  order: 2
+---
+
+## 默认智能体
+
+本页列出了随 BMad Method 安装的默认 BMM（Agile 套件）智能体，以及它们的菜单触发器和主要工作流。
+
+## 注意事项
+
+- 触发器是显示在每个智能体菜单中的简短菜单代码（例如 `CP`）和模糊匹配。
+- 斜杠命令是单独生成的。斜杠命令列表及其定义位置请参阅[命令](./commands.md)。
+- QA（Quinn）是 BMM 中的轻量级测试自动化智能体。完整的测试架构师（TEA）位于其独立模块中。
+
+| 智能体                      | 触发                            | 主要工作流                                                                                           |
+| --------------------------- | --------------------------------- | --------------------------------------------------------------------------------------------------- |
+| Analyst (Mary)              | `BP`, `RS`, `CB`, `DP`            | 头脑风暴项目、研究、创建简报、文档化项目                                                              |
+| Product Manager (John)      | `CP`, `VP`, `EP`, `CE`, `IR`, `CC` | 创建/验证/编辑 PRD、创建史诗和用户故事、实施就绪、纠正方向                                            |
+| Architect (Winston)         | `CA`, `IR`                        | 创建架构、实施就绪                                                                                   |
+| Scrum Master (Bob)          | `SP`, `CS`, `ER`, `CC`            | 冲刺规划、创建用户故事、史诗回顾、纠正方向                                                           |
+| Developer (Amelia)          | `DS`, `CR`                        | 开发用户故事、代码评审                                                                               |
+| QA Engineer (Quinn)         | `QA`                              | 自动化（为现有功能生成测试）                                                                         |
+| Quick Flow Solo Dev (Barry) | `QS`, `QD`, `CR`                  | 快速规格、快速开发、代码评审                                                                         |
+| UX Designer (Sally)         | `CU`                              | 创建 UX 设计                                                                                         |
+| Technical Writer (Paige)    | `DP`, `WD`, `US`, `MG`, `VD`, `EC` | 文档化项目、撰写文档、更新标准、Mermaid 生成、验证文档、解释概念                                      |
+
+---
+## 术语说明
+
+- **agent**：智能体。在人工智能与编程文档中，指具备自主决策或执行能力的单元。
+- **BMM**：BMad Method 中的默认智能体套件，涵盖敏捷开发流程中的各类角色。
+- **PRD**：产品需求文档（Product Requirements Document）。
+- **Epic**：史诗。大型功能或需求集合，可拆分为多个用户故事。
+- **Story**：用户故事。描述用户需求的简短陈述。
+- **Sprint**：冲刺。敏捷开发中的固定时间周期迭代。
+- **QA**：质量保证（Quality Assurance）。
+- **TEA**：测试架构师（Test Architect）。
+- **Mermaid**：一种用于生成图表和流程图的文本语法。

package/docs/zh-cn/reference/commands.md

@@ -0,0 +1,166 @@
+---
+title: "命令"
+description: BMad 斜杠命令参考——它们是什么、如何工作以及在哪里找到它们。
+sidebar:
+  order: 3
+---
+
+斜杠命令是预构建的提示词，用于在 IDE 中加载智能体、运行工作流或执行任务。BMad 安装程序在安装时根据已安装的模块生成这些命令。如果您后续添加、删除或更改模块，请重新运行安装程序以保持命令同步（参见[故障排除](#troubleshooting)）。
+
+## 命令与智能体菜单触发器
+
+BMad 提供两种开始工作的方式，它们服务于不同的目的。
+
+| 机制 | 调用方式 | 发生什么 |
+| --- | --- | --- |
+| **斜杠命令** | 在 IDE 中输入 `/bmad-...` | 直接加载智能体、运行工作流或执行任务 |
+| **智能体菜单触发器** | 先加载智能体，然后输入简短代码（例如 `DS`） | 智能体解释代码并启动匹配的工作流，同时保持角色设定 |
+
+智能体菜单触发器需要活动的智能体会话。当您知道要使用哪个工作流时，使用斜杠命令。当您已经与智能体一起工作并希望在不离开对话的情况下切换任务时，使用触发器。
+
+## 命令如何生成
+
+当您运行 `npx bmad-method install` 时，安装程序会读取每个选定模块的清单，并为每个智能体、工作流、任务和工具编写一个命令文件。每个文件都是一个简短的 Markdown 提示词，指示 AI 加载相应的源文件并遵循其指令。
+
+安装程序为每种命令类型使用模板：
+
+| 命令类型 | 生成的文件的作用 |
+| --- | --- |
+| **智能体启动器** | 加载智能体角色文件，激活其菜单，并保持角色设定 |
+| **工作流命令** | 加载工作流引擎（`workflow.xml`）并传递工作流配置 |
+| **任务命令** | 加载独立任务文件并遵循其指令 |
+| **工具命令** | 加载独立工具文件并遵循其指令 |
+
+:::note[重新运行安装程序]
+如果您添加或删除模块，请再次运行安装程序。它会重新生成所有命令文件以匹配您当前的模块选择。
+:::
+
+## 命令文件的位置
+
+安装程序将命令文件写入项目内 IDE 特定的目录中。确切路径取决于您在安装期间选择的 IDE。
+
+| IDE / CLI | 命令目录 |
+| --- | --- |
+| Claude Code | `.claude/commands/` |
+| Cursor | `.cursor/commands/` |
+| Windsurf | `.windsurf/workflows/` |
+| 其他 IDE | 请参阅安装程序输出中的目标路径 |
+
+所有 IDE 都在其命令目录中接收一组扁平的命令文件。例如，Claude Code 安装看起来像：
+
+```text
+.claude/commands/
+├── bmad-agent-bmm-dev.md
+├── bmad-agent-bmm-pm.md
+├── bmad-bmm-create-prd.md
+├── bmad-editorial-review-prose.md
+├── bmad-help.md
+└── ...
+```
+
+文件名决定了 IDE 中的斜杠命令名称。例如，文件 `bmad-agent-bmm-dev.md` 注册命令 `/bmad-agent-bmm-dev`。
+
+## 如何发现您的命令
+
+在 IDE 中输入 `/bmad` 并使用自动完成功能浏览可用命令。
+
+运行 `/bmad-help` 获取关于下一步的上下文感知指导。
+
+:::tip[快速发现]
+项目中生成的命令文件夹是权威列表。在文件资源管理器中打开它们以查看每个命令及其描述。
+:::
+
+## 命令类别
+
+### 智能体命令
+
+智能体命令加载具有定义角色、沟通风格和工作流菜单的专业化 AI 角色。加载后，智能体保持角色设定并响应菜单触发器。
+
+| 示例命令 | 智能体 | 角色 |
+| --- | --- | --- |
+| `/bmad-agent-bmm-dev` | Amelia（开发者） | 严格按照规范实现故事 |
+| `/bmad-agent-bmm-pm` | John（产品经理） | 创建和验证 PRD |
+| `/bmad-agent-bmm-architect` | Winston（架构师） | 设计系统架构 |
+| `/bmad-agent-bmm-sm` | Bob（Scrum Master） | 管理冲刺和故事 |
+
+参见[智能体](./agents.md)获取默认智能体及其触发器的完整列表。
+
+### 工作流命令
+
+工作流命令运行结构化的多步骤过程，而无需先加载智能体角色。它们加载工作流引擎并传递特定的工作流配置。
+
+| 示例命令 | 目的 |
+| --- | --- |
+| `/bmad-bmm-create-prd` | 创建产品需求文档 |
+| `/bmad-bmm-create-architecture` | 设计系统架构 |
+| `/bmad-bmm-dev-story` | 实现故事 |
+| `/bmad-bmm-code-review` | 运行代码审查 |
+| `/bmad-bmm-quick-spec` | 定义临时更改（快速流程） |
+
+参见[工作流地图](./workflow-map.md)获取按阶段组织的完整工作流参考。
+
+### 任务和工具命令
+
+任务和工具是独立的操作，不需要智能体或工作流上下文。
+
+#### BMad-Help：您的智能向导
+
+**`/bmad-help`** 是您发现下一步操作的主要界面。它不仅仅是一个查找工具——它是一个智能助手，可以：
+
+- **检查您的项目**以查看已经完成的工作
+- **理解自然语言查询**——用简单的英语提问
+- **根据已安装的模块而变化**——根据您拥有的内容显示选项
+- **在工作流后自动调用**——每个工作流都以清晰的下一步结束
+- **推荐第一个必需任务**——无需猜测从哪里开始
+
+**示例：**
+
+```
+/bmad-help
+/bmad-help 我有一个 SaaS 想法并且知道所有功能。我应该从哪里开始？
+/bmad-help 我在 UX 设计方面有哪些选择？
+/bmad-help 我在 PRD 工作流上卡住了
+```
+
+#### 其他任务和工具
+
+| 示例命令 | 目的 |
+| --- | --- |
+| `/bmad-shard-doc` | 将大型 Markdown 文件拆分为较小的部分 |
+| `/bmad-index-docs` | 索引项目文档 |
+| `/bmad-editorial-review-prose` | 审查文档散文质量 |
+
+## 命名约定
+
+命令名称遵循可预测的模式。
+
+| 模式 | 含义 | 示例 |
+| --- | --- | --- |
+| `bmad-agent-<module>-<name>` | 智能体启动器 | `bmad-agent-bmm-dev` |
+| `bmad-<module>-<workflow>` | 工作流命令 | `bmad-bmm-create-prd` |
+| `bmad-<name>` | 核心任务或工具 | `bmad-help` |
+
+模块代码：`bmm`（敏捷套件）、`bmb`（构建器）、`tea`（测试架构师）、`cis`（创意智能）、`gds`（游戏开发工作室）。参见[模块](./modules.md)获取描述。
+
+## 故障排除
+
+**安装后命令未出现。** 重启您的 IDE 或重新加载窗口。某些 IDE 会缓存命令列表，需要刷新才能获取新文件。
+
+**预期的命令缺失。** 安装程序仅为您选择的模块生成命令。再次运行 `npx bmad-method install` 并验证您的模块选择。检查命令文件是否存在于预期目录中。
+
+**已删除模块的命令仍然出现。** 安装程序不会自动删除旧的命令文件。从 IDE 的命令目录中删除过时的文件，或删除整个命令目录并重新运行安装程序以获取一组干净的命令。
+
+---
+## 术语说明
+
+- **slash command**：斜杠命令。以 `/` 开头的命令，用于在 IDE 中快速执行特定操作。
+- **agent**：智能体。在人工智能与编程文档中，指具备自主决策或执行能力的单元。
+- **workflow**：工作流。一系列结构化的步骤，用于完成特定任务或流程。
+- **IDE**：集成开发环境。用于软件开发的综合应用程序，提供代码编辑、调试、构建等功能。
+- **persona**：角色设定。为智能体定义的特定角色、性格和行为方式。
+- **trigger**：触发器。用于启动特定操作或流程的机制。
+- **manifest**：清单。描述模块或组件的元数据文件。
+- **installer**：安装程序。用于安装和配置软件的工具。
+- **PRD**：产品需求文档。描述产品功能、需求和规范的文档。
+- **SaaS**：软件即服务。通过互联网提供软件服务的模式。
+- **UX**：用户体验。用户在使用产品或服务过程中的整体感受和交互体验。

package/docs/zh-cn/reference/modules.md

@@ -0,0 +1,94 @@
+---
+title: "官方模块"
+description: 用于构建自定义智能体、创意智能、游戏开发和测试的附加模块
+sidebar:
+  order: 4
+---
+
+BMad 通过您在安装期间选择的官方模块进行扩展。这些附加模块为内置核心和 BMM（敏捷套件）之外的特定领域提供专门的智能体、工作流和任务。
+
+:::tip[安装模块]
+运行 `npx bmad-method install` 并选择您需要的模块。安装程序会自动处理下载、配置和 IDE 集成。
+:::
+
+## BMad Builder
+
+在引导式协助下创建自定义智能体、工作流和特定领域的模块。BMad Builder 是用于扩展框架本身的元模块。
+
+- **代码：** `bmb`
+- **npm：** [`bmad-builder`](https://www.npmjs.com/package/bmad-builder)
+- **GitHub：** [bmad-code-org/bmad-builder](https://github.com/bmad-code-org/bmad-builder)
+
+**提供：**
+
+- 智能体构建器 —— 创建具有自定义专业知识和工具访问权限的专用 AI 智能体
+- 工作流构建器 —— 设计包含步骤和决策点的结构化流程
+- 模块构建器 —— 将智能体和工作流打包为可共享、可发布的模块
+- 交互式设置，支持 YAML 配置和 npm 发布
+
+## 创意智能套件
+
+用于早期开发阶段的结构化创意、构思和创新的 AI 驱动工具。该套件提供多个智能体，利用经过验证的框架促进头脑风暴、设计思维和问题解决。
+
+- **代码：** `cis`
+- **npm：** [`bmad-creative-intelligence-suite`](https://www.npmjs.com/package/bmad-creative-intelligence-suite)
+- **GitHub：** [bmad-code-org/bmad-module-creative-intelligence-suite](https://github.com/bmad-code-org/bmad-module-creative-intelligence-suite)
+
+**提供：**
+
+- 创新策略师、设计思维教练和头脑风暴教练智能体
+- 问题解决者和创意问题解决者，用于系统性和横向思维
+- 故事讲述者和演示大师，用于叙事和推介
+- 构思框架，包括 SCAMPER、逆向头脑风暴和问题重构
+
+## 游戏开发工作室
+
+适用于 Unity、Unreal、Godot 和自定义引擎的结构化游戏开发工作流。通过 Quick Flow 支持快速原型制作，并通过史诗驱动的冲刺支持全面规模的生产。
+
+- **代码：** `gds`
+- **npm：** [`bmad-game-dev-studio`](https://www.npmjs.com/package/bmad-game-dev-studio)
+- **GitHub：** [bmad-code-org/bmad-module-game-dev-studio](https://github.com/bmad-code-org/bmad-module-game-dev-studio)
+
+**提供：**
+
+- 游戏设计文档（GDD）生成工作流
+- 用于快速原型制作的 Quick Dev 模式
+- 针对角色、对话和世界构建的叙事设计支持
+- 覆盖 21+ 种游戏类型，并提供特定引擎的架构指导
+
+## 测试架构师（TEA）
+
+通过专家智能体和九个结构化工作流提供企业级测试策略、自动化指导和发布门控决策。TEA 远超内置 QA 智能体，提供基于风险的优先级排序和需求可追溯性。
+
+- **代码：** `tea`
+- **npm：** [`bmad-method-test-architecture-enterprise`](https://www.npmjs.com/package/bmad-method-test-architecture-enterprise)
+- **GitHub：** [bmad-code-org/bmad-method-test-architecture-enterprise](https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise)
+
+**提供：**
+
+- Murat 智能体（主测试架构师和质量顾问）
+- 用于测试设计、ATDD、自动化、测试审查和可追溯性的工作流
+- NFR 评估、CI 设置和框架脚手架
+- P0-P3 优先级排序，可选 Playwright Utils 和 MCP 集成
+
+## 社区模块
+
+社区模块和模块市场即将推出。请查看 [BMad GitHub 组织](https://github.com/bmad-code-org) 获取最新更新。
+
+---
+## 术语说明
+
+- **agent**：智能体。在人工智能与编程文档中，指具备自主决策或执行能力的单元。
+- **workflow**：工作流。指一系列有序的任务或步骤，用于完成特定的业务流程或开发流程。
+- **module**：模块。指可独立开发、测试和部署的软件单元，用于扩展系统功能。
+- **meta-module**：元模块。指用于创建或扩展其他模块的模块，是模块的模块。
+- **ATDD**：验收测试驱动开发（Acceptance Test-Driven Development）。一种敏捷开发实践，在编写代码之前先编写验收测试。
+- **NFR**：非功能性需求（Non-Functional Requirement）。指系统在性能、安全性、可维护性等方面的质量属性要求。
+- **CI**：持续集成（Continuous Integration）。一种软件开发实践，频繁地将代码集成到主干分支，并进行自动化测试。
+- **MCP**：模型上下文协议（Model Context Protocol）。一种用于在 AI 模型与外部工具或服务之间进行通信的协议。
+- **SCAMPER**：一种创意思维技巧，包含替代、组合、调整、修改、其他用途、消除和重组七个维度。
+- **GDD**：游戏设计文档（Game Design Document）。用于描述游戏设计理念、玩法、机制等内容的详细文档。
+- **P0-P3**：优先级分级。P0 为最高优先级（关键），P3 为最低优先级（可选）。
+- **sprint**：冲刺。敏捷开发中的固定时间周期，通常为 1-4 周，用于完成预定的工作。
+- **epic**：史诗。敏捷开发中的大型工作项，可分解为多个用户故事或任务。
+- **Quick Flow**：快速流程。一种用于快速原型开发的工作流模式。

package/docs/zh-cn/reference/testing.md

@@ -0,0 +1,122 @@
+---
+title: "测试选项"
+description: 比较内置 QA 智能体（Quinn）与测试架构师（TEA）模块的测试自动化。
+sidebar:
+  order: 5
+---
+
+BMad 提供两条测试路径：用于快速生成测试的内置 QA 智能体，以及用于企业级测试策略的可安装测试架构师模块。
+
+## 应该使用哪一个？
+
+| 因素 | Quinn（内置 QA） | TEA 模块 |
+| --- | --- | --- |
+| **最适合** | 中小型项目、快速覆盖 | 大型项目、受监管或复杂领域 |
+| **设置** | 无需安装——包含在 BMM 中 | 通过 `npx bmad-method install` 单独安装 |
+| **方法** | 快速生成测试，稍后迭代 | 先规划，再生成并保持可追溯性 |
+| **测试类型** | API 和 E2E 测试 | API、E2E、ATDD、NFR 等 |
+| **策略** | 快乐路径 + 关键边界情况 | 基于风险的优先级排序（P0-P3） |
+| **工作流数量** | 1（Automate） | 9（设计、ATDD、自动化、审查、可追溯性等） |
+
+:::tip[从 Quinn 开始]
+大多数项目应从 Quinn 开始。如果后续需要测试策略、质量门控或需求可追溯性，可并行安装 TEA。
+:::
+
+## 内置 QA 智能体（Quinn）
+
+Quinn 是 BMM（敏捷套件）模块中的内置 QA 智能体。它使用项目现有的测试框架快速生成可运行的测试——无需配置或额外安装。
+
+**触发方式：** `QA` 或 `bmad-bmm-qa-automate`
+
+### Quinn 的功能
+
+Quinn 运行单个工作流（Automate），包含五个步骤：
+
+1. **检测测试框架**——扫描 `package.json` 和现有测试文件以识别框架（Jest、Vitest、Playwright、Cypress 或任何标准运行器）。如果不存在，则分析项目技术栈并推荐一个。
+2. **识别功能**——询问要测试的内容或自动发现代码库中的功能。
+3. **生成 API 测试**——覆盖状态码、响应结构、快乐路径和 1-2 个错误情况。
+4. **生成 E2E 测试**——使用语义定位器和可见结果断言覆盖用户工作流。
+5. **运行并验证**——执行生成的测试并立即修复失败。
+
+Quinn 会生成测试摘要，保存到项目的实现产物文件夹中。
+
+### 测试模式
+
+生成的测试遵循"简单且可维护"的理念：
+
+- **仅使用标准框架 API**——不使用外部工具或自定义抽象
+- UI 测试使用**语义定位器**（角色、标签、文本而非 CSS 选择器）
+- **独立测试**，无顺序依赖
+- **无硬编码等待或休眠**
+- **清晰的描述**，可作为功能文档阅读
+
+:::note[范围]
+Quinn 仅生成测试。如需代码审查和故事验证，请改用代码审查工作流（`CR`）。
+:::
+
+### 何时使用 Quinn
+
+- 为新功能或现有功能快速实现测试覆盖
+- 无需高级设置的初学者友好型测试自动化
+- 任何开发者都能阅读和维护的标准测试模式
+- 不需要全面测试策略的中小型项目
+
+## 测试架构师（TEA）模块
+
+TEA 是一个独立模块，提供专家智能体（Murat）和九个结构化工作流，用于企业级测试。它超越了测试生成，涵盖测试策略、基于风险的规划、质量门控和需求可追溯性。
+
+- **文档：** [TEA 模块文档](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/)
+- **安装：** `npx bmad-method install` 并选择 TEA 模块
+- **npm：** [`bmad-method-test-architecture-enterprise`](https://www.npmjs.com/package/bmad-method-test-architecture-enterprise)
+
+### TEA 提供的功能
+
+| Workflow | Purpose |
+| --- | --- |
+| Test Design | 创建与需求关联的全面测试策略 |
+| ATDD | 基于干系人标准的验收测试驱动开发 |
+| Automate | 使用高级模式和工具生成测试 |
+| Test Review | 根据策略验证测试质量和覆盖范围 |
+| Traceability | 将测试映射回需求，用于审计和合规 |
+| NFR Assessment | 评估非功能性需求（性能、安全性） |
+| CI Setup | 在持续集成管道中配置测试执行 |
+| Framework Scaffolding | 设置测试基础设施和项目结构 |
+| Release Gate | 基于数据做出发布/不发布决策 |
+
+TEA 还支持 P0-P3 基于风险的优先级排序，以及与 Playwright Utils 和 MCP 工具的可选集成。
+
+### 何时使用 TEA
+
+- 需要需求可追溯性或合规文档的项目
+- 需要在多个功能间进行基于风险的测试优先级排序的团队
+- 发布前具有正式质量门控的企业环境
+- 在编写测试前必须规划测试策略的复杂领域
+- 已超出 Quinn 单一工作流方法的项目
+
+## 测试如何融入工作流
+
+Quinn 的 Automate 工作流出现在 BMad 方法工作流图的第 4 阶段（实现）。典型序列：
+
+1. 使用开发工作流（`DS`）实现一个故事
+2. 使用 Quinn（`QA`）或 TEA 的 Automate 工作流生成测试
+3. 使用代码审查（`CR`）验证实现
+
+Quinn 直接从源代码工作，无需加载规划文档（PRD、架构）。TEA 工作流可以与上游规划产物集成以实现可追溯性。
+
+有关测试在整体流程中的位置，请参阅[工作流图](./workflow-map.md)。
+
+---
+## 术语说明
+
+- **QA (Quality Assurance)**：质量保证。确保产品或服务满足质量要求的过程。
+- **E2E (End-to-End)**：端到端。测试整个系统从开始到结束的完整流程。
+- **ATDD (Acceptance Test-Driven Development)**：验收测试驱动开发。在编码前先编写验收测试的开发方法。
+- **NFR (Non-Functional Requirement)**：非功能性需求。描述系统如何运行而非做什么的需求，如性能、安全性等。
+- **P0-P3**：优先级级别。P0 为最高优先级，P3 为最低优先级，用于基于风险的测试排序。
+- **Happy path**：快乐路径。测试系统在理想条件下的正常工作流程。
+- **Semantic locators**：语义定位器。使用有意义的元素属性（如角色、标签、文本）而非 CSS 选择器来定位 UI 元素。
+- **Quality gates**：质量门控。在开发流程中设置的检查点，用于确保质量标准。
+- **Requirements traceability**：需求可追溯性。能够追踪需求从设计到测试再到实现的完整链路。
+- **agent**：智能体。在人工智能与编程文档中，指具备自主决策或执行能力的单元。
+- **CI (Continuous Integration)**：持续集成。频繁地将代码集成到主干，并自动运行测试的实践。
+- **MCP (Model Context Protocol)**：模型上下文协议。用于在 AI 模型与外部工具之间通信的协议。