@zeyue0329/xiaoma-cli 1.13.0 → 1.15.0

package/docs/roadshow/05-/346/212/200/346/234/257/345/256/236/347/216/260/344/270/216/345/210/233/346/226/260/344/272/256/347/202/271.md

@@ -1,205 +0,0 @@
-# 技术实现与创新亮点
-
-## 1. Step-File 微架构 — 防上下文丢失机制
-
-**问题**: LLM 在长对话中容易丢失上下文，导致执行偏离
-**解决方案**: Step-File 微架构
-
-```mermaid
-flowchart TD
-    subgraph "传统方式"
-        T1[长提示词] --> T2[上下文膨胀] --> T3[执行偏离]
-    end
-
-    subgraph "Step-File 架构"
-        S1["workflow.md 入口"] --> S2["仅加载 step-01"]
-        S2 -->|完成后卸载| S3["仅加载 step-02"]
-        S3 -->|完成后卸载| S4["仅加载 step-03"]
-        S4 --> S5["..."]
-    end
-```
-
-**核心设计**:
-- 每次仅一个步骤文件在内存中
-- 步骤间通过状态变量传递信息
-- 前端元数据（frontmatter）跟踪进度
-- 阶段边界摘要防止信息丢失
-- 强制从磁盘重新读取（Fresh Reads）而非依赖记忆
-
-## 2. 配置驱动的 IDE 安装架构
-
-**问题**: 支持 25+ IDE 平台，每个平台有不同的目录结构和配置格式
-**解决方案**: 统一配置驱动
-
-```mermaid
-flowchart LR
-    PC["platform-codes.yaml\n平台注册表"] --> CDI["ConfigDrivenIdeSetup\n统一安装器"]
-    CDI --> C1[".claude/skills/"]
-    CDI --> C2[".cursor/skills/"]
-    CDI --> C3[".cline/skills/"]
-    CDI --> C4[".windsurf/skills/"]
-    CDI --> CN["... 25+ 平台"]
-```
-
-**设计优势**:
-- 零自定义代码：新增 IDE 只需在 YAML 中添加配置
-- 统一行为：所有平台使用相同安装逻辑
-- 灵活适配：支持不同目录结构、模板类型、技能格式
-- 遗留兼容：自动迁移旧版安装路径
-
-每个平台配置包含:
-```yaml
-platform_name:
-  name: "平台名称"
-  preferred: true/false
-  category: cli/ide
-  installer:
-    target_dir: .platform/skills
-    template_type: default
-    skill_format: true
-    ancestor_conflict_check: true
-```
-
-## 3. 占位符替换系统
-
-**问题**: 安装到不同项目需要动态配置
-**解决方案**: 安装时占位符替换
-
-支持的占位符:
-| 占位符 | 替换值 |
-|--------|--------|
-| `{_xiaoma}` | 实际 xiaoma 文件夹名 |
-| `{project-root}` | 项目根目录 |
-| `{module}` | 模块标识符 |
-| `{version}` | XiaoMa 版本号 |
-| `{date}` | 安装日期 |
-
-**嵌套变量引用**: 变量可以引用其他模块变量
-```
-output_folder: "_xiaoma-output"
-planning_artifacts: "{output_folder}/planning-artifacts"  # 解析为 _xiaoma-output/planning-artifacts
-```
-
-应用范围: Markdown、YAML、JSON、JS、TS、Shell 文件（二进制文件跳过）
-
-## 4. Manifest 驱动发现机制
-
-**问题**: IDE 需要知道安装了哪些智能体、工作流、技能
-**解决方案**: CSV 清单注册表
-
-生成的清单文件:
-| 清单 | 内容 | 用途 |
-|------|------|------|
-| agent-manifest.csv | 所有智能体元数据 | IDE 智能体发现 |
-| workflow-manifest.csv | 所有工作流元数据 | 工作流触发 |
-| task-manifest.csv | 所有任务元数据 | 任务执行 |
-| files-manifest.csv | 所有已安装文件 | 完整性校验 |
-
-**优势**: 无需运行时文件系统扫描，单一事实来源
-
-## 5. Zod Schema 验证体系
-
-**问题**: 智能体 YAML 定义需要严格的格式和语义校验
-**解决方案**: Zod 运行时类型验证
-
-验证规则:
-- 触发器格式: kebab-case 或复合格式 `XX or fuzzy match on trigger-name`
-- 描述前缀匹配: `[XX]` 必须与触发器快捷键一致
-- 触发器唯一性: 同一智能体内不允许重复
-- 模块作用域: 从文件路径推导并强制执行
-
-测试覆盖:
-- 50 个测试用例（18 个有效 + 32 个无效）
-- 目标 100% 分支覆盖率
-
-## 6. 质量门禁体系
-
-```mermaid
-flowchart LR
-    CODE[代码变更] --> LF["lint-staged\nHusky 钩子"]
-    LF --> L1["ESLint\nJS + YAML"]
-    LF --> L2["Prettier\n格式化"]
-
-    subgraph "npm run quality"
-        T1["test:schemas\nSchema验证测试"]
-        T2["test:refs\n交叉引用验证"]
-        T3["test:install\n安装组件测试"]
-        T4["validate:schemas\nSchema验证"]
-        T5["lint\nESLint零警告"]
-        T6["lint:md\nMarkdown检查"]
-        T7["format:check\nPrettier检查"]
-    end
-
-    L1 --> T1
-    L2 --> T1
-    T1 --> T2 --> T3 --> T4 --> T5 --> T6 --> T7
-    T7 --> PASS["质量通过"]
-```
-
-**零容忍策略**: `--max-warnings=0`，任何警告都会阻断
-
-## 7. 多智能体编排与状态管理
-
-### 批处理与重试循环
-
-```mermaid
-flowchart TD
-    INIT[流水线初始化] --> DISC[发现下一个故事]
-    DISC --> DEV[开发实现]
-    DEV --> REVIEW[代码评审]
-    REVIEW --> QA[QA测试]
-    QA -->|通过| CHECK{更多故事?}
-    QA -->|失败| FIX[Bug修复]
-    FIX -->|"迭代 <= 5"| QA
-    FIX -->|"迭代 > 5"| HALT["停止"]
-    CHECK -->|是| DISC
-    CHECK -->|否| DONE["全部完成"]
-```
-
-**状态持久化机制**:
-- `pipeline_status`: 流水线整体状态
-- `current_story_key`: 当前故事标识
-- `fix_iteration`: Bug 修复迭代计数
-- `stories_completed`: 完成故事计数
-- 批处理模式下循环重置 `current_story_path`
-
-### 角色切换协议
-流水线中智能体角色动态切换：
-- 每个步骤加载对应智能体的 persona
-- 角色切换时生成阶段摘要
-- 后续步骤从磁盘重新读取（而非依赖前序角色的记忆）
-
-## 8. Party 模式 — 多智能体群组讨论
-
-**创新点**: 在回顾等场景中，多个智能体以对话形式参与讨论
-
-格式示例:
-```
-xiaofen (业务分析师): 从需求角度看，这个Sprint...
-xiaojia (架构师): 架构决策方面...
-xiaokai (开发工程师): 实现过程中...
-```
-
-**设计原则**:
-- 心理安全：无指责文化
-- 聚焦系统和流程，而非个人
-- 结构化输出：史诗回顾 + 下一史诗准备
-
-## 9. 智能故事上下文引擎
-
-创建故事时，系统进行穷尽式信息收集:
-
-```mermaid
-flowchart TD
-    EPIC["epics.md"] --> SC[故事上下文引擎]
-    PRD["prd.md"] --> SC
-    ARCH["architecture.md"] --> SC
-    UX["ux-design.md"] --> SC
-    PREV["前序故事\n实现经验"] --> SC
-    GIT["Git 历史\n最近提交"] --> SC
-    WEB["Web 研究\n最新技术版本"] --> SC
-
-    SC --> STORY["story-file.md\n开发者不会犯错的\n完备上下文"]
-```
-
-**目标**: 提供足够完备的上下文，使开发智能体无需回溯任何历史即可正确实现

