@zeyue0329/xiaoma-cli 1.0.49 → 1.6.4

package/docs/zh-cn/how-to/project-context.md

@@ -0,0 +1,152 @@
+---
+title: "管理项目上下文"
+description: 创建并维护 project-context.md 以指导 AI 智能体
+sidebar:
+  order: 7
+---
+
+使用 `project-context.md` 文件确保 AI 智能体在所有工作流程中遵循项目的技术偏好和实现规则。
+
+:::note[前置条件]
+- 已安装 XiaoMa Method
+- 了解项目的技术栈和约定
+:::
+
+## 何时使用
+
+- 在开始架构设计之前有明确的技术偏好
+- 已完成架构设计并希望为实施捕获决策
+- 正在处理具有既定模式的现有代码库
+- 注意到智能体在不同用户故事中做出不一致的决策
+
+## 步骤 1：选择方法
+
+**手动创建** — 当您确切知道要记录哪些规则时最佳
+
+**架构后生成** — 最适合捕获解决方案制定过程中所做的决策
+
+**为现有项目生成** — 最适合在现有代码库中发现模式
+
+## 步骤 2：创建文件
+
+### 选项 A：手动创建
+
+在 `_xiaoma-output/project-context.md` 创建文件：
+
+```bash
+mkdir -p _xiaoma-output
+touch _xiaoma-output/project-context.md
+```
+
+添加技术栈和实现规则：
+
+```markdown
+---
+project_name: 'MyProject'
+user_name: 'YourName'
+date: '2026-02-15'
+sections_completed: ['technology_stack', 'critical_rules']
+---
+
+# AI 智能体的项目上下文
+
+## 技术栈与版本
+
+- Node.js 20.x, TypeScript 5.3, React 18.2
+- 状态管理：Zustand
+- 测试：Vitest, Playwright
+- 样式：Tailwind CSS
+
+## 关键实现规则
+
+**TypeScript：**
+- 启用严格模式，不使用 `any` 类型
+- 公共 API 使用 `interface`，联合类型使用 `type`
+
+**代码组织：**
+- 组件位于 `/src/components/` 并附带同位置测试
+- API 调用使用 `apiClient` 单例 — 绝不直接使用 fetch
+
+**测试：**
+- 单元测试专注于业务逻辑
+- 集成测试使用 MSW 进行 API 模拟
+```
+
+### 选项 B：架构后生成
+
+在新的聊天中运行工作流程：
+
+```bash
+/xiaoma-xmc-generate-project-context
+```
+
+工作流程扫描架构文档和项目文件，生成捕获所做决策的上下文文件。
+
+### 选项 C：为现有项目生成
+
+对于现有项目，运行：
+
+```bash
+/xiaoma-xmc-generate-project-context
+```
+
+工作流程分析代码库以识别约定，然后生成上下文文件供您审查和完善。
+
+## 步骤 3：验证内容
+
+审查生成的文件并确保它捕获了：
+
+- 正确的技术版本
+- 实际约定（而非通用最佳实践）
+- 防止常见错误的规则
+- 框架特定的模式
+
+手动编辑以添加任何缺失内容或删除不准确之处。
+
+## 您将获得
+
+一个 `project-context.md` 文件，它：
+
+- 确保所有智能体遵循相同的约定
+- 防止在不同用户故事中做出不一致的决策
+- 为实施捕获架构决策
+- 作为项目模式和规则的参考
+
+## 提示
+
+:::tip[关注非显而易见的内容]
+记录智能体可能遗漏的模式，例如"在每个公共类、函数和变量上使用 JSDoc 风格注释"，而不是像"使用有意义的变量名"这样的通用实践，因为 LLM 目前已经知道这些。
+:::
+
+:::tip[保持精简]
+此文件由每个实施工作流程加载。长文件会浪费上下文。不要包含仅适用于狭窄范围或特定用户故事或功能的内容。
+:::
+
+:::tip[根据需要更新]
+当模式发生变化时手动编辑，或在重大架构更改后重新生成。
+:::
+
+:::tip[适用于所有项目类型]
+对于快速流程和完整的 XiaoMa Method 项目同样有用。
+:::
+
+## 后续步骤
+
+- [**项目上下文说明**](../explanation/project-context.md) — 了解其工作原理
+- [**工作流程图**](../reference/workflow-map.md) — 查看哪些工作流程加载项目上下文
+
+---
+## 术语说明
+
+- **agent**：智能体。在人工智能与编程文档中，指具备自主决策或执行能力的单元。
+- **workflow**：工作流程。指完成特定任务的一系列步骤或过程。
+- **codebase**：代码库。指项目的所有源代码和资源的集合。
+- **implementation**：实施。指将设计或架构转化为实际代码的过程。
+- **architecture**：架构。指系统的整体结构和设计。
+- **stack**：技术栈。指项目使用的技术组合，如编程语言、框架、工具等。
+- **convention**：约定。指团队或项目中遵循的编码规范和最佳实践。
+- **singleton**：单例。一种设计模式，确保类只有一个实例。
+- **co-located**：同位置。指相关文件（如测试文件）与主文件放在同一目录中。
+- **mocking**：模拟。在测试中用模拟对象替代真实对象的行为。
+- **context**：上下文。指程序运行时的环境信息或背景信息。
+- **LLM**：大语言模型。Large Language Model 的缩写，指大型语言模型。

