@zeyue0329/xiaoma-cli 1.0.8 → 1.0.10

package/XiaoMa-Web/347/272/257/345/211/215/347/253/257/351/241/271/347/233/256Claude-Code/345/274/200/345/217/221/345/256/214/346/225/264/346/214/207/345/215/227.md

@@ -1,372 +0,0 @@
-# 纯前端Web项目 Claude Code 开发完整指南
-
-## 项目概述
-
-XiaoMa-Web 是一个通用AI智能体框架，包含10个智能体和6个工作流，专门用于敏捷驱动开发。对于纯前端项目，我们主要使用 **Greenfield UI 工作流**。
-
-## 10个智能体能力总结
-
-1. **analyst** (xiaofen 📊) - 商业分析师：市场研究、头脑风暴、项目简介
-2. **pm** (xiaochan 📋) - 产品经理：PRD创建、产品策略、功能优先级
-3. **ux-expert** (xiaoshe 🎨) - UX专家：UI/UX设计、前端规格、AI界面生成提示
-4. **architect** (xiaojia 🏗️) - 架构师：系统设计、技术选型、前端架构
-5. **po** (xiaoguan 📝) - 产品负责人：文档验证、需求拆分、流程把控
-6. **sm** (xiaomin 🏃) - Scrum Master：故事创建、敏捷流程、开发任务准备
-7. **dev** (xiaokai 💻) - 全栈开发者：代码实现、测试、调试
-8. **qa** (xiaoce 🧪) - 高级开发&QA：代码审查、重构、质量保证
-9. **xiaoma-master** - 项目总控
-10. **xiaoma-orchestrator** - Web UI 协调器
-
-## 完整开发流程指南
-
-### 第一步：项目环境准备
-
-#### 1.1 安装 XiaoMa 到新项目
-
-**命令窗口输入：**
-```bash
-mkdir my-frontend-project
-cd my-frontend-project
-npx xiaoma-web install
-```
-
-**执行效果：**
-- 创建项目目录结构
-- 安装 XiaoMa 智能体系统
-- 生成配置文件（.ai-rules/core-config.yaml）
-- 创建文档目录结构（docs/, docs/stories/, .ai/）
-
-**或者使用简化命令：**
-```bash
-npm run install:xiaoma
-```
-
-### 第二步：规划阶段（Planning Phase）
-
-#### 2.1 业务分析和项目简介
-
-**激活智能体：**
-```
-@analyst
-```
-
-**执行命令：**
-```
-*create-project-brief
-```
-
-**执行效果：**
-- 创建 `docs/project-brief.md`
-- 包含项目概念、目标市场、价值主张
-- 为后续PRD提供基础输入
-
-#### 2.2 产品需求文档(PRD)
-
-**激活智能体：**
-```
-@pm
-```
-
-**执行命令：**
-```
-*create-prd
-```
-
-**执行效果：**
-- 基于project-brief创建 `docs/prd.md`
-- 详细的功能需求和用户故事
-- 前端功能优先级排序
-
-#### 2.3 UI/UX规格设计
-
-**激活智能体：**
-```
-@ux-expert
-```
-
-**执行命令：**
-```
-*create-front-end-spec
-```
-
-**执行效果：**
-- 创建 `docs/front-end-spec.md`
-- 界面设计规格和交互流程
-- 组件设计和用户体验指南
-
-**可选：生成AI界面提示**
-```
-*generate-ui-prompt
-```
-
-**执行效果：**
-- 生成可用于v0、Lovable等AI工具的界面生成提示
-- 用户可在外部工具中生成界面原型
-
-#### 2.4 前端架构设计
-
-**激活智能体：**
-```
-@architect
-```
-
-**执行命令：**
-```
-*create-front-end-architecture
-```
-
-**执行效果：**
-- 创建 `docs/front-end-architecture.md`
-- 技术栈选择（React/Vue/Angular等）
-- 组件架构和状态管理
-- 构建工具和部署策略
-
-#### 2.5 文档验证和整合
-
-**激活智能体：**
-```
-@po
-```
-
-**执行命令：**
-```
-*execute-checklist-po
-```
-
-**执行效果：**
-- 验证所有文档的一致性
-- 确保PRD、规格和架构对齐
-- 识别遗漏或冲突的需求
-
-### 第三步：开发阶段（Development Phase）
-
-#### 3.1 文档拆分
-
-**激活智能体：**
-```
-@po
-```
-
-**执行命令：**
-```
-*shard-doc docs/prd.md docs/prd
-```
-
-**执行效果：**
-- 将大型PRD拆分成可管理的小文档
-- 创建 `docs/prd/` 目录存放拆分后的史诗
-- 每个史诗变成独立的开发单元
-
-**同时拆分架构文档：**
-```
-*shard-doc docs/front-end-architecture.md docs/architecture
-```
-
-#### 3.2 创建开发故事
-
-**激活智能体：**
-```
-@sm
-```
-
-**执行命令：**
-```
-*draft
-```
-
-**执行效果：**
-- 从拆分的文档中创建具体的开发故事
-- 生成 `docs/stories/story-001.md` 等文件
-- 每个故事包含：任务、验收标准、技术实现细节
-
-#### 3.3 实现开发故事
-
-**激活智能体：**
-```
-@dev
-```
-
-**执行命令：**
-```
-*develop-story
-```
-
-**执行效果：**
-- 读取当前故事的要求
-- 实现所需的前端功能
-- 创建/修改组件、页面、样式文件
-- 编写单元测试和集成测试
-- 更新故事状态为"Ready for Review"
-
-**运行测试：**
-```
-*run-tests
-```
-
-#### 3.4 质量保证和审查
-
-**激活智能体：**
-```
-@qa
-```
-
-**执行命令：**
-```
-*review
-```
-
-**执行效果：**
-- 审查开发者实现的代码
-- 进行重构和优化
-- 运行完整测试套件
-- 更新故事状态为"Done"或提供改进建议
-
-#### 3.5 循环开发
-
-重复步骤3.2-3.4，直到所有故事完成：
-- SM创建下一个故事 → Dev实现 → QA审查
-- 持续迭代直到整个项目完成
-
-### 第四步：项目完成验证
-
-#### 4.1 最终验证
-
-**激活智能体：**
-```
-@po
-```
-
-**执行命令：**
-```
-*execute-checklist-po
-```
-
-**执行效果：**
-- 验证所有功能已实现
-- 确认符合验收标准
-- 项目交付就绪
-
-## 重要命令速查表
-
-### 项目初始化
-```bash
-npx xiaoma-web install          # 交互式安装
-npm run install:xiaoma          # 快速安装
-npm run list:agents            # 查看可用智能体
-```
-
-### 智能体激活
-```
-@analyst    # 商业分析师
-@pm         # 产品经理  
-@ux-expert  # UX专家
-@architect  # 架构师
-@po         # 产品负责人
-@sm         # Scrum Master
-@dev        # 开发者
-@qa         # QA工程师
-```
-
-### 核心智能体命令
-```
-*help                    # 显示可用命令
-*create-project-brief    # 创建项目简介
-*create-prd             # 创建PRD
-*create-front-end-spec  # 创建前端规格
-*create-front-end-architecture # 创建前端架构
-*shard-doc              # 拆分文档
-*draft                  # 创建故事
-*develop-story          # 实现故事
-*review                 # 审查代码
-```
-
-## 文件结构说明
-
-执行完整流程后，项目结构如下：
-```
-my-frontend-project/
-├── .ai-rules/
-│   └── core-config.yaml        # XiaoMa配置
-├── docs/
-│   ├── project-brief.md         # 项目简介
-│   ├── prd.md                  # 产品需求文档
-│   ├── front-end-spec.md       # 前端规格
-│   ├── front-end-architecture.md # 前端架构
-│   ├── prd/                    # 拆分的PRD史诗
-│   ├── architecture/           # 拆分的架构文档
-│   └── stories/                # 开发故事
-└── src/                        # 实际代码（由dev智能体创建）
-```
-
-## Greenfield UI 工作流详解
-
-### 工作流序列图
-
-```mermaid
-graph TD
-    A[Start: UI Development] --> B[analyst: project-brief.md]
-    B --> C[pm: prd.md]
-    C --> D[ux-expert: front-end-spec.md]
-    D --> D2{Generate v0 prompt?}
-    D2 -->|Yes| D3[ux-expert: create v0 prompt]
-    D2 -->|No| E[architect: front-end-architecture.md]
-    D3 --> D4[User: generate UI in v0/Lovable]
-    D4 --> E
-    E --> F{Architecture suggests PRD changes?}
-    F -->|Yes| G[pm: update prd.md]
-    F -->|No| H[po: validate all artifacts]
-    G --> H
-    H --> I{PO finds issues?}
-    I -->|Yes| J[Return to relevant agent for fixes]
-    I -->|No| K[po: shard documents]
-    J --> H
-    
-    K --> L[sm: create story]
-    L --> M{Review draft story?}
-    M -->|Yes| N[analyst/pm: review & approve story]
-    M -->|No| O[dev: implement story]
-    N --> O
-    O --> P{QA review?}
-    P -->|Yes| Q[qa: review implementation]
-    P -->|No| R{More stories?}
-    Q --> S{QA found issues?}
-    S -->|Yes| T[dev: address QA feedback]
-    S -->|No| R
-    T --> Q
-    R -->|Yes| L
-    R -->|No| U{Epic retrospective?}
-    U -->|Yes| V[po: epic retrospective]
-    U -->|No| W[Project Complete]
-    V --> W
-```
-
-### 阶段切换指引
-
-**规划阶段 → 开发阶段转换点：**
-- 所有规划文档已创建并验证
-- PO确认文档质量和一致性
-- 开始文档拆分准备开发
-
-**开发阶段循环：**
-- SM创建故事 → Dev实现 → QA审查 → 循环直至完成
-
-## 关键成功因素
-
-1. **严格按照工作流顺序执行** - 每个阶段的输出是下个阶段的输入
-2. **文档先行** - 所有开发都基于明确的文档规格
-3. **迭代验证** - 每个阶段都有PO进行质量把关
-4. **故事驱动开发** - 将大型需求拆分成可管理的小任务
-5. **持续测试** - 每个故事实现后都要通过QA审查
-
-## 常见问题解答
-
-**Q: 可以跳过某些智能体吗？**
-A: 不建议。每个智能体都有特定职责，跳过可能导致文档不完整或开发混乱。
-
-**Q: 开发阶段可以修改需求吗？**
-A: 可以，但需要通过SM和PO进行正式的变更管理流程。
-
-**Q: 如何处理复杂的前端项目？**
-A: 利用文档拆分功能，将大型项目分解为多个独立的史诗和故事。
-
-这个工作流确保了从概念到代码的完整追踪，让AI智能体能够高效协作完成复杂的前端项目开发。