package/docs/roadshow/06-/350/267/257/346/274/224/346/200/273/347/273/223/344/270/216/346/274/224/347/244/272/345/273/272/350/256/256.md

@@ -1,167 +0,0 @@
-# 路演总结与演示建议
-
-## 1. 产品价值总结（面向管理层）
-
-### 核心价值主张
-
-XiaoMa-CLI 实现了 **AI 驱动的全流程敏捷开发**，将传统需要多人协作数周完成的软件开发流程，通过 9 个 AI 智能体的协同自动化，显著提升交付效率。
-
-### 业务价值
-
-- **效率提升**: 从需求到交付的全流程自动化，减少人工干预
-- **质量保障**: 多层质量门禁（PRD 验证、实施就绪检查、代码评审、QA 测试）
-- **标准化**: 统一的开发流程和文档标准
-- **可扩展**: 支持 25+ AI IDE 平台，适应不同团队工具偏好
-- **低门槛**: 一键安装，无需复杂配置
-
-### 适用场景
-
-- 新项目从零到一的快速启动
-- 棕地项目（已有代码库）的 AI 增强开发
-- 团队敏捷流程的标准化和自动化
-- AI 辅助代码评审和质量保障
-
-## 2. 技术创新总结（面向技术负责人）
-
-### 架构创新
-
-| 创新点               | 解决的问题           | 技术方案                          |
-| -------------------- | -------------------- | --------------------------------- |
-| Step-File 微架构     | LLM 长对话上下文丢失 | 步骤文件隔离 + 状态持久化         |
-| 配置驱动 IDE 安装    | 多平台适配复杂度     | 统一 YAML 配置 + 零代码扩展      |
-| 多智能体编排         | 复杂流程协调         | 流水线状态机 + 角色切换           |
-| 穷尽式上下文引擎     | 开发偏离需求         | 多源信息聚合到 Story 文件         |
-| Manifest 驱动发现    | IDE 集成发现机制     | CSV 清单 + 运行时零扫描           |
-| Zod Schema 验证      | 智能体定义一致性     | 运行时类型校验 + 100%覆盖         |
-
-### 技术指标
-
-- **零警告策略**: ESLint --max-warnings=0
-- **50 个 Schema 测试用例**: 18 有效 + 32 无效
-- **占位符系统**: 支持嵌套变量引用
-- **批处理重试**: Bug 修复最多 5 次迭代
-- **Fresh Reads 机制**: 始终从磁盘读取最新状态
-
-## 3. 核心数据指标
-
-```mermaid
-mindmap
-  root((XiaoMa-CLI))
-    智能体系统
-      9 个专业智能体
-      完整敏捷团队模拟
-      动态角色切换
-    工作流引擎
-      26 个结构化工作流
-      5 个开发阶段
-      3 条自动化流水线
-    技能库
-      12 个核心技能
-      50+ 工作流技能
-    平台支持
-      25+ AI IDE 平台
-      配置驱动零代码
-    质量体系
-      7 层质量门禁
-      50 个验证用例
-```
-
-## 4. 建议演示路径
-
-### 路径一：快速概览（15 分钟）
-
-适用于高管汇报、跨部门沟通等需要快速传递核心信息的场景。
-
-1. **开场**（2 分钟）: 项目定位和价值主张
-2. **架构总览**（3 分钟）: 两层架构 + 模块系统
-3. **智能体展示**（5 分钟）: 9 个智能体角色介绍 + 协作关系图
-4. **流水线演示**（3 分钟）: 自动全流程流水线的三阶段编排
-5. **总结**（2 分钟）: 核心数据指标 + 未来方向
-
-### 路径二：深度汇报（30 分钟）
-
-适用于技术委员会评审、项目立项答辩等需要深入了解技术方案的场景。
-
-1. **开场与背景**（3 分钟）: 问题域 + 产品定位
-2. **架构设计**（5 分钟）: 两层架构 + 模块系统 + CLI 安装流程
-3. **智能体系统**（7 分钟）: 9 个智能体详解 + Schema 验证 + Sidecar 记忆
-4. **工作流引擎**（7 分钟）: 5 阶段 26 工作流 + Step-File 微架构
-5. **自动化流水线**（5 分钟）: AR + ASP + AFP 三条流水线
-6. **技术创新**（3 分钟）: 核心创新亮点
-
-### 路径三：技术深潜（45 分钟）
-
-适用于技术团队内部分享、开发者大会等需要深入技术细节和现场演示的场景。
-
-在路径二基础上增加：
-
-- 现场安装演示（`npx @zeyue0329/xiaoma-cli install`）
-- 单故事开发全流程 Live Demo
-- 代码评审流程演示
-- 多 IDE 平台适配展示
-
-## 5. 演示建议
-
-### 关键演示要点
-
-1. **智能体人格化**: 展示每个智能体的角色定位和沟通风格差异，让观众感受到"团队协作"的真实感
-2. **流水线编排**: 重点展示 AFP（全流程流水线）如何自动编排多个智能体完成从需求到交付的全过程
-3. **质量门禁链**: 展示从 PRD 验证到代码评审的完整质量保障链，强调"AI 不仅写代码，更保障代码质量"
-4. **一键安装**: 演示 `npx xiaoma-cli install` 的交互式安装流程，突出"即插即用"的低门槛优势
-5. **多 IDE 支持**: 展示同一套智能体在 Claude Code 和 Cursor 中的无缝使用
-
-### 视觉建议
-
-- 使用本系列文档中的 Mermaid 图表作为 PPT 信息图基础
-- 智能体关系图适合作为核心展示页，能直观传递"AI 敏捷团队"的概念
-- 三大流水线流程图适合分页展示，每页聚焦一条流水线的价值
-- 状态机图适合解释 Story 生命周期，帮助观众理解开发全流程
-
-### 演示环境准备
-
-- 提前在演示机上安装好 Node.js v20+ 和目标 AI IDE
-- 准备一个干净的示例项目用于现场安装演示
-- 确保网络环境稳定（需要 npm 包下载）
-- 准备离线备份方案（提前录制演示视频）
-
-## 6. Q&A 预备问题
-
-### 管理层可能的提问
-
-| 问题                         | 建议回答方向                                                       |
-| ---------------------------- | ------------------------------------------------------------------ |
-| 与现有开发流程如何兼容？     | 支持棕地项目，渐进式采用，不强制替换现有流程                       |
-| 成本和 ROI？                 | 一键安装零额外成本，通过自动化减少重复工作，提升开发者产能         |
-| 数据安全？                   | 所有处理在本地完成，不上传代码到第三方服务，数据不出开发环境       |
-| 团队学习曲线？               | 交互式安装 + 帮助技能 + 技能等级适配（初级/中级/专家）            |
-| 支持的编程语言？             | 语言无关，支持任何编程语言的项目                                   |
-| 如何衡量引入后的效果？       | 可从需求到交付周期、代码评审通过率、文档完整度等维度进行对比       |
-
-### 技术负责人可能的提问
-
-| 问题                           | 建议回答方向                                                         |
-| ------------------------------ | -------------------------------------------------------------------- |
-| 如何保证 LLM 输出质量？       | Step-File 防偏离 + 多层验证 + 穷尽式上下文 + 重试机制               |
-| 如何扩展新的智能体？           | YAML 定义 + Zod Schema 验证 + 标准化菜单系统                        |
-| 如何集成到 CI/CD？             | 提供 CLI 命令行接口，可集成到任何自动化流程                          |
-| 与其他 AI 开发工具的区别？     | 全流程覆盖（不仅仅是代码生成），多智能体协作，结构化工作流          |
-| 自定义工作流？                 | 支持自定义模块（--custom-content），可扩展智能体和工作流             |
-| 对 LLM 提供商有锁定吗？       | 框架本身与 LLM 无关，通过 AI IDE 间接调用，支持任何 IDE 背后的模型  |
-
-## 7. 路演核心信息
-
-> **一句话定位**: XiaoMa-CLI 是业界首个实现从需求到交付全流程 AI 智能体协同的敏捷开发框架
->
-> **三个关键词**: 多智能体协同 · 全流程自动化 · 即插即用
->
-> **核心差异化**: 不是简单的代码生成工具，而是模拟完整敏捷团队的 AI 开发框架
-
-### 核心信息传递优先级
-
-1. **第一优先级 — 价值定位**: XiaoMa-CLI 用 AI 智能体模拟完整敏捷团队，覆盖从需求分析到代码交付的全生命周期
-2. **第二优先级 — 技术创新**: Step-File 微架构、穷尽式上下文引擎、配置驱动多平台适配等核心技术突破
-3. **第三优先级 — 落地能力**: 一键安装、25+ IDE 支持、语言无关、零额外成本
-
-### 结束语建议
-
-> XiaoMa-CLI 代表了 AI 辅助软件开发的下一个方向：不是让 AI 替代开发者，而是让每个开发者都拥有一支完整的 AI 敏捷团队。通过结构化的工作流编排和多智能体协同，我们将"AI 写代码"升级为"AI 做工程"。