package/docs/zh-cn/how-to/quick-fixes.md

@@ -0,0 +1,140 @@
+---
+title: "快速修复"
+description: 如何进行快速修复和临时更改
+sidebar:
+  order: 5
+---
+
+直接使用 **DEV 智能体**进行 bug 修复、重构或小型针对性更改，这些操作不需要完整的 XiaoMa Method 或 Quick Flow。
+
+## 何时使用此方法
+
+- 原因明确且已知的 bug 修复
+- 包含在少数文件中的小型重构（重命名、提取、重组）
+- 次要功能调整或配置更改
+- 探索性工作，以了解不熟悉的代码库
+
+:::note[前置条件]
+- 已安装 XiaoMa Method（`npx xiaoma-cli install`）
+- AI 驱动的 IDE（Claude Code、Cursor 或类似工具）
+:::
+
+## 选择你的方法
+
+| 情况 | 智能体 | 原因 |
+| --- | --- | --- |
+| 修复特定 bug 或进行小型、范围明确的更改 | **DEV agent** | 直接进入实现，无需规划开销 |
+| 更改涉及多个文件，或希望先有书面计划 | **Quick Flow Solo Dev** | 在实现前创建 quick-spec，使智能体与你的标准保持一致 |
+
+如果不确定，请从 DEV 智能体开始。如果更改范围扩大，你始终可以升级到 Quick Flow。
+
+## 步骤
+
+### 1. 加载 DEV 智能体
+
+在 AI IDE 中启动一个**新的聊天**，并使用斜杠命令加载 DEV 智能体：
+
+```text
+/xiaoma-agent-xmc-dev
+```
+
+这会将智能体的角色和能力加载到会话中。如果你决定需要 Quick Flow，请在新的聊天中加载 **Quick Flow Solo Dev** 智能体：
+
+```text
+/xiaoma-agent-xmc-quick-flow-solo-dev
+```
+
+加载 Solo Dev 智能体后，描述你的更改并要求它创建一个 **quick-spec**。智能体会起草一个轻量级规范，捕获你想要更改的内容和方式。批准 quick-spec 后，告诉智能体开始 **Quick Flow 开发周期**——它将实现更改、运行测试并执行自我审查，所有这些都由你刚刚批准的规范指导。
+
+:::tip[新聊天]
+加载智能体时始终启动新的聊天会话。重用之前工作流的会话可能导致上下文冲突。
+:::
+
+### 2. 描述更改
+
+用通俗语言告诉智能体你需要什么。具体说明问题，如果你知道相关代码的位置，也请说明。
+
+:::note[示例提示词]
+**Bug 修复** -- "修复允许空密码的登录验证 bug。验证逻辑位于 `src/auth/validate.ts`。"
+
+**重构** -- "重构 UserService 以使用 async/await 而不是回调。"
+
+**配置更改** -- "更新 CI 流水线以在运行之间缓存 node_modules。"
+
+**依赖更新** -- "将 express 依赖升级到最新的 v5 版本并修复任何破坏性更改。"
+:::
+
+你不需要提供每个细节。智能体会读取相关的源文件，并在需要时提出澄清问题。
+
+### 3. 让智能体工作
+
+智能体将：
+
+- 读取并分析相关的源文件
+- 提出解决方案并解释其推理
+- 在受影响的文件中实现更改
+- 如果存在测试套件，则运行项目的测试套件
+
+如果你的项目有测试，智能体会在进行更改后自动运行它们，并迭代直到测试通过。对于没有测试套件的项目，请手动验证更改（运行应用、访问端点、检查输出）。
+
+### 4. 审查和验证
+
+在提交之前，审查更改内容：
+
+- 通读 diff 以确认更改符合你的意图
+- 自己运行应用程序或测试以再次检查
+- 如果看起来有问题，告诉智能体需要修复什么——它可以在同一会话中迭代
+
+满意后，使用描述修复的清晰消息提交更改。
+
+:::caution[如果出现问题]
+如果提交的更改导致意外问题，请使用 `git revert HEAD` 干净地撤销最后一次提交。然后启动与 DEV 智能体的新聊天以尝试不同的方法。
+:::
+
+## 学习你的代码库
+
+DEV 智能体也适用于探索不熟悉的代码。在新的聊天中加载它并提出问题：
+
+:::note[示例提示词]
+"解释此代码库中的身份验证系统是如何工作的。"
+
+"向我展示 API 层中的错误处理发生在哪里。"
+
+"`ProcessOrder` 函数的作用是什么，什么调用了它？"
+:::
+
+使用智能体了解你的项目，理解组件如何连接，并在进行更改之前探索不熟悉的区域。
+
+## 你将获得
+
+- 已应用修复或重构的修改后的源文件
+- 通过的测试（如果你的项目有测试套件）
+- 描述更改的干净提交
+
+不会生成规划产物——这就是这种方法的意义所在。
+
+## 何时升级到正式规划
+
+在以下情况下考虑使用 [Quick Flow](../explanation/quick-flow.md) 或完整的 XiaoMa Method：
+
+- 更改影响多个系统或需要在许多文件中进行协调更新
+- 你不确定范围，需要规范来理清思路
+- 修复在工作过程中变得越来越复杂
+- 你需要为团队记录文档或架构决策
+
+---
+## 术语说明
+
+- **agent**：智能体。在人工智能与编程文档中，指具备自主决策或执行能力的单元。
+- **quick-spec**：快速规范。一种轻量级的规范文档，用于快速捕获和描述更改的内容和方式。
+- **Quick Flow**：快速流程。XiaoMa Method 中的一种工作流程，用于快速实现小型更改。
+- **refactoring**：重构。在不改变代码外部行为的情况下改进其内部结构的过程。
+- **breaking changes**：破坏性更改。可能导致现有代码或功能不再正常工作的更改。
+- **test suite**：测试套件。一组用于验证软件功能的测试用例集合。
+- **CI pipeline**：CI 流水线。持续集成流水线，用于自动化构建、测试和部署代码。
+- **async/await**：异步编程语法。JavaScript/TypeScript 中用于处理异步操作的语法糖。
+- **callbacks**：回调函数。作为参数传递给其他函数并在适当时候被调用的函数。
+- **endpoint**：端点。API 中可访问的特定 URL 路径。
+- **diff**：差异。文件或代码更改前后的对比。
+- **commit**：提交。将更改保存到版本控制系统的操作。
+- **git revert HEAD**：Git 命令，用于撤销最后一次提交。

