@zeyue0329/xiaoma-cli 1.0.8 → 1.0.10

package/XiaoMa-Web/347/216/260/346/234/211/351/241/271/347/233/256/351/234/200/346/261/202/345/274/200/345/217/221/345/256/214/346/225/264/346/214/207/345/215/227.md

@@ -1,873 +0,0 @@
-# XiaoMa-Web 现有项目迭代开发完整操作指南
-
-## 概述
-
-本指南详细说明如何使用XiaoMa-Web智能体系统，将现有项目的DOC格式迭代需求文档转化为实际代码实现。每个步骤都包含具体的智能体、命令、完整prompt示例和预期输出。
-
-## 核心原则
-
-**对于现有项目的迭代开发，必须遵循以下顺序：**
-1. 先分析现有系统，理解当前能力边界
-2. 分析新需求与现有功能的差异
-3. 只开发真正需要的新增或修改部分
-4. 根据变更规模选择合适的开发路径
-
----
-
-## 第一步：分析现有项目系统
-
-### 使用智能体：Architect（架构师）
-
-#### 1.1 启动架构师智能体
-
-**输入命令：**
-```
-@architect
-```
-
-**预期响应：**
-```
-Hello! I'm xiaojia, the Architect. I specialize in holistic system design, 
-cross-stack optimization, and pragmatic technology selection. 
-Type *help to see available commands.
-```
-
-#### 1.2 执行项目分析
-
-**输入命令：**
-```
-*document-project
-```
-
-**完整Prompt示例（如果需要补充说明）：**
-```
-*document-project
-
-请分析当前项目的：
-1. 技术栈和框架
-2. 现有功能模块列表
-3. API接口清单
-4. 数据模型结构
-5. 业务逻辑流程
-6. 代码组织结构
-7. 已知的技术债务和限制
-
-重点关注：
-- 用户管理相关功能
-- 支付相关功能
-- 订单处理流程
-- 第三方集成情况
-```
-
-**预期输出：**
-架构师将生成包含以下内容的分析报告：
-- `Current System Analysis`
-- `Technology Stack`
-- `Feature Inventory`
-- `API Documentation`
-- `Data Models`
-- `Business Logic`
-- `Technical Constraints`
-
-#### 1.3 保存分析结果
-
-**输入命令：**
-```
-*doc-out
-```
-
-**系统将保存到：** `docs/current-system-analysis.md`
-
----
-
-## 第二步：分析需求差异
-
-### 使用智能体：Analyst（分析师）
-
-#### 2.1 启动分析师智能体
-
-**输入命令：**
-```
-@analyst
-```
-
-**预期响应：**
-```
-Hello! I'm xiaofen, the Business Analyst. I specialize in brainstorming, 
-market research, competitive analysis, and creating project briefs.
-Type *help to see available commands.
-```
-
-#### 2.2 上传并分析需求文档
-
-**输入命令：**
-```
-*elicit
-```
-
-**完整Prompt示例：**
-```
-*elicit
-
-我有一个迭代需求文档需要分析。这是一个现有电商系统的功能升级需求。
-
-[在此粘贴您的DOC需求文档内容]
-
-需求文档内容：
-1. 新增会员等级系统
-   - 铜牌、银牌、金牌、钻石四个等级
-   - 根据累计消费金额自动升级
-   - 不同等级享受不同折扣
-
-2. 优化订单查询功能
-   - 支持按时间范围查询
-   - 支持按商品名称模糊搜索
-   - 导出Excel功能
-
-3. 新增优惠券功能
-   - 满减券
-   - 折扣券
-   - 新用户专享券
-
-请帮我理解这些需求的核心业务目标。
-```
-
-**系统将使用1-9选项格式进行交互**
-
-#### 2.3 执行差异分析
-
-**输入命令：**
-```
-*brainstorm gap-analysis
-```
-
-**完整Prompt示例：**
-```
-*brainstorm gap-analysis
-
-基于刚才的需求文档和之前架构师分析的现有系统（docs/current-system-analysis.md），
-请进行差异分析：
-
-1. 识别完全新增的功能：
-   - 哪些是系统中完全不存在的新功能？
-   
-2. 识别需要修改的现有功能：
-   - 哪些现有功能需要升级或修改？
-   - 修改的影响范围有多大？
-   
-3. 识别可复用的部分：
-   - 现有哪些代码/模块可以直接复用？
-   - 需要做哪些小调整？
-
-4. 评估技术影响：
-   - 是否需要新的数据库表？
-   - 是否需要修改现有API？
-   - 是否影响现有用户体验？
-
-5. 风险评估：
-   - 可能破坏哪些现有功能？
-   - 数据迁移的复杂度如何？
-   - 对性能的影响如何？
-```
-
-**预期输出：差异分析报告**
-```
-## 需求差异分析报告
-
-### 完全新增功能
-1. 会员等级系统 - 全新模块
-2. 优惠券系统 - 全新模块
-
-### 需要修改的现有功能
-1. 订单查询功能 - 增强现有功能
-   - 现有：只支持订单号查询
-   - 新增：时间范围、商品名称查询、Excel导出
-
-### 可复用部分
-1. 用户认证系统 - 完全复用
-2. 订单基础架构 - 复用并扩展
-
-### 技术影响评估
-- 需要新建4个数据库表
-- 需要修改2个现有API
-- 需要新增6个API接口
-```
-
-#### 2.4 保存差异分析
-
-**输入命令：**
-```
-*doc-out
-```
-
-**系统将保存到：** `docs/gap-analysis.md`
-
----
-
-## 第三步：确定开发路径
-
-### 使用智能体：Product Manager（产品经理）
-
-#### 3.1 启动产品经理智能体
-
-**输入命令：**
-```
-@pm
-```
-
-**预期响应：**
-```
-Hello! I'm xiaochan, the Product Manager. I specialize in document creation 
-and product research. Type *help to see available commands.
-```
-
-#### 3.2 根据差异分析选择路径
-
-基于差异分析结果，选择合适的开发路径：
-
-### 路径A：小范围修改（1-2个功能点）
-
-**适用场景：** 只是订单查询的小优化
-
-**输入命令：**
-```
-*create-brownfield-story
-```
-
-**完整Prompt示例：**
-```
-*create-brownfield-story
-
-基于差异分析（docs/gap-analysis.md），我需要创建一个故事来实现订单查询优化：
-
-故事标题：优化订单查询功能
-故事描述：
-作为一个商家用户，
-我希望能够按时间范围和商品名称查询订单，
-以便更高效地管理订单。
-
-验收标准：
-1. 支持选择开始和结束日期进行查询
-2. 支持输入商品名称进行模糊搜索
-3. 查询结果可以导出为Excel文件
-4. 查询响应时间不超过2秒
-5. 保持与现有订单号查询的兼容性
-
-技术要点：
-- 优化数据库查询索引
-- 使用现有的Excel导出库
-- 前端添加日期选择器组件
-```
-
-### 路径B：中等规模（一个功能模块）
-
-**适用场景：** 单独的会员等级系统
-
-**输入命令：**
-```
-*create-brownfield-epic
-```
-
-**完整Prompt示例：**
-```
-*create-brownfield-epic
-
-基于差异分析，创建会员等级系统的Epic：
-
-Epic标题：实现会员等级系统
-Epic目标：建立完整的会员等级体系，提升用户忠诚度
-
-包含的故事：
-1. 故事1：创建会员等级数据模型
-   - 设计数据库表结构
-   - 实现等级计算逻辑
-   
-2. 故事2：实现自动升级机制
-   - 监听订单完成事件
-   - 计算累计消费
-   - 触发等级变更
-   
-3. 故事3：实现等级权益
-   - 不同等级的折扣计算
-   - 权益展示页面
-   
-4. 故事4：会员中心页面
-   - 显示当前等级
-   - 升级进度条
-   - 权益说明
-
-技术约束：
-- 使用现有用户系统
-- 复用订单事件机制
-- 确保向后兼容
-```
-
-### 路径C：大型迭代（多个模块或架构变更）
-
-**适用场景：** 完整的需求文档实现
-
-**输入命令：**
-```
-*create-brownfield-prd
-```
-
-**完整Prompt示例：**
-```
-*create-brownfield-prd
-
-基于差异分析报告，创建完整的产品需求文档。
-
-项目背景：
-现有电商系统需要增强用户运营能力，通过会员体系和优惠券系统提升用户粘性和复购率。
-
-## 需要包含的内容：
-
-### 1. 现有系统集成说明
-- 如何与现有用户系统集成
-- 如何复用订单模块
-- 如何保证数据一致性
-
-### 2. 功能需求（基于差异分析）
-
-#### 2.1 会员等级系统（全新）
-FR1: 系统应支持铜、银、金、钻石四个会员等级
-FR2: 系统应根据用户累计消费金额自动计算等级
-FR3: 系统应在订单完成后实时更新会员等级
-FR4: 系统应为不同等级提供不同的折扣率
-
-#### 2.2 订单查询优化（增强现有）
-FR5: 在现有订单号查询基础上，新增时间范围查询
-FR6: 新增商品名称模糊搜索功能
-FR7: 新增查询结果Excel导出功能
-
-#### 2.3 优惠券系统（全新）
-FR8: 系统应支持创建满减券、折扣券、新用户券
-FR9: 系统应支持优惠券的发放、领取、使用流程
-FR10: 系统应在订单结算时自动应用最优优惠券
-
-### 3. 非功能需求
-NFR1: 所有新功能必须向后兼容
-NFR2: 查询性能不能低于现有水平
-NFR3: 新增数据需支持增量备份
-
-### 4. 技术假设
-- 使用现有的MySQL数据库
-- 复用现有的Redis缓存
-- 前端使用现有的React框架
-- 保持现有的微服务架构
-
-### 5. Epic列表
-Epic 1: 会员等级系统实现
-Epic 2: 订单查询功能优化  
-Epic 3: 优惠券系统实现
-Epic 4: 系统集成与测试
-```
-
-#### 3.3 保存PRD文档
-
-**输入命令：**
-```
-*doc-out
-```
-
-**系统将保存到：** `docs/prd.md`
-
----
-
-## 第四步：技术评估（仅大型迭代需要）
-
-### 使用智能体：Architect（架构师）
-
-#### 4.1 评估是否需要架构文档
-
-**返回架构师：**
-```
-@architect
-```
-
-#### 4.2 创建架构文档（如需要）
-
-**输入命令：**
-```
-*create-brownfield-architecture
-```
-
-**完整Prompt示例：**
-```
-*create-brownfield-architecture
-
-基于PRD（docs/prd.md）和现有系统分析（docs/current-system-analysis.md），
-设计技术架构方案：
-
-## 需要考虑的架构变更：
-
-### 1. 数据库设计
-请设计新增的数据表：
-- member_levels: 会员等级定义表
-- user_member_info: 用户会员信息表
-- coupons: 优惠券定义表
-- user_coupons: 用户优惠券表
-
-### 2. API设计
-请设计新增和修改的API：
-- GET /api/v2/orders (修改：增加查询参数)
-- POST /api/v2/orders/export (新增：导出功能)
-- GET /api/member/level (新增：查询会员等级)
-- POST /api/member/calculate (新增：计算等级)
-- GET /api/coupons/available (新增：可用优惠券)
-- POST /api/coupons/apply (新增：应用优惠券)
-
-### 3. 服务集成方案
-- 如何集成到现有的订单服务
-- 如何实现事件驱动的等级更新
-- 如何确保事务一致性
-
-### 4. 数据迁移方案
-- 现有用户的初始等级设置
-- 历史订单数据的处理
-- 迁移期间的兼容性保证
-
-### 5. 性能优化方案
-- 缓存策略（Redis）
-- 数据库索引优化
-- 查询优化建议
-
-### 6. 安全考虑
-- 优惠券防刷策略
-- 等级计算防篡改
-- API限流保护
-```
-
-**预期输出：** 完整的架构设计文档
-
-#### 4.3 保存架构文档
-
-**输入命令：**
-```
-*doc-out
-```
-
-**系统将保存到：** `docs/architecture.md`
-
----
-
-## 第五步：文档验证和准备
-
-### 使用智能体：Product Owner（产品负责人）
-
-#### 5.1 启动产品负责人智能体
-
-**输入命令：**
-```
-@po
-```
-
-**预期响应：**
-```
-Hello! I'm xiaoguan, the Product Owner. I specialize in backlog management,
-story refinement, and prioritization. Type *help to see available commands.
-```
-
-#### 5.2 执行文档验证
-
-**输入命令：**
-```
-*execute-checklist-po
-```
-
-**系统将自动检查：**
-- PRD与架构文档的一致性
-- 需求的完整性
-- 技术方案的可行性
-- 风险是否都已识别
-
-#### 5.3 切分PRD文档
-
-**输入命令：**
-```
-*shard-doc docs/prd.md docs/prd
-```
-
-**完整Prompt说明：**
-```
-将PRD文档按Epic切分成独立文件，便于后续故事创建：
-- docs/prd/epic-1-member-system.md
-- docs/prd/epic-2-order-query.md
-- docs/prd/epic-3-coupon-system.md
-- docs/prd/epic-4-integration.md
-```
-
-#### 5.4 切分架构文档
-
-**输入命令：**
-```
-*shard-doc docs/architecture.md docs/architecture
-```
-
-**完整Prompt说明：**
-```
-将架构文档按技术模块切分：
-- docs/architecture/database-design.md
-- docs/architecture/api-design.md
-- docs/architecture/service-integration.md
-- docs/architecture/migration-plan.md
-```
-
----
-
-## 第六步：创建开发故事
-
-### 使用智能体：Scrum Master
-
-#### 6.1 启动Scrum Master智能体
-
-**输入命令：**
-```
-@sm
-```
-
-**预期响应：**
-```
-Hello! I'm xiaomin, the Scrum Master. I specialize in story creation 
-and agile process guidance. Type *help to see available commands.
-```
-
-#### 6.2 创建第一个故事
-
-**输入命令：**
-```
-*draft
-```
-
-**系统交互过程：**
-```
-系统：正在识别下一个要创建的故事...
-系统：找到Epic 1，准备创建故事1.1：创建会员等级数据模型
-
-系统将自动：
-1. 读取docs/prd/epic-1-member-system.md
-2. 读取docs/architecture/database-design.md
-3. 提取相关技术细节
-4. 生成完整的故事文件
-```
-
-**生成的故事文件示例：** `docs/stories/1.1.story.md`
-```markdown
-# Story 1.1: 创建会员等级数据模型
-
-## Status: Draft
-
-## Story
-作为系统开发者，
-我需要创建会员等级相关的数据库表结构，
-以便支持会员等级系统的数据存储。
-
-## Acceptance Criteria
-1. 创建member_levels表，包含等级定义
-2. 创建user_member_info表，记录用户会员信息
-3. 添加必要的索引优化查询性能
-4. 编写数据库迁移脚本
-5. 通过所有单元测试
-
-## Dev Notes
-### 数据库表设计 [Source: architecture/database-design.md]
-```sql
-CREATE TABLE member_levels (
-  id INT PRIMARY KEY AUTO_INCREMENT,
-  level_name VARCHAR(50) NOT NULL,
-  min_amount DECIMAL(10,2) NOT NULL,
-  discount_rate DECIMAL(3,2) NOT NULL,
-  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
-);
-
-CREATE TABLE user_member_info (
-  user_id BIGINT PRIMARY KEY,
-  level_id INT NOT NULL,
-  total_amount DECIMAL(12,2) DEFAULT 0,
-  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-  FOREIGN KEY (level_id) REFERENCES member_levels(id)
-);
-```
-
-### 技术约束
-- 使用MySQL 5.7兼容语法
-- 遵循现有命名规范
-- 添加适当的索引
-
-## Tasks / Subtasks
-- [ ] 创建数据库迁移文件
-  - [ ] 编写up迁移脚本
-  - [ ] 编写down回滚脚本
-- [ ] 实现数据模型类
-  - [ ] 创建MemberLevel实体类
-  - [ ] 创建UserMemberInfo实体类
-- [ ] 编写单元测试
-  - [ ] 测试表创建
-  - [ ] 测试索引性能
-- [ ] 更新数据库文档
-```
-
-#### 6.3 验证故事草稿（可选）
-
-**返回PO验证：**
-```
-@po
-*validate-story-draft docs/stories/1.1.story.md
-```
-
----
-
-## 第七步：开发实现
-
-### 使用智能体：Developer（开发人员）
-
-#### 7.1 启动开发人员智能体
-
-**输入命令：**
-```
-@dev
-```
-
-**预期响应：**
-```
-Hello! I'm xiaokai, the Full Stack Developer. I specialize in code implementation,
-debugging, and best practices. Type *help to see available commands.
-```
-
-#### 7.2 开始开发故事
-
-**输入命令：**
-```
-*develop-story
-```
-
-**开发过程：**
-```
-系统：加载故事文件 docs/stories/1.1.story.md
-系统：读取项目配置 core-config.yaml
-系统：加载技术标准 docs/architecture/coding-standards.md
-
-执行任务1：创建数据库迁移文件
-- 创建文件：migrations/20240315_create_member_tables.sql
-- 编写up脚本
-- 编写down脚本
-- ✓ 任务完成
-
-执行任务2：实现数据模型类
-- 创建文件：src/models/MemberLevel.js
-- 创建文件：src/models/UserMemberInfo.js
-- 添加ORM映射
-- ✓ 任务完成
-
-执行任务3：编写单元测试
-- 创建文件：tests/models/MemberLevel.test.js
-- 创建文件：tests/models/UserMemberInfo.test.js
-- 运行测试：npm test
-- ✓ 所有测试通过
-
-执行任务4：更新文档
-- 更新：docs/database-schema.md
-- ✓ 文档更新完成
-
-更新故事状态：Draft → Ready for Review
-```
-
-#### 7.3 运行测试验证
-
-**输入命令：**
-```
-*run-tests
-```
-
-**输出示例：**
-```
-运行代码检查...
-✓ ESLint: 0 errors, 0 warnings
-✓ 类型检查: No errors
-
-运行单元测试...
-✓ MemberLevel model tests: 5/5 passed
-✓ UserMemberInfo model tests: 4/4 passed
-✓ Migration tests: 2/2 passed
-
-运行集成测试...
-✓ Database connection: OK
-✓ Table creation: OK
-✓ Index performance: OK
-
-所有测试通过！
-```
-
----
-
-## 第八步：代码审查（可选但推荐）
-
-### 使用智能体：QA Engineer
-
-#### 8.1 启动QA智能体
-
-**输入命令：**
-```
-@qa
-```
-
-#### 8.2 执行代码审查
-
-**输入命令：**
-```
-*review docs/stories/1.1.story.md
-```
-
-**审查过程：**
-```
-系统：加载故事和相关代码...
-系统：检查代码质量...
-
-发现的问题：
-1. ✓ 代码符合编码规范
-2. ⚠ 建议：添加数据库连接池优化
-3. ✓ 测试覆盖率：95%
-4. ⚠ 建议：添加并发测试用例
-
-直接修复的问题：
-- 优化了SQL查询性能
-- 添加了缺失的错误处理
-- 改进了日志记录
-
-需要开发者处理的问题：
-- [ ] 添加并发测试用例
-- [ ] 考虑添加缓存层
-
-更新故事状态：Review → Done（如果没有阻塞问题）
-```
-
----
-
-## 第九步：继续下一个故事
-
-### 重复步骤6-8，直到所有故事完成
-
-#### 9.1 创建下一个故事
-
-**返回Scrum Master：**
-```
-@sm
-*draft
-```
-
-**系统提示：**
-```
-系统：故事1.1已完成
-系统：准备创建故事1.2：实现自动升级机制
-```
-
-#### 9.2 开发实现
-
-**返回Developer：**
-```
-@dev
-*develop-story
-```
-
-#### 9.3 代码审查
-
-**返回QA：**
-```
-@qa
-*review docs/stories/1.2.story.md
-```
-
----
-
-## 完整执行流程总结
-
-### 快速命令序列（最小路径）
-
-```bash
-# 1. 分析现有系统
-@architect
-*document-project
-*doc-out
-
-# 2. 分析需求差异
-@analyst
-*elicit  # 粘贴需求文档
-*brainstorm gap-analysis
-*doc-out
-
-# 3. 选择开发路径（根据规模选择一个）
-@pm
-*create-brownfield-story     # 小改动
-# 或
-*create-brownfield-epic      # 中等规模
-# 或
-*create-brownfield-prd       # 大型迭代
-*doc-out
-
-# 4. 架构评估（仅大型迭代）
-@architect
-*create-brownfield-architecture
-*doc-out
-
-# 5. 文档准备
-@po
-*execute-checklist-po
-*shard-doc docs/prd.md docs/prd
-*shard-doc docs/architecture.md docs/architecture
-
-# 6-8. 开发循环（重复直到完成）
-@sm
-*draft
-
-@dev
-*develop-story
-*run-tests
-
-@qa
-*review docs/stories/X.X.story.md
-
-# 重复6-8直到所有故事完成
-```
-
-### 关键决策点
-
-1. **变更规模判断**
-   - 1-2个功能点 → brownfield-story
-   - 3-5个故事 → brownfield-epic
-   - 多模块/架构变更 → brownfield-prd
-
-2. **是否需要架构文档**
-   - 新技术栈 → 需要
-   - 数据库大改 → 需要
-   - 仅功能扩展 → 不需要
-
-3. **是否需要QA审查**
-   - 关键功能 → 需要
-   - 复杂逻辑 → 需要
-   - 简单CRUD → 可选
-
-### 时间估算
-
-- 小改动（1个故事）：2-4小时
-- 中等规模（1个Epic）：1-2天
-- 大型迭代（完整PRD）：3-5天
-
-### 注意事项
-
-1. **必须先执行document-project**，否则可能重复开发已有功能
-2. **差异分析很关键**，决定了后续所有工作量
-3. **根据实际规模选择路径**，不要过度设计
-4. **保持故事独立性**，每个故事2-4小时可完成
-5. **注重测试和审查**，确保不破坏现有功能
-
----
-
-## 结束
-
-当所有故事状态都变为"Done"时，迭代开发完成。确保：
-- 所有测试通过
-- 代码审查完成
-- 文档已更新
-- 没有遗留问题
-
-使用此流程，您可以高效、安全地完成现有项目的迭代开发。