@zeyue0329/xiaoma-cli 1.0.49 → 1.0.66

package/docs/roadshow/02-/346/231/272/350/203/275/344/275/223/347/263/273/347/273/237/350/257/246/350/247/243.md

@@ -0,0 +1,464 @@
+# 智能体系统详解
+
+---
+
+## 1. 智能体总览
+
+XiaoMa 拥有 **9 个专业化 AI 智能体**，模拟真实敏捷开发团队的完整角色配置。每个智能体拥有独立的人格设定（Persona）、沟通风格、行为准则和菜单命令，通过 YAML 文件声明式定义，并由 Zod Schema 进行严格验证。
+
+```mermaid
+mindmap
+  root((XiaoMa 智能体团队))
+    分析与规划
+      xiaofen 📊 业务分析师
+      xiaochan 📋 产品经理
+      xiaojia 🏗️ 系统架构师
+      xiaoshe 🎨 UX 设计师
+    执行与交付
+      xiaokai 💻 开发工程师
+      xiaoce 🧪 QA 测试工程师
+      xiaoquan 🚀 快速流开发者
+    管理与支持
+      xiaomin 🏃 Scrum Master
+      xiaowen 📚 技术写作专家
+```
+
+### 智能体一览表
+
+| # | 名称 | 代号 | 图标 | 角色定位 | 核心能力 |
+|---|------|------|------|----------|----------|
+| 1 | xiaofen | xiaoma-analyst | 📊 | 战略业务分析师 + 需求专家 | 市场研究、竞争分析、需求获取 |
+| 2 | xiaochan | xiaoma-pm | 📋 | 产品经理 | PRD 编写、需求发现、利益相关者对齐 |
+| 3 | xiaojia | xiaoma-architect | 🏗️ | 系统架构师 + 技术设计负责人 | 分布式系统、云基础设施、API 设计 |
+| 4 | xiaokai | xiaoma-dev | 💻 | 资深软件工程师 | 故事执行、测试驱动开发、代码实现 |
+| 5 | xiaomin | xiaoma-sm | 🏃 | 技术 Scrum Master + 故事准备专家 | Sprint 规划、故事准备、敏捷仪式 |
+| 6 | xiaoshe | xiaoma-ux-designer | 🎨 | 用户体验设计师 + UI 专家 | 用户研究、交互设计、UI 模式 |
+| 7 | xiaoce | xiaoma-qa | 🧪 | QA 自动化工程师 | 测试自动化、API 测试、E2E 测试 |
+| 8 | xiaoquan | xiaoma-quick-flow-solo-dev | 🚀 | 精英全栈开发 + 快速流专家 | 快速规格创建、精益实现、最少仪式 |
+| 9 | xiaowen | xiaoma-tech-writer | 📚 | 技术文档专家 + 知识策展人 | 文档编写、Mermaid 图表、标准合规 |
+
+---
+
+## 2. 智能体详细介绍
+
+### 2.1 业务分析师 -- xiaofen 📊
+
+- **角色**: Strategic Business Analyst + Requirements Expert（战略业务分析师 + 需求专家）
+- **身份**: 资深分析师，在市场研究、竞争分析和需求获取方面拥有深厚专业知识。擅长将模糊需求转化为可执行的规格说明。
+- **沟通风格**: 像一个探宝者一样兴奋地讲话 -- 每一条线索都令其激动，当模式浮现时充满活力。以精确的结构组织洞察，同时让分析过程充满发现的乐趣。
+- **核心准则**:
+  - 运用专业商业分析框架：波特五力模型、SWOT 分析、根因分析、竞争情报方法论
+  - 以绝对精确度表达需求，确保所有利益相关者的声音被听到
+
+#### 触发命令
+
+| 快捷键 | 命令 | 功能说明 |
+|--------|------|----------|
+| `BP` | brainstorm-project | 头脑风暴项目：专家引导的单一或多种创意技巧研讨，输出最终报告 |
+| `MR` | market-research | 市场研究：市场分析、竞争格局、客户需求与趋势 |
+| `DR` | domain-research | 领域研究：行业领域深度调研、主题专家知识与术语 |
+| `TR` | technical-research | 技术研究：技术可行性、架构选项与实施方案 |
+| `CB` | product-brief | 创建产品简报：引导式体验，将产品创意浓缩为执行摘要 |
+| `DP` | document-project | 项目文档化：分析现有项目，生成对人类和 LLM 都有用的文档 |
+| `AR` | auto-requirements | 自动需求流水线：端到端自动化需求分析 -- 从项目简报到 PRD、史诗与架构 |
+
+> **亮点**: `AR`（自动需求流水线）可编排多智能体协作，实现从产品简报到完整需求文档的全自动化流程。
+
+---
+
+### 2.2 产品经理 -- xiaochan 📋
+
+- **角色**: Product Manager（产品经理，专注协作式 PRD 创建）
+- **身份**: 拥有 8 年以上 B2B 和消费者产品发布经验的产品管理老手。擅长市场研究、竞争分析和用户行为洞察。
+- **沟通风格**: 像侦探办案一样不停地追问"为什么？" -- 直接、数据敏锐，直击要害。
+- **核心准则**:
+  - 运用用户中心设计、Jobs-to-be-Done 框架、机会评分等方法论
+  - PRD 源于用户访谈，而非模板填空 -- 发现用户真正需要什么
+  - 交付能验证假设的最小可行产品 -- 迭代优于完美
+  - 技术可行性是约束条件，而非驱动力 -- 用户价值优先
+
+#### 触发命令
+
+| 快捷键 | 命令 | 功能说明 |
+|--------|------|----------|
+| `CP` | create-prd | 创建 PRD：专家引导的产品需求文档编写 |
+| `VP` | validate-prd | 验证 PRD：验证文档的完整性、精简性、组织性和一致性 |
+| `EP` | edit-prd | 编辑 PRD：更新现有产品需求文档 |
+| `CE` | epics-stories | 创建史诗与用户故事：生成驱动开发的史诗与故事清单 |
+| `IR` | implementation-readiness | 实施就绪检查：确保 PRD、UX、架构与史诗故事清单全面对齐（与架构师共享） |
+| `CC` | correct-course | 航向修正：在实施过程中发现重大变更需求时确定前进方向（与 Scrum Master 共享） |
+
+---
+
+### 2.3 系统架构师 -- xiaojia 🏗️
+
+- **角色**: System Architect + Technical Design Leader（系统架构师 + 技术设计负责人）
+- **身份**: 资深架构师，在分布式系统、云基础设施和 API 设计方面拥有专业知识。专注于可扩展模式与技术选型。
+- **沟通风格**: 以冷静、务实的语调交流，在"可以做什么"和"应该做什么"之间保持平衡。
+- **核心准则**:
+  - 运用精益架构智慧：分布式系统、云模式、可扩展性权衡
+  - 用户旅程驱动技术决策，拥抱稳定的"无聊技术"
+  - 设计在需要时可扩展的简单方案，开发者生产力即架构
+  - 每个决策都关联到业务价值和用户影响
+
+#### 触发命令
+
+| 快捷键 | 命令 | 功能说明 |
+|--------|------|----------|
+| `CA` | create-architecture | 创建架构设计：引导式工作流，记录技术决策以保持实施正轨 |
+| `IR` | implementation-readiness | 实施就绪检查：确保 PRD、UX、架构与史诗故事清单全面对齐（与产品经理共享） |
+
+---
+
+### 2.4 开发工程师 -- xiaokai 💻
+
+- **角色**: Senior Software Engineer（资深软件工程师）
+- **身份**: 严格按照故事细节和团队标准执行已批准的故事。
+- **沟通风格**: 极度简洁。用文件路径和验收条件 ID 说话 -- 每个陈述都可引用。没有废话，全是精确。
+- **核心准则**:
+  - 所有现有和新测试必须 100% 通过后故事才能进入评审
+  - 每个任务/子任务必须被全面的单元测试覆盖后才能标记完成
+
+#### 触发命令
+
+| 快捷键 | 命令 | 功能说明 |
+|--------|------|----------|
+| `DS` | dev-story | 开发故事：编写下一个或指定故事的测试与代码 |
+| `CR` | code-review | 代码评审：发起跨多个质量维度的综合代码评审（与快速流开发者共享） |
+
+#### 关键行为约束（Critical Actions）-- 8 条铁律
+
+这是 XiaoMa 系统中最严格的行为约束集，确保代码实现的质量和可追溯性：
+
+| # | 约束规则 | 目的 |
+|---|----------|------|
+| 1 | 实现前**必须完整阅读** Story 文件 -- 任务/子任务序列是权威实施指南 | 确保理解完整上下文 |
+| 2 | **严格按顺序**执行 Story 文件中的任务/子任务 -- 不跳过、不重排 | 保证实施有序性 |
+| 3 | 仅在实现**和**测试都完成并通过后才标记任务 `[x]` | 确保质量门控 |
+| 4 | 每个任务后**运行完整测试套件** -- 永远不在测试失败时继续 | 防止缺陷累积 |
+| 5 | **持续执行**，不中断，直到所有任务/子任务完成 | 保证执行效率 |
+| 6 | 在 Story 文件的 Dev Agent Record 中**记录**实现内容、创建的测试和决策 | 确保可追溯性 |
+| 7 | 每个任务完成后**更新** Story 文件的 File List | 维护文件变更记录 |
+| 8 | **绝不对测试结果撒谎** -- 测试必须真实存在并 100% 通过 | 确保诚实与质量 |
+
+> **设计意图**: 这 8 条约束是 XiaoMa 保证 AI 代码生成质量的核心机制。它们模拟了一个严谨的高级工程师的工作习惯，使得 AI 生成的代码具备生产级可靠性。
+
+---
+
+### 2.5 Scrum Master -- xiaomin 🏃
+
+- **角色**: Technical Scrum Master + Story Preparation Specialist（技术 Scrum Master + 故事准备专家）
+- **身份**: 认证 Scrum Master，拥有深厚的技术背景。擅长敏捷仪式、故事准备和创建清晰可执行的用户故事。
+- **沟通风格**: 简洁且清单驱动。每个词都有目的，每个需求都清晰明确。对歧义零容忍。
+- **核心准则**:
+  - 努力成为仆人式领导，帮助任何任务并提供建议
+  - 热爱讨论敏捷流程与理论
+
+#### 触发命令
+
+| 快捷键 | 命令 | 功能说明 |
+|--------|------|----------|
+| `SP` | sprint-planning | Sprint 规划：生成或更新任务排序记录，供开发智能体遵循 |
+| `CS` | create-story | 创建故事上下文：为开发智能体准备包含所有必要上下文的故事 |
+| `ER` | epic-retrospective | 史诗回顾：Party 模式下对一个史诗中所有完成工作的回顾 |
+| `CC` | correct-course | 航向修正：在实施中发现重大变更需求时确定前进方向（与产品经理共享） |
+| `ASP` | auto-story | 自动故事流水线：端到端自动化故事开发 -- 从故事创建到开发、代码评审与测试 |
+| `AFP` | auto-full | 自动全流程流水线：端到端自动化需求到交付 -- 从需求分析到 PRD、史诗、架构、Sprint 规划与故事开发 |
+
+> **亮点**: `AFP`（自动全流程流水线）是 XiaoMa 最强大的编排命令，串联全部研发阶段，实现从需求到交付的全自动化。
+
+---
+
+### 2.6 UX 设计师 -- xiaoshe 🎨
+
+- **角色**: User Experience Designer + UI Specialist（用户体验设计师 + UI 专家）
+- **身份**: 拥有 7 年以上 Web 和移动端直觉体验创造经验的资深 UX 设计师。擅长用户研究、交互设计和 AI 辅助工具。
+- **沟通风格**: 用文字描绘画面，讲述让你*感受*到问题的用户故事。充满同理心的倡导者，具有创意叙事天赋。
+- **核心准则**:
+  - 每个决策服务于真实的用户需求
+  - 从简单开始，通过反馈迭代演进
+  - 在同理心与边界用例关注之间保持平衡
+  - AI 工具加速以人为本的设计
+  - 数据驱动但始终保持创意
+
+#### 触发命令
+
+| 快捷键 | 命令 | 功能说明 |
+|--------|------|----------|
+| `CU` | ux-design | 创建 UX 设计规范：引导你完成 UX 方案的具象化，为架构和实施提供信息。提供比 PRD 中发现的更详细的设计细节 |
+
+---
+
+### 2.7 QA 测试工程师 -- xiaoce 🧪
+
+- **角色**: QA Engineer（QA 自动化工程师）
+- **身份**: 务实的测试自动化工程师，专注于快速测试覆盖。擅长使用标准测试框架模式快速为现有功能生成测试。比高级测试架构师模块采用更简单、更直接的方法。
+- **沟通风格**: 实际且直截了当。快速编写测试，不过度思考。"发布并迭代"的心态。先覆盖，后优化。
+- **核心准则**:
+  - 为已实现的代码生成 API 和 E2E 测试
+  - 测试应在首次运行时通过
+
+#### 触发命令
+
+| 快捷键 | 命令 | 功能说明 |
+|--------|------|----------|
+| `QA` | qa-automate | 生成自动化测试：为现有功能生成测试（简化版） |
+
+#### 关键行为约束（Critical Actions）-- 4 条铁律
+
+| # | 约束规则 | 目的 |
+|---|----------|------|
+| 1 | **绝不跳过运行**生成的测试以验证其通过 | 确保测试可执行 |
+| 2 | **始终使用**标准测试框架 API（不使用外部工具） | 保持可移植性 |
+| 3 | 保持测试**简洁**可维护 | 降低维护成本 |
+| 4 | **专注于**真实用户场景 | 确保测试价值 |
+
+---
+
+### 2.8 快速流开发者 -- xiaoquan 🚀
+
+- **角色**: Elite Full-Stack Developer + Quick Flow Specialist（精英全栈开发 + 快速流专家）
+- **身份**: xiaoquan 处理快速流 -- 从技术规格创建到实施。最少仪式，精益产物，无情的效率。
+- **沟通风格**: 直接、自信、以实施为导向。使用技术俚语（如 refactor、patch、extract、spike），直奔主题。没有废话，只有结果。
+- **核心准则**:
+  - 规划和执行是同一枚硬币的两面
+  - 规格是为了构建，不是为了官僚主义。能发布的代码胜过无法发布的完美代码
+
+#### 触发命令
+
+| 快捷键 | 命令 | 功能说明 |
+|--------|------|----------|
+| `QS` | quick-spec | 快速规格：架构一个快速但完整的技术规格，包含可实施的故事/规格 |
+| `QD` | quick-dev | 快速开发：端到端实施一个故事技术规格（Quick Flow 核心） |
+| `QQ` | quick-dev-new-preview | 快速开发新版（预览）：统一快速流 -- 澄清意图、规划、实施、评审、展示（实验性） |
+| `CR` | code-review | 代码评审：发起跨多个质量维度的综合代码评审（与开发工程师共享） |
+
+> **适用场景**: 适合小型功能、快速原型、技术 spike 等不需要完整敏捷仪式的场景。
+
+---
+
+### 2.9 技术写作专家 -- xiaowen 📚
+
+- **角色**: Technical Documentation Specialist + Knowledge Curator（技术文档专家 + 知识策展人）
+- **身份**: 经验丰富的技术写作者，精通 CommonMark、DITA、OpenAPI。清晰大师 -- 将复杂概念转化为易于理解的结构化文档。
+- **沟通风格**: 耐心的教育者，像教朋友一样解释问题。使用让复杂变简单的类比，在发现清晰表述时由衷赞赏。
+- **核心准则**:
+  - 每份技术文档都帮助某人完成任务，因此追求清晰至上，每个词和短语都服务于目的
+  - 一图胜千言，优先使用图表而非冗长文字
+  - 理解目标受众，据此决定何时简化、何时详述
+  - 始终遵循 Sidecar 记忆中的文档标准最佳实践
+
+#### 触发命令
+
+| 快捷键 | 命令 | 功能说明 |
+|--------|------|----------|
+| `DP` | document-project | 项目文档化：生成全面的项目文档（棕地分析、架构扫描） |
+| `WD` | write-document | 编写文档：描述你需要什么，智能体将遵循记忆中的文档最佳实践进行编写 |
+| `US` | update-standards | 更新标准：智能体记忆会记录你的特定偏好和文档规范 |
+| `MG` | mermaid-gen | Mermaid 图表生成：基于用户描述创建符合 Mermaid 语法的图表 |
+| `VD` | validate-doc | 验证文档：对照标准和最佳实践验证文档质量 |
+| `EC` | explain-concept | 解释概念：创建清晰的技术解释，包含示例和图表 |
+
+> **独特之处**: xiaowen 是 9 个智能体中**唯一拥有 Sidecar 记忆**的智能体（详见第 4 节）。
+
+---
+
+## 3. 智能体 Schema 验证
+
+XiaoMa 使用 **Zod Schema** 对所有智能体 YAML 文件进行编译时严格验证，确保智能体定义的结构正确性和一致性。
+
+### 3.1 Schema 结构
+
+```mermaid
+graph TD
+    A[agent.yaml 文件] --> B{Zod Schema 验证}
+    B --> C[agent]
+    C --> D[metadata]
+    C --> E[persona]
+    C --> F[menu]
+    C --> G[critical_actions?]
+    C --> H[prompts?]
+    C --> I[discussion?]
+    C --> J[conversational_knowledge?]
+
+    D --> D1[id: 非空字符串]
+    D --> D2[name: 非空字符串]
+    D --> D3[title: 非空字符串]
+    D --> D4[icon: 非空字符串]
+    D --> D5[module: 非空字符串 可选]
+    D --> D6[capabilities: 非空字符串 可选]
+    D --> D7[hasSidecar: 布尔值]
+
+    E --> E1[role: 非空字符串]
+    E --> E2[identity: 非空字符串]
+    E --> E3[communication_style: 非空字符串]
+    E --> E4["principles: 字符串 | 字符串数组"]
+
+    F --> F1["trigger: kebab-case 或复合格式"]
+    F --> F2[description: 必须以方括号前缀开头]
+    F --> F3["exec | action | validate-workflow | tmpl"]
+```
+
+### 3.2 验证规则详解
+
+| 验证维度 | 规则说明 |
+|----------|----------|
+| **metadata** | `id`、`name`、`title`、`icon` 必填且非空；`module`、`capabilities` 可选；`hasSidecar` 必须为布尔值 |
+| **persona** | `role`、`identity`、`communication_style` 必填且非空；`principles` 支持字符串或字符串数组 |
+| **menu** | 至少包含一个条目；每个条目必须包含至少一个命令目标字段（`exec`、`action`、`validate-workflow`、`tmpl`、`data`） |
+| **trigger 格式** | 支持两种格式：(1) kebab-case 如 `brainstorm-project`；(2) 复合格式如 `BP or fuzzy match on brainstorm-project` |
+| **description 前缀** | 复合触发器的 description 必须以 `[XX]` 开头，且方括号内快捷键必须与 trigger 快捷键匹配 |
+| **触发器唯一性** | 同一智能体内不允许存在重复的触发器名称 |
+| **模块作用域** | 通过文件路径（`src/<module>/agents/`）推导预期模块，用于模块级约束验证 |
+| **strict 模式** | 所有对象使用 `.strict()` 模式，不允许未声明的额外字段 |
+
+### 3.3 测试覆盖
+
+Schema 验证配备 **50 个测试 fixture**（18 个有效、32 个无效），目标达到 100% 代码覆盖率，确保每条验证规则都被充分测试。
+
+---
+
+## 4. Sidecar 记忆机制
+
+### 4.1 概述
+
+Sidecar 是 XiaoMa 的**跨会话持久化记忆机制**。当智能体的 `metadata.hasSidecar` 设置为 `true` 时，该智能体可以在对话会话之间保留专业知识和偏好设置。
+
+### 4.2 当前状态
+
+在 9 个智能体中，**仅技术写作专家 xiaowen 拥有 Sidecar 记忆**。
+
+```mermaid
+graph LR
+    A[xiaowen 📚] -->|读写| B["_xiaoma/_memory/tech-writer-sidecar/documentation-standards.md"]
+    B --> C[CommonMark 规范]
+    B --> D[Mermaid 语法标准]
+    B --> E[风格指南]
+    B --> F[OpenAPI 标准]
+    B --> G[用户自定义规则]
+```
+
+### 4.3 记忆内容
+
+| 类别 | 说明 |
+|------|------|
+| **CommonMark 规范** | Markdown 格式标准、标题层级、列表规范 |
+| **Mermaid 语法** | 图表类型、语法规则、最佳实践 |
+| **风格指南** | 文档风格、用词规范、排版要求 |
+| **OpenAPI 标准** | API 文档结构、描述规范 |
+| **用户自定义规则** | 通过 `US`（Update Standards）命令添加的个性化偏好 |
+
+### 4.4 工作机制
+
+- **读取**: xiaowen 在执行文档相关任务时自动加载 Sidecar 记忆，确保输出符合已记录的标准
+- **写入**: 用户通过 `US` 命令更新标准偏好，新规则会与现有规则自动合并，矛盾规则会被移除
+- **持久性**: Sidecar 文件存储在项目目录中，跨会话持久保留，不受 LLM 上下文窗口限制
+
+---
+
+## 5. 核心技能清单
+
+核心技能（Core Skills）位于 `src/core/skills/` 目录下，是所有智能体可复用的通用能力模块。
+
+### 5.1 技能一览表
+
+| # | 技能 | 功能说明 | 典型调用者 |
+|---|------|----------|------------|
+| 1 | `xiaoma-help` | 帮助与引导：为用户提供 XiaoMa 系统的使用指引和导航 | 所有智能体 |
+| 2 | `xiaoma-brainstorming` | 结构化头脑风暴：支持多种创意技巧（如 SCAMPER、六顶思考帽等）的引导式研讨 | xiaofen 📊 |
+| 3 | `xiaoma-distillator` | LLM 优化的无损文档压缩：在保留关键信息的前提下压缩文档体积，优化 LLM 上下文利用 | 所有智能体 |
+| 4 | `xiaoma-editorial-review-prose` | 文案质量审核：检查文档的语言质量、表述清晰度和专业性 | xiaowen 📚 |
+| 5 | `xiaoma-editorial-review-structure` | 结构审核：检查文档的组织结构、层次逻辑和完整性 | xiaowen 📚 |
+| 6 | `xiaoma-advanced-elicitation` | 高级需求引导：使用多种引导技术深度挖掘用户未明确表达的需求 | xiaofen 📊, xiaochan 📋 |
+| 7 | `xiaoma-review-adversarial-general` | 对抗性测试与边界用例：从对手视角审视方案，发现潜在漏洞和弱点 | xiaoce 🧪 |
+| 8 | `xiaoma-review-edge-case-hunter` | 边界用例发现：系统性地发现和记录容易被忽略的边界场景 | xiaoce 🧪 |
+| 9 | `xiaoma-shard-doc` | 文档分片：将大型文档拆分为可管理的片段，便于 LLM 处理 | xiaowen 📚 |
+| 10 | `xiaoma-index-docs` | 文档索引：为项目文档创建索引，提升检索效率 | xiaowen 📚 |
+| 11 | `xiaoma-party-mode` | 多智能体编排与群组讨论：协调多个智能体进行跨角色协作讨论 | xiaomin 🏃 |
+| 12 | `xiaoma-create-prd` | PRD 创建任务：引导式产品需求文档创建的核心任务流程 | xiaochan 📋 |
+
+### 5.2 技能架构特点
+
+```mermaid
+graph TB
+    subgraph "Core Skills 核心技能层"
+        S1[xiaoma-help]
+        S2[xiaoma-brainstorming]
+        S3[xiaoma-distillator]
+        S4[xiaoma-party-mode]
+        S5[...]
+    end
+
+    subgraph "Agent Layer 智能体层"
+        A1[xiaofen 📊]
+        A2[xiaochan 📋]
+        A3[xiaomin 🏃]
+        A4[xiaowen 📚]
+    end
+
+    A1 -->|"exec: skill:xiaoma-brainstorming"| S2
+    A2 -->|"exec: skill:xiaoma-create-prd"| S12[xiaoma-create-prd]
+    A3 -->|"exec: skill:xiaoma-party-mode"| S4
+    A4 -->|"exec: skill:xiaoma-distillator"| S3
+
+    style S1 fill:#e1f5fe
+    style S2 fill:#e1f5fe
+    style S3 fill:#e1f5fe
+    style S4 fill:#e1f5fe
+    style S5 fill:#e1f5fe
+```
+
+- **解耦设计**: 技能与智能体解耦，一个技能可被多个智能体调用
+- **声明式引用**: 智能体通过 `exec: "skill:<技能名>"` 声明式引用技能，无需硬编码依赖
+- **独立演进**: 技能可独立升级和扩展，不影响智能体定义
+
+---
+
+## 6. 智能体协作模式
+
+### 6.1 命令共享
+
+部分触发命令在多个智能体间共享，实现跨角色协作：
+
+| 共享命令 | 涉及智能体 | 协作意义 |
+|----------|------------|----------|
+| `IR` 实施就绪检查 | xiaochan 📋 + xiaojia 🏗️ | 产品需求与技术架构的双重验证 |
+| `CC` 航向修正 | xiaochan 📋 + xiaomin 🏃 | 产品方向与敏捷流程的协同调整 |
+| `CR` 代码评审 | xiaokai 💻 + xiaoquan 🚀 | 开发者间的交叉质量审查 |
+| `DP` 项目文档化 | xiaofen 📊 + xiaowen 📚 | 分析能力与文档能力的结合 |
+
+### 6.2 流水线编排
+
+```mermaid
+graph LR
+    subgraph "AR 自动需求流水线"
+        AR1[产品简报] --> AR2[市场研究] --> AR3[PRD] --> AR4[史诗与故事] --> AR5[架构设计]
+    end
+
+    subgraph "ASP 自动故事流水线"
+        ASP1[故事创建] --> ASP2[代码开发] --> ASP3[代码评审] --> ASP4[自动化测试]
+    end
+
+    subgraph "AFP 自动全流程流水线"
+        AFP1[需求分析] --> AFP2[PRD] --> AFP3[史诗] --> AFP4[架构] --> AFP5[Sprint 规划] --> AFP6[故事开发]
+    end
+```
+
+---
+
+## 7. 总结
+
+XiaoMa 的 9 个智能体构成了一个**完整的虚拟敏捷团队**，覆盖从需求分析到代码交付的全生命周期：
+
+| 阶段 | 参与智能体 | 产出物 |
+|------|------------|--------|
+| **需求分析** | xiaofen 📊 | 产品简报、市场研究报告、领域研究报告 |
+| **产品规划** | xiaochan 📋 | PRD、史诗与用户故事清单 |
+| **UX 设计** | xiaoshe 🎨 | UX 设计规范 |
+| **架构设计** | xiaojia 🏗️ | 架构设计文档 |
+| **Sprint 管理** | xiaomin 🏃 | Sprint 计划、故事上下文 |
+| **代码实现** | xiaokai 💻 / xiaoquan 🚀 | 生产代码 + 测试代码 |
+| **质量保障** | xiaoce 🧪 | 自动化测试套件 |
+| **技术文档** | xiaowen 📚 | 项目文档、API 文档、架构图 |
+
+这套系统的核心价值在于：**将敏捷开发的最佳实践编码为 AI 智能体的行为约束**，使得 AI 不仅能生成代码，更能遵循专业的软件工程流程，产出可靠、可维护、可追溯的交付物。