package/docs/zh-cn/how-to/shard-large-documents.md

@@ -0,0 +1,86 @@
+---
+title: "文档分片指南"
+description: 将大型 Markdown 文件拆分为更小的组织化文件，以更好地管理上下文
+sidebar:
+  order: 8
+---
+
+如果需要将大型 Markdown 文件拆分为更小、组织良好的文件以更好地管理上下文，请使用 `shard-doc` 工具。
+
+:::caution[已弃用]
+不再推荐使用此方法，随着工作流程的更新以及大多数主要 LLM 和工具支持子进程，这很快将变得不再必要。
+:::
+
+## 何时使用
+
+仅当你发现所选工具/模型组合无法在需要时加载和读取所有文档作为输入时，才使用此方法。
+
+## 什么是文档分片？
+
+文档分片根据二级标题（`## Heading`）将大型 Markdown 文件拆分为更小、组织良好的文件。
+
+### 架构
+
+```text
+分片前：
+_xiaoma-output/planning-artifacts/
+└── PRD.md（大型 50k token 文件）
+
+分片后：
+_xiaoma-output/planning-artifacts/
+└── prd/
+    ├── index.md                    # 带有描述的目录
+    ├── overview.md                 # 第 1 节
+    ├── user-requirements.md        # 第 2 节
+    ├── technical-requirements.md   # 第 3 节
+    └── ...                         # 其他章节
+```
+
+## 步骤
+
+### 1. 运行 Shard-Doc 工具
+
+```bash
+/xiaoma-shard-doc
+```
+
+### 2. 遵循交互式流程
+
+```text
+智能体：您想要分片哪个文档？
+用户：docs/PRD.md
+
+智能体：默认目标位置：docs/prd/
+       接受默认值？[y/n]
+用户：y
+
+智能体：正在分片 PRD.md...
+       ✓ 已创建 12 个章节文件
+       ✓ 已生成 index.md
+       ✓ 完成！
+```
+
+## 工作流程发现机制
+
+XiaoMa 工作流程使用**双重发现系统**：
+
+1. **首先尝试完整文档** - 查找 `document-name.md`
+2. **检查分片版本** - 查找 `document-name/index.md`
+3. **优先级规则** - 如果两者都存在，完整文档优先 - 如果希望使用分片版本，请删除完整文档
+
+## 工作流程支持
+
+所有 BMM 工作流程都支持这两种格式：
+
+- 完整文档
+- 分片文档
+- 自动检测
+- 对用户透明
+
+---
+## 术语说明
+
+- **sharding**：分片。将大型文档或数据集拆分为更小、更易管理的部分的过程。
+- **token**：令牌。在自然语言处理和大型语言模型中，文本的基本单位，通常对应单词或字符的一部分。
+- **subprocesses**：子进程。由主进程创建的独立执行单元，可以并行运行以执行特定任务。
+- **agent**：智能体。在人工智能与编程文档中，指具备自主决策或执行能力的单元。

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

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

