@zeyue0329/xiaoma-cli 1.0.49 → 1.6.4

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

@@ -0,0 +1,166 @@
+---
+title: "命令"
+description: XiaoMa 斜杠命令参考——它们是什么、如何工作以及在哪里找到它们。
+sidebar:
+  order: 3
+---
+
+斜杠命令是预构建的提示词，用于在 IDE 中加载智能体、运行工作流或执行任务。XiaoMa 安装程序在安装时根据已安装的模块生成这些命令。如果您后续添加、删除或更改模块，请重新运行安装程序以保持命令同步（参见[故障排除](#troubleshooting)）。
+
+## 命令与智能体菜单触发器
+
+XiaoMa 提供两种开始工作的方式，它们服务于不同的目的。
+
+| 机制 | 调用方式 | 发生什么 |
+| --- | --- | --- |
+| **斜杠命令** | 在 IDE 中输入 `/xiaoma-...` | 直接加载智能体、运行工作流或执行任务 |
+| **智能体菜单触发器** | 先加载智能体，然后输入简短代码（例如 `DS`） | 智能体解释代码并启动匹配的工作流，同时保持角色设定 |
+
+智能体菜单触发器需要活动的智能体会话。当您知道要使用哪个工作流时，使用斜杠命令。当您已经与智能体一起工作并希望在不离开对话的情况下切换任务时，使用触发器。
+
+## 命令如何生成
+
+当您运行 `npx xiaoma-cli 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/
+├── xiaoma-agent-xmc-dev.md
+├── xiaoma-agent-xmc-pm.md
+├── xiaoma-xmc-create-prd.md
+├── xiaoma-editorial-review-prose.md
+├── xiaoma-help.md
+└── ...
+```
+
+文件名决定了 IDE 中的斜杠命令名称。例如，文件 `xiaoma-agent-xmc-dev.md` 注册命令 `/xiaoma-agent-xmc-dev`。
+
+## 如何发现您的命令
+
+在 IDE 中输入 `/xiaoma` 并使用自动完成功能浏览可用命令。
+
+运行 `/xiaoma-help` 获取关于下一步的上下文感知指导。
+
+:::tip[快速发现]
+项目中生成的命令文件夹是权威列表。在文件资源管理器中打开它们以查看每个命令及其描述。
+:::
+
+## 命令类别
+
+### 智能体命令
+
+智能体命令加载具有定义角色、沟通风格和工作流菜单的专业化 AI 角色。加载后，智能体保持角色设定并响应菜单触发器。
+
+| 示例命令 | 智能体 | 角色 |
+| --- | --- | --- |
+| `/xiaoma-agent-xmc-dev` | Amelia（开发者） | 严格按照规范实现故事 |
+| `/xiaoma-agent-xmc-pm` | John（产品经理） | 创建和验证 PRD |
+| `/xiaoma-agent-xmc-architect` | Winston（架构师） | 设计系统架构 |
+| `/xiaoma-agent-xmc-sm` | Bob（Scrum Master） | 管理冲刺和故事 |
+
+参见[智能体](./agents.md)获取默认智能体及其触发器的完整列表。
+
+### 工作流命令
+
+工作流命令运行结构化的多步骤过程，而无需先加载智能体角色。它们加载工作流引擎并传递特定的工作流配置。
+
+| 示例命令 | 目的 |
+| --- | --- |
+| `/xiaoma-xmc-create-prd` | 创建产品需求文档 |
+| `/xiaoma-xmc-create-architecture` | 设计系统架构 |
+| `/xiaoma-xmc-dev-story` | 实现故事 |
+| `/xiaoma-xmc-code-review` | 运行代码审查 |
+| `/xiaoma-xmc-quick-spec` | 定义临时更改（快速流程） |
+
+参见[工作流地图](./workflow-map.md)获取按阶段组织的完整工作流参考。
+
+### 任务和工具命令
+
+任务和工具是独立的操作，不需要智能体或工作流上下文。
+
+#### XiaoMa-Help：您的智能向导
+
+**`/xiaoma-help`** 是您发现下一步操作的主要界面。它不仅仅是一个查找工具——它是一个智能助手，可以：
+
+- **检查您的项目**以查看已经完成的工作
+- **理解自然语言查询**——用简单的英语提问
+- **根据已安装的模块而变化**——根据您拥有的内容显示选项
+- **在工作流后自动调用**——每个工作流都以清晰的下一步结束
+- **推荐第一个必需任务**——无需猜测从哪里开始
+
+**示例：**
+
+```
+/xiaoma-help
+/xiaoma-help 我有一个 SaaS 想法并且知道所有功能。我应该从哪里开始？
+/xiaoma-help 我在 UX 设计方面有哪些选择？
+/xiaoma-help 我在 PRD 工作流上卡住了
+```
+
+#### 其他任务和工具
+
+| 示例命令 | 目的 |
+| --- | --- |
+| `/xiaoma-shard-doc` | 将大型 Markdown 文件拆分为较小的部分 |
+| `/xiaoma-index-docs` | 索引项目文档 |
+| `/xiaoma-editorial-review-prose` | 审查文档散文质量 |
+
+## 命名约定
+
+命令名称遵循可预测的模式。
+
+| 模式 | 含义 | 示例 |
+| --- | --- | --- |
+| `xiaoma-agent-<module>-<name>` | 智能体启动器 | `xiaoma-agent-xmc-dev` |
+| `xiaoma-<module>-<workflow>` | 工作流命令 | `xiaoma-xmc-create-prd` |
+| `xiaoma-<name>` | 核心任务或工具 | `xiaoma-help` |
+
+模块代码：`xmc`（敏捷套件）、`bmb`（构建器）、`tea`（测试架构师）、`cis`（创意智能）、`gds`（游戏开发工作室）。参见[模块](./modules.md)获取描述。
+
+## 故障排除
+
+**安装后命令未出现。** 重启您的 IDE 或重新加载窗口。某些 IDE 会缓存命令列表，需要刷新才能获取新文件。
+
+**预期的命令缺失。** 安装程序仅为您选择的模块生成命令。再次运行 `npx xiaoma-cli 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
+---
+
+XiaoMa 通过您在安装期间选择的官方模块进行扩展。这些附加模块为内置核心和 BMM（敏捷套件）之外的特定领域提供专门的智能体、工作流和任务。
+
+:::tip[安装模块]
+运行 `npx xiaoma-cli install` 并选择您需要的模块。安装程序会自动处理下载、配置和 IDE 集成。
+:::
+
+## XiaoMa Builder
+
+在引导式协助下创建自定义智能体、工作流和特定领域的模块。XiaoMa Builder 是用于扩展框架本身的元模块。
+
+- **代码：** `bmb`
+- **npm：** [`xiaoma-builder`](https://www.npmjs.com/package/xiaoma-builder)
+- **GitHub：** [xiaoma-code-org/xiaoma-builder](https://github.com/xiaoma-code-org/xiaoma-builder)
+
+**提供：**
+
+- 智能体构建器 —— 创建具有自定义专业知识和工具访问权限的专用 AI 智能体
+- 工作流构建器 —— 设计包含步骤和决策点的结构化流程
+- 模块构建器 —— 将智能体和工作流打包为可共享、可发布的模块
+- 交互式设置，支持 YAML 配置和 npm 发布
+
+## 创意智能套件
+
+用于早期开发阶段的结构化创意、构思和创新的 AI 驱动工具。该套件提供多个智能体，利用经过验证的框架促进头脑风暴、设计思维和问题解决。
+
+- **代码：** `cis`
+- **npm：** [`xiaoma-creative-intelligence-suite`](https://www.npmjs.com/package/xiaoma-creative-intelligence-suite)
+- **GitHub：** [xiaoma-code-org/xiaoma-module-creative-intelligence-suite](https://github.com/xiaoma-code-org/xiaoma-module-creative-intelligence-suite)
+
+**提供：**
+
+- 创新策略师、设计思维教练和头脑风暴教练智能体
+- 问题解决者和创意问题解决者，用于系统性和横向思维
+- 故事讲述者和演示大师，用于叙事和推介
+- 构思框架，包括 SCAMPER、逆向头脑风暴和问题重构
+
+## 游戏开发工作室
+
+适用于 Unity、Unreal、Godot 和自定义引擎的结构化游戏开发工作流。通过 Quick Flow 支持快速原型制作，并通过史诗驱动的冲刺支持全面规模的生产。
+
+- **代码：** `gds`
+- **npm：** [`xiaoma-game-dev-studio`](https://www.npmjs.com/package/xiaoma-game-dev-studio)
+- **GitHub：** [xiaoma-code-org/xiaoma-module-game-dev-studio](https://github.com/xiaoma-code-org/xiaoma-module-game-dev-studio)
+
+**提供：**
+
+- 游戏设计文档（GDD）生成工作流
+- 用于快速原型制作的 Quick Dev 模式
+- 针对角色、对话和世界构建的叙事设计支持
+- 覆盖 21+ 种游戏类型，并提供特定引擎的架构指导
+
+## 测试架构师（TEA）
+
+通过专家智能体和九个结构化工作流提供企业级测试策略、自动化指导和发布门控决策。TEA 远超内置 QA 智能体，提供基于风险的优先级排序和需求可追溯性。
+
+- **代码：** `tea`
+- **npm：** [`xiaoma-cli-test-architecture-enterprise`](https://www.npmjs.com/package/xiaoma-cli-test-architecture-enterprise)
+- **GitHub：** [xiaoma-code-org/xiaoma-cli-test-architecture-enterprise](https://github.com/xiaoma-code-org/xiaoma-cli-test-architecture-enterprise)
+
+**提供：**
+
+- Murat 智能体（主测试架构师和质量顾问）
+- 用于测试设计、ATDD、自动化、测试审查和可追溯性的工作流
+- NFR 评估、CI 设置和框架脚手架
+- P0-P3 优先级排序，可选 Playwright Utils 和 MCP 集成
+
+## 社区模块
+
+社区模块和模块市场即将推出。请查看 [XiaoMa GitHub 组织](https://github.com/xiaoma-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
+---
+
+XiaoMa 提供两条测试路径：用于快速生成测试的内置 QA 智能体，以及用于企业级测试策略的可安装测试架构师模块。
+
+## 应该使用哪一个？
+
+| 因素 | Quinn（内置 QA） | TEA 模块 |
+| --- | --- | --- |
+| **最适合** | 中小型项目、快速覆盖 | 大型项目、受监管或复杂领域 |
+| **设置** | 无需安装——包含在 BMM 中 | 通过 `npx xiaoma-cli install` 单独安装 |
+| **方法** | 快速生成测试，稍后迭代 | 先规划，再生成并保持可追溯性 |
+| **测试类型** | API 和 E2E 测试 | API、E2E、ATDD、NFR 等 |
+| **策略** | 快乐路径 + 关键边界情况 | 基于风险的优先级排序（P0-P3） |
+| **工作流数量** | 1（Automate） | 9（设计、ATDD、自动化、审查、可追溯性等） |
+
+:::tip[从 Quinn 开始]
+大多数项目应从 Quinn 开始。如果后续需要测试策略、质量门控或需求可追溯性，可并行安装 TEA。
+:::
+
+## 内置 QA 智能体（Quinn）
+
+Quinn 是 BMM（敏捷套件）模块中的内置 QA 智能体。它使用项目现有的测试框架快速生成可运行的测试——无需配置或额外安装。
+
+**触发方式：** `QA` 或 `xiaoma-xmc-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://xiaoma-code-org.github.io/xiaoma-cli-test-architecture-enterprise/)
+- **安装：** `npx xiaoma-cli install` 并选择 TEA 模块
+- **npm：** [`xiaoma-cli-test-architecture-enterprise`](https://www.npmjs.com/package/xiaoma-cli-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 工作流出现在 XiaoMa 方法工作流图的第 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 模型与外部工具之间通信的协议。

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

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