package/XiaoMa-Web/351/241/271/347/233/256/346/200/273/347/273/223/346/212/245/345/221/212.md

@@ -1,310 +0,0 @@
-# XiaoMa-Web 多智能体协同AI编程框架 项目总结报告
-
-## 1. 项目概览与背景
-
-### 项目简介
-- **项目名称**: XiaoMa-Cli
-- **核心定位**: 敏捷驱动开发的多AI智能体协同服务
-- **技术特点**: 结构化提示、模板化工作流、多智能体协同
-
-### 项目价值主张
-- **问题解决**: 传统AI编程工具缺乏系统性协作机制，改变传统编程方式
-- **解决方案**: 构建专业化智能体团队，实现分工明确的敏捷开发
-- **核心优势**: 支持新项目(Greenfield)和现有项目(Brownfield)的全生命周期开发
-
----
-
-## 2. 项目架构分析
-
-### 核心架构组件
-```
-xiaoma-core/                    # 核心框架
-├── agents/                     # 10个专业智能体
-├── agent-teams/                # 团队配置
-├── workflows/                  # 6种工作流程
-├── templates/                  # 文档模板库
-├── tasks/                      # 具体任务定义
-├── checklists/                 # 质量保证检查单
-└── data/                       # 知识库配置
-
-tools/                          # 构建工具链
-├── cli.js                      # 命令行工具
-├── builders/web-builder.js     # Web UI打包器
-```
-
-### 智能体依赖系统
-- **资源依赖**: templates, tasks, checklists, data
-- **动态解析**: 通过DependencyResolver实现资源自动定位
-- **模块化设计**: 每个智能体独立定义所需资源
-
----
-
-## 3. 多智能体协同流程
-
-### 核心智能体角色分工
-
-#### 规划阶段智能体 (Web UI)
-- **📊 Analyst (xiaofen)**: 商业分析、市场研究、需求挖掘
-- **📋 PM (xiaochan)**: 产品需求文档、功能优先级、产品策略  
-- **🎨 UX Expert（xiaoshe）**: 用户体验设计、前端规范制定
-- **🏗️ Architect (xiaojia)**: 系统架构、技术选型、API设计
-- **👔 PO (xiaoguan)**: 产品负责人、文档验证、需求分片
-
-#### 开发阶段智能体 (IDE)
-- **🔄 Scrum Master (xiaomin)**: 故事创建、敏捷流程管理
-- **💻 Developer (xiaokai)**: 代码实现、调试、最佳实践
-- **🔍 QA Engineer（xiaoce）**: 代码审查、测试、质量保证
-
-### 协同机制设计
-- **两阶段开发**: 规划阶段(CLI/Web UI) + 开发阶段(IDE)
-- **文档驱动**: PRD → Architecture → Stories → Implementation
-- **质量闭环**: 每个阶段都有验证和审查机制
-
----
-
-## 4. 多智能体协同流程图
-
-```mermaid
-graph TB
-    subgraph "规划阶段 (Web UI平台)"
-        A[📊 Analyst<br/>需求分析师<br/>xiaofen] --> B[📋 PM<br/>产品经理<br/>xiaochan]
-        B --> C[🎨 UX Expert<br/>用户体验专家]
-        C --> D[🏗️ Architect<br/>架构师<br/>xiaojia]
-        D --> E[👔 PO<br/>产品负责人<br/>xiaoguan]
-        
-        A1[市场研究<br/>竞品分析] --> A
-        B1[PRD文档<br/>功能规格] --> B
-        C1[UI设计<br/>交互规范] --> C
-        D1[系统架构<br/>技术选型] --> D
-        E1[文档验证<br/>需求分片] --> E
-    end
-    
-    subgraph "开发阶段 (IDE环境)"
-        F[🔄 Scrum Master<br/>敏捷大师<br/>xiaomin] --> G[💻 Developer<br/>全栈开发<br/>xiaokai]
-        G --> H[🔍 QA Engineer<br/>质量保证]
-        H --> I{质量检查}
-        I -->|通过| J[✅ 故事完成]
-        I -->|需修复| G
-        
-        F1[故事创建<br/>任务分解] --> F
-        G1[代码实现<br/>单元测试] --> G
-        H1[代码审查<br/>重构优化] --> H
-    end
-    
-    subgraph "支撑系统"
-        K[📚 模板库<br/>Templates]
-        L[⚙️ 任务库<br/>Tasks]
-        M[✅ 检查单<br/>Checklists]
-        N[💡 知识库<br/>Data]
-    end
-    
-    %% 数据流向
-    E --> F
-    J --> O[📦 交付成果]
-    
-    %% 支撑关系
-    K -.-> B
-    K -.-> D
-    L -.-> F
-    L -.-> G
-    M -.-> E
-    M -.-> H
-    N -.-> A
-    N -.-> D
-    
-    %% 反馈循环
-    H -.->|反馈| E
-    G -.->|技术问题| D
-    
-    %% 样式定义
-    classDef planning fill:#e1f5fe,stroke:#01579b,stroke-width:2px
-    classDef development fill:#f3e5f5,stroke:#4a148c,stroke-width:2px
-    classDef support fill:#fff3e0,stroke:#e65100,stroke-width:2px
-    classDef output fill:#e8f5e8,stroke:#2e7d32,stroke-width:2px
-    
-    class A,B,C,D,E planning
-    class F,G,H development
-    class K,L,M,N support
-    class O output
-```
-
----
-
-## 5. 项目开发过程详解
-
-### 规划阶段工作流
-1. **需求分析** (Analyst)
-   - 执行 `*elicit` 命令收集需求
-   - 进行 `*brainstorm gap-analysis` 分析现有系统差异
-   - 生成市场研究和竞品分析报告
-
-2. **产品规划** (PM)  
-   - 根据规模选择路径：
-     - 小改动: `*create-brownfield-story`
-     - 中等规模: `*create-brownfield-epic`  
-     - 大型迭代: `*create-brownfield-prd`
-   - 生成完整的产品需求文档
-
-3. **架构设计** (Architect)
-   - 执行 `*document-project` 分析现有系统
-   - 使用 `*create-brownfield-architecture` 设计技术方案
-   - 制定数据库设计、API设计、集成方案
-
-4. **文档验证** (PO)
-   - 执行 `*execute-checklist-po` 验证文档完整性
-   - 使用 `*shard-doc` 切分大型文档便于开发
-   
-
-### 开发阶段工作流
-1. **故事创建** (Scrum Master)
-   - 执行 `*draft` 命令从PRD生成开发故事
-   - 自动包含验收标准、技术要求、子任务分解
-   - 新建用户故事，故事状态: Draft
-
-2. **📝 质量验证**
-   - PO 执行 `*execute-checklist-po` 进行主质量检查
-   - 执行 `*validate-story-draft` 验证文档一致性
-   - 如需调整，使用 `*correct-course` 修正方向
-   - 更新故事状态: Draft → Approved
-
-3. **代码实现** (Developer)
-   - 执行 `*develop-story` 实现具体功能
-   - 自动运行 `*run-tests` 进行代码验证
-   - 更新故事状态: Approved → Ready for Review
-
-4. **质量保证** (QA)
-   - 执行 `*review` 命令进行代码审查
-   - 直接修复小问题，标记需要开发者处理的问题
-   - 更新故事状态: Review → Done
-
-### 关键决策点
-- **变更规模判断**: 1-2功能点→story，3-5故事→epic，多模块→完整PRD
-- **架构文档必要性**: 新技术栈、数据库大改、架构变更需要架构文档
-- **QA审查策略**: 关键功能必须审查，简单CRUD可选
-
----
-
-## 6. 项目技术实现特色
-
-### 智能体激活机制
-```yaml
-activation-instructions:
-  - STEP 1: 读取完整文件包含的persona定义
-  - STEP 2: 采用agent和persona部分定义的角色
-  - STEP 3: 使用名称/角色唤起用户并使用*commond命令
-  - 关键规则: 只有在用户请求时才加载依赖文件
-```
-
-### 依赖解析系统
-- **文件解析**: `{root}/{type}/{name}` 格式
-- **动态加载**: 仅在命令执行时加载相关资源
-- **循环依赖检测**: 防止资源加载死循环
-
-### Web构建系统
-```javascript
-// 构建过程
-1. 解析智能体YAML配置提取依赖关系
-2. 通过DependencyResolver定位所有资源
-3. 处理智能体内容（清理IDE特定配置）
-4. 应用bundle特定路径转换
-5. 生成带清晰分隔符的分段输出
-```
-
-### 代码库扁平化
-- **智能过滤**: 遵循.gitignore规则，排除二进制文件
-- **流式处理**: 不是一次性读取整个文件到内存，而是一次读取一行或一小块，读取的内容立即写入输出流，不在内存中累积，即使处理几GB的代码库，内存使用也保持在较低水平
-- **进度跟踪**: 提供详细统计信息
-- **AI优化**: AI识别优化的输出格式
-
----
-
-## 7. 项目成果与效益
-
-### 核心交付成果
-1. **完整的智能体框架**: 10个专业智能体，6种工作流程
-2. **构建工具链**: CLI工具、Web打包器、项目安装器  
-3. **模板体系**: PRD、架构、故事等标准化模板
-4. **质量保证体系**: 检查单、代码审查、测试流程
-
-### 技术创新点
-- **两阶段开发模式**: 规划(CLI/Web UI) + 开发(IDE)的无缝切换
-- **文档驱动开发**: 从需求到代码的完整文档链路
-- **智能体专业化**: 每个智能体专注特定领域，提高效率
-- **依赖注入系统**: 动态资源加载，减少上下文开销
-- **质量闭环设计**: 每个阶段都有验证和反馈机制
-
-### 项目量化指标
-- **智能体数量**: 10个核心智能体
-- **工作流程**: 6种标准化流程(greenfield/brownfield × fullstack/ui/service)
-- **模板数量**: 20+个标准化文档模板
-- **任务库规模**: 50+个可复用任务定义
-- **代码行数**: 10000+行框架代码
-
----
-
-## 8. 未来多智能体协同AI Coding的价值展望
-
-### 短期价值 (1-2个月)
-1. **开发效率提升**
-   - 减少50%的需求理解时间
-   - 提高60%的代码生成速度
-   - 降低70%的架构设计迭代成本
-
-2. **质量保证增强** 
-   - 标准化开发流程，减少人为错误
-   - 自动化质量检查，提高代码质量
-   - 文档同步更新，降低维护成本
-
-### 中期价值 (3-6个月)
-1. **团队能力放大**
-   - 初级开发者可承担高级任务
-   - 跨领域知识快速转移
-   - 项目经验沉淀和复用
-
-2. **开发模式革新**
-   - 从单人编程到多智能体协作
-   - 从临时性工作到系统性开发
-   - 从经验驱动到数据驱动
-
-### 长期价值 (6-12个月)
-1. **软件工程变革**
-   - **自主化项目管理**: AI智能体自动处理需求变更、进度跟踪、风险识别
-   - **智能化架构演进**: 基于业务变化自动优化系统架构
-   - **预测性质量保证**: 基于历史数据预测和预防潜在问题
-
-2. **行业生态重构**
-   - **标准化开发流程**: 行业统一的智能体协作标准
-   - **知识图谱驱动**: 领域知识自动提取和应用
-   - **持续学习优化**: 智能体基于项目反馈持续改进
-
-### 社会价值影响
-1. **降低技术门槛**: 非技术人员也能参与复杂软件开发
-2. **加速创新周期**: 想法到产品的时间大幅缩短  
-3. **优化资源配置**: 人力资源从重复劳动转向创造性工作
-4. **推动数字化转型**: 企业更容易实现数字化升级
-
-### 技术发展趋势
-1. **智能体能力提升**: 从任务执行到战略思考
-2. **协作机制进化**: 从固定流程到动态协调
-3. **学习能力增强**: 从规则驱动到经验学习
-4. **生态系统成熟**: 从垂直工具到水平平台
-
----
-
-## 9. 总结与展望
-
-### 项目核心价值
-XiaoMa-Web框架成功构建了多智能体协同AI编程的完整解决方案，通过专业化分工、标准化流程、质量化保证，实现了从需求到交付的全生命周期自动化管理。
-
-### 技术突破意义
-- **方法论创新**: 首次系统化实现多智能体敏捷开发
-- **工程化实践**: 将AI编程从实验阶段推向产业应用
-- **生态系统构建**: 为未来AI开发工具提供参考架构
-
-### 未来发展方向
-1. **智能体能力扩展**: 支持更多编程语言和框架
-2. **协作机制优化**: 更智能的任务分配和冲突解决
-3. **学习能力增强**: 基于项目反馈的持续改进机制
-4. **生态系统建设**: 构建开放的智能体市场和知识共享平台
-
-**XiaoMa-Web不仅是一个技术框架，更是软件工程向智能化协作发展的重要里程碑，为未来AI驱动的软件开发奠定了坚实基础。**