package/docs/zh-cn/index.md

@@ -0,0 +1,69 @@
+---
+title: 欢迎使用 XiaoMa 方法
+description: 具备专业智能体、引导式工作流和智能规划的 AI 驱动开发框架
+---
+
+XiaoMa 方法（**B**reakthrough **M**ethod of **A**gile AI **D**riven Development，敏捷 AI 驱动开发的突破性方法）是 XiaoMa 方法生态系统中的一个 AI 驱动开发框架模块，帮助您完成从构思和规划到智能体实现的整个软件开发过程。它提供专业的 AI 智能体、引导式工作流和智能规划，能够根据您项目的复杂度进行调整，无论是修复错误还是构建企业平台。
+
+如果您熟悉使用 Claude、Cursor 或 GitHub Copilot 等 AI 编码助手，就可以开始使用了。
+
+:::note[🚀 V6 已发布，我们才刚刚起步！]
+技能架构、XiaoMa Builder v1、开发循环自动化以及更多功能正在开发中。**[查看路线图 →](/roadmap/)**
+:::
+
+## 新手入门？从教程开始
+
+理解 XiaoMa 的最快方式是亲自尝试。
+
+- **[XiaoMa 入门指南](./tutorials/getting-started.md)** — 安装并了解 XiaoMa 的工作原理
+- **[工作流地图](./reference/workflow-map.md)** — BMM 阶段、工作流和上下文管理的可视化概览
+
+:::tip[只想直接上手？]
+安装 XiaoMa 并运行 `/xiaoma-help` — 它会根据您的项目和已安装的模块引导您完成所有操作。
+:::
+
+## 如何使用本文档
+
+本文档根据您的目标分为四个部分：
+
+| 部分           | 用途                                                                                                    |
+| ----------------- | ---------------------------------------------------------------------------------------------------------- |
+| **教程**     | 以学习为导向。通过分步指南引导您构建内容。如果您是新手，请从这里开始。 |
+| **操作指南** | 以任务为导向。解决特定问题的实用指南。"如何自定义智能体？"等内容位于此处。  |
+| **说明**   | 以理解为导向。深入探讨概念和架构。当您想知道*为什么*时阅读。       |
+| **参考**     | 以信息为导向。智能体、工作流和配置的技术规范。                   |
+
+## 扩展和自定义
+
+想要使用自己的智能体、工作流或模块来扩展 XiaoMa 吗？**[XiaoMa Builder](https://xiaoma-builder-docs.xiaoma-cli.org/)** 提供了创建自定义扩展的框架和工具，无论是为 XiaoMa 添加新功能还是从头开始构建全新的模块。
+
+## 您需要什么
+
+XiaoMa 可与任何支持自定义系统提示词或项目上下文的 AI 编码助手配合使用。热门选项包括：
+
+- **[Claude Code](https://code.claude.com)** — Anthropic 的 CLI 工具（推荐）
+- **[Cursor](https://cursor.sh)** — AI 优先的代码编辑器
+- **[Codex CLI](https://github.com/openai/codex)** — OpenAI 的终端编码智能体
+
+您应该熟悉版本控制、项目结构和敏捷工作流等基本软件开发概念。无需具备 XiaoMa 风格智能体系统的先验经验——这正是本文档的作用。
+
+## 加入社区
+
+获取帮助、分享您的构建内容，或为 XiaoMa 做出贡献：
+
+- **[Discord](https://discord.gg/gk8jAdXWmj)** — 与其他 XiaoMa 用户聊天、提问、分享想法
+- **[GitHub](https://github.com/xiaoma-code-org/XiaoMa-Cli)** — 源代码、问题和贡献
+- **[YouTube](https://www.youtube.com/@XiaoMaCode)** — 视频教程和演练
+
+## 下一步
+
+准备开始了吗？**[XiaoMa 入门指南](./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
+---
+
+## 默认智能体
+
+本页列出了随 XiaoMa 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**：XiaoMa Method 中的默认智能体套件，涵盖敏捷开发流程中的各类角色。
+- **PRD**：产品需求文档（Product Requirements Document）。
+- **Epic**：史诗。大型功能或需求集合，可拆分为多个用户故事。
+- **Story**：用户故事。描述用户需求的简短陈述。
+- **Sprint**：冲刺。敏捷开发中的固定时间周期迭代。
+- **QA**：质量保证（Quality Assurance）。
+- **TEA**：测试架构师（Test Architect）。
+- **Mermaid**：一种用于生成图表和流程图的文本语法。