@zeyue0329/xiaoma-cli 1.0.20 → 1.0.22

package/xiaoma-core/tasks/automated-story-cycle.md

@@ -0,0 +1,370 @@
+# 自动化用户故事开发循环
+
+## 任务概述
+
+执行完整的自动化用户故事开发循环，从故事创建到QA验收的端到端自动化流程。确保每个环节都有严格的质量控制和验证标准。
+
+## 前置条件检查
+
+- [ ] 数据库设计文档已完成 (`docs/database/database-design.md`)
+- [ ] 基础代码已生成 (`src/main/java/`)
+- [ ] Epic分解已完成 (`docs/epics/`)
+- [ ] 测试环境已准备就绪
+- [ ] 所有智能体处于可用状态
+
+## 执行流程
+
+### 阶段1: 用户故事创建 (SM智能体)
+
+#### 1.1 切换到SM智能体
+
+```bash
+*agent sm
+```
+
+#### 1.2 创建增强用户故事
+
+```bash
+*draft-enhanced
+```
+
+#### 1.3 创建后质量检查
+
+**必须验证的内容**:
+
+- [ ] 用户故事格式符合模板要求
+- [ ] 包含完整的数据库设计相关信息
+- [ ] API接口规范详细完整
+- [ ] 请求响应示例具体明确
+- [ ] 数据映射关系准确
+- [ ] 验收标准清晰可测试
+- [ ] 任务分解合理可执行
+
+#### 1.4 质量门控检查
+
+如果任何检查项不通过：
+
+- 记录问题详情
+- 重新执行故事创建（最多3次）
+- 超过重试次数则升级到项目经理
+
+### 阶段2: 故事验证 (PO智能体)
+
+#### 2.1 切换到PO智能体
+
+```bash
+*agent po
+```
+
+#### 2.2 执行故事验证
+
+```bash
+*validate-story-draft {story_file}
+```
+
+#### 2.3 验证检查清单
+
+**业务需求验证**:
+
+- [ ] 故事与PRD需求一致
+- [ ] 业务价值明确
+- [ ] 用户角色定义准确
+- [ ] 功能边界清晰
+
+**技术实现验证**:
+
+- [ ] 数据库实体设计合理
+- [ ] API接口设计符合规范
+- [ ] 技术实现方案可行
+- [ ] 性能要求现实
+
+**可测试性验证**:
+
+- [ ] 验收标准可验证
+- [ ] 测试数据准备充分
+- [ ] 测试场景覆盖完整
+- [ ] 错误处理考虑周全
+
+#### 2.4 验证结果处理
+
+**如果验证通过**:
+
+- 更新故事状态: `Draft → Approved`
+- 记录验证通过时间
+- 进入下一阶段
+
+**如果验证失败**:
+
+- 记录具体问题和修复建议
+- 返回SM智能体修复故事
+- 重复验证流程（最多3轮）
+
+### 阶段3: 代码开发 (Dev智能体)
+
+#### 3.1 切换到Dev智能体
+
+```bash
+*agent dev
+```
+
+#### 3.2 执行故事开发
+
+```bash
+*develop-story
+```
+
+#### 3.3 开发实现步骤
+
+**数据库层实现**:
+
+- [ ] 实现Mapper接口方法
+- [ ] 编写SQL映射文件
+- [ ] 添加数据验证逻辑
+- [ ] 处理数据库约束
+
+**业务逻辑层实现**:
+
+- [ ] 实现Service接口
+- [ ] 编写业务逻辑代码
+- [ ] 添加业务规则验证
+- [ ] 实现事务处理
+
+**API接口层实现**:
+
+- [ ] 实现Controller方法
+- [ ] 添加请求参数验证
+- [ ] 实现响应格式化
+- [ ] 添加异常处理
+
+**测试代码编写**:
+
+- [ ] 编写单元测试
+- [ ] 编写集成测试
+- [ ] 编写API测试
+- [ ] 编写数据库测试
+
+#### 3.4 执行自测
+
+```bash
+*run-tests
+```
+
+#### 3.5 自测验证标准
+
+**代码质量检查**:
+
+- [ ] 所有单元测试通过 (100%)
+- [ ] 代码覆盖率 ≥ 80%
+- [ ] 静态代码分析通过
+- [ ] 代码规范检查通过
+
+**功能验证检查**:
+
+- [ ] 所有API端点正常工作
+- [ ] 数据库操作正确执行
+- [ ] 业务逻辑符合需求
+- [ ] 错误处理机制有效
+
+**性能检查**:
+
+- [ ] API响应时间 < 500ms
+- [ ] 数据库查询优化
+- [ ] 内存使用合理
+- [ ] 并发处理正常
+
+#### 3.6 自测结果处理
+
+**如果自测通过**:
+
+- 更新故事状态: `Approved → Review`
+- 提交代码变更
+- 更新文件列表
+- 进入QA测试阶段
+
+**如果自测失败**:
+
+- 分析失败原因
+- 修复代码问题
+- 重新运行测试
+- 重复直到通过（最多5轮）
+
+### 阶段4: QA测试验证 (QA智能体)
+
+#### 4.1 切换到QA智能体
+
+```bash
+*agent qa
+```
+
+#### 4.2 执行QA测试
+
+```bash
+*review {story_file}
+```
+
+#### 4.3 QA测试检查清单
+
+**功能测试**:
+
+- [ ] 所有验收标准得到满足
+- [ ] 正常业务流程测试通过
+- [ ] 边界条件处理正确
+- [ ] 异常场景处理适当
+
+**API契约测试**:
+
+- [ ] 请求参数验证正确
+- [ ] 响应格式符合规范
+- [ ] HTTP状态码准确
+- [ ] 错误响应格式正确
+
+**数据完整性测试**:
+
+- [ ] 数据创建操作正确
+- [ ] 数据更新操作安全
+- [ ] 数据删除遵循软删除
+- [ ] 数据关联关系维护
+
+**性能测试**:
+
+- [ ] 响应时间满足要求
+- [ ] 并发处理能力充分
+- [ ] 内存使用效率高
+- [ ] 数据库查询优化
+
+**安全测试**:
+
+- [ ] 输入验证充分
+- [ ] SQL注入防护
+- [ ] XSS攻击防护
+- [ ] 权限控制有效
+
+#### 4.4 QA结果处理
+
+**如果QA测试通过**:
+
+- 更新故事状态: `Review → Done`
+- 记录测试通过时间
+- 生成QA测试报告
+- 当前故事开发完成
+
+**如果QA测试失败**:
+
+- 详细记录问题清单
+- 评估问题严重程度
+- 分配问题给Dev智能体
+- 更新故事状态: `Review → InProgress`
+- 返回开发阶段修复
+
+### 阶段5: 循环控制和完成检查
+
+#### 5.1 检查项目完成状态
+
+```bash
+*agent automation-orchestrator
+*check-completion-status
+```
+
+#### 5.2 完成状态评估
+
+**检查所有故事状态**:
+
+- [ ] 统计各状态故事数量
+- [ ] 识别阻塞和问题故事
+- [ ] 计算整体完成进度
+- [ ] 评估剩余工作量
+
+#### 5.3 决策分支
+
+**如果还有未完成故事**:
+
+- 启动下一个故事的开发循环
+- 重复阶段1-4的流程
+- 持续监控进度和质量
+
+**如果所有故事都已完成**:
+
+- 生成项目完成报告
+- 统计开发质量指标
+- 归档所有文档和代码
+- 标记项目开发阶段完成
+
+## 质量控制机制
+
+### 自动化验证
+
+- 每个阶段都有明确的通过标准
+- 自动化测试和检查工具
+- 质量门控严格执行
+- 问题自动识别和报告
+
+### 错误处理策略
+
+- 分类错误类型和严重程度
+- 差异化的重试和修复策略
+- 升级机制处理复杂问题
+- 问题追踪和解决记录
+
+### 进度监控
+
+- 实时跟踪每个故事的状态
+- 收集开发效率指标
+- 识别瓶颈和改进机会
+- 生成进度和质量报告
+
+## 输出文件
+
+### 故事文件
+
+- `docs/stories/{epic}.{story}.{title}.md` - 用户故事文档
+- `docs/stories/status-tracking.md` - 状态跟踪文档
+
+### 实现文件
+
+- `src/main/java/{package}/entity/` - 实体类
+- `src/main/java/{package}/mapper/` - Mapper接口
+- `src/main/java/{package}/service/` - 服务层
+- `src/main/java/{package}/controller/` - 控制层
+- `src/test/java/{package}/` - 测试代码
+
+### 报告文件
+
+- `docs/reports/development-progress.md` - 开发进度报告
+- `docs/reports/quality-metrics.md` - 质量指标报告
+- `docs/reports/completion-summary.md` - 完成总结报告
+
+## 成功标准
+
+### 个人故事成功标准
+
+- 故事状态达到 `Done`
+- 所有验收标准满足
+- 代码质量达标
+- 测试覆盖充分
+
+### 整体项目成功标准
+
+- 所有故事开发完成
+- 质量指标达到要求
+- 没有未解决的阻塞问题
+- 文档和代码完整
+
+## 故障恢复
+
+### 智能体故障
+
+- 自动重试机制
+- 备用智能体切换
+- 状态恢复和继续
+
+### 系统故障
+
+- 保存中间状态
+- 支持断点续传
+- 数据一致性保护
+
+### 人工介入
+
+- 提供人工接管接口
+- 支持手动状态修正
+- 保留自动化日志

package/xiaoma-core/tasks/create-database-design.md

@@ -7,7 +7,7 @@
 ## 前置条件
 
 - 已完成需求分析（PRD文档）
-- 已分析现有数据库结构（如果是棕地项目）
+- 已分析现有数据库结构（如果是现有项目项目）
 
 ## 执行步骤
 
@@ -134,7 +134,7 @@ INDEX idx_user_status (user_id, status)
 {DDL语句}
 ```
 
-### 8. 与现有结构对比（棕地项目）
+### 8. 与现有结构对比（现有项目项目）
 
 ```yaml
 action: compare_with_existing

package/xiaoma-core/tasks/create-enhanced-story-with-database.md

@@ -0,0 +1,250 @@
+# 创建增强用户故事（包含数据库和API设计）
+
+## 任务概述
+
+基于Epic分解，结合数据库设计和API接口规范，创建详细的用户故事文档。此任务要求深度集成database-architect生成的数据库设计和API接口设计。
+
+## 前置条件
+
+- 已完成Epic分解和优先级排序
+- 已有数据库设计文档 (`docs/database/database-design.md`)
+- 已有API接口设计文档
+- 已完成架构设计
+
+## 输入要求
+
+- Epic文档
+- 数据库设计文档
+- API接口设计文档
+- 架构设计文档
+
+## 执行步骤
+
+### 1. 分析Epic和设计文档
+
+#### 1.1 Epic分析
+
+- 确定用户故事的业务价值和优先级
+- 识别涉及的用户角色
+- 明确功能边界和范围
+
+#### 1.2 数据库设计分析
+
+- 从`docs/database/database-design.md`中识别相关实体
+- 确定涉及的数据表和字段
+- 分析数据操作类型（增删改查）
+- 理解业务规则和约束
+
+#### 1.3 API接口分析
+
+- 从API设计文档中识别相关接口
+- 确定HTTP方法和路径
+- 分析请求参数和响应格式
+- 理解错误处理机制
+
+### 2. 使用增强模板创建用户故事
+
+使用模板：`enhanced-story-with-database-tmpl.yaml`
+
+#### 2.1 基础信息填写
+
+```yaml
+epic_num: '{{epic_number}}'
+story_num: '{{story_number}}'
+story_title_short: '{{story_title}}'
+role: '{{user_role}}'
+action: '{{user_action}}'
+benefit: '{{user_benefit}}'
+```
+
+#### 2.2 数据库设计部分填写
+
+**相关实体表格**：
+
+```markdown
+| 实体名称 | 表名     | 主要用途     | 关键字段                     |
+| -------- | -------- | ------------ | ---------------------------- |
+| User     | users    | 用户信息管理 | id, username, email          |
+| Product  | products | 产品信息管理 | id, name, price, category_id |
+```
+
+**数据操作清单**：
+
+- 查询操作：明确需要的查询条件和返回字段
+- 插入操作：明确需要插入的数据和验证规则
+- 更新操作：明确可更新的字段和业务规则
+- 删除操作：明确删除条件和级联规则
+
+**业务规则约束**：
+
+- 数据验证规则（长度、格式、范围）
+- 外键约束和引用完整性
+- 唯一性约束
+- 业务逻辑约束（状态转换等）
+
+#### 2.3 API接口规范部分填写
+
+**API端点列表**：
+
+```markdown
+| 序号 | 接口名称     | HTTP方法 | 路径            | 说明               | 状态   |
+| ---- | ------------ | -------- | --------------- | ------------------ | ------ |
+| 1    | 创建用户     | POST     | /api/users      | 创建新用户账户     | 待实现 |
+| 2    | 查询用户详情 | GET      | /api/users/{id} | 根据ID查询用户信息 | 待实现 |
+```
+
+**API详细设计**：
+为每个API提供：
+
+- 完整的请求参数说明
+- 响应数据结构定义
+- 具体的请求示例（curl命令）
+- 成功和错误响应示例
+- 错误码定义和处理建议
+
+**数据映射关系**：
+
+```markdown
+#### 请求参数 -> 数据库字段映射
+
+| API参数  | 数据库表 | 数据库字段 | 数据类型     | 说明     |
+| -------- | -------- | ---------- | ------------ | -------- |
+| username | users    | username   | VARCHAR(50)  | 用户名   |
+| email    | users    | email      | VARCHAR(100) | 邮箱地址 |
+```
+
+#### 2.4 任务分解
+
+**后端开发任务**：
+
+- 数据库相关：Mapper方法实现、Service业务逻辑、数据验证
+- API接口实现：Controller方法、参数验证、响应格式化、异常处理
+- 测试相关：单元测试、集成测试、数据库测试
+
+**前端开发任务**（如需要）：
+
+- 页面组件实现
+- API调用集成
+- 表单验证
+- 用户交互
+
+#### 2.5 开发者说明
+
+**数据库上下文**：
+
+- 实体类位置：`src/main/java/{package}/entity/`
+- Mapper接口位置：`src/main/java/{package}/mapper/`
+- Service层位置：`src/main/java/{package}/service/`
+- 业务逻辑要求和数据验证规则
+
+**API接口上下文**：
+
+- Controller位置：`src/main/java/{package}/controller/`
+- 请求响应格式标准
+- 错误处理机制
+- 接口版本控制
+
+**集成上下文**：
+
+- 与其他模块的依赖关系
+- 外部系统调用要求
+- 缓存策略和事务处理
+- 性能要求
+
+### 3. 质量检查清单
+
+#### 3.1 完整性检查
+
+- [ ] 所有涉及的数据库实体都已识别
+- [ ] 所有需要的API接口都已定义
+- [ ] 请求参数和响应格式完整
+- [ ] 错误处理机制明确
+- [ ] 数据映射关系清晰
+
+#### 3.2 一致性检查
+
+- [ ] API参数与数据库字段对应
+- [ ] 数据类型一致
+- [ ] 业务规则与数据库约束匹配
+- [ ] 接口设计符合RESTful规范
+
+#### 3.3 可实现性检查
+
+- [ ] 任务分解合理可执行
+- [ ] 技术实现方案可行
+- [ ] 测试覆盖充分
+- [ ] 开发者说明详细
+
+### 4. 输出文件
+
+生成的用户故事文件：`docs/stories/{{epic_num}}.{{story_num}}.{{story_title_short}}.md`
+
+### 5. 后续协作
+
+#### 5.1 与开发者协作
+
+- 确保开发者理解数据库设计和API规范
+- 提供必要的技术支持和澄清
+- 跟踪开发进度和问题解决
+
+#### 5.2 与QA协作
+
+- 明确测试重点和验收标准
+- 提供API测试用例和数据
+- 确保质量标准得到执行
+
+## 模板使用示例
+
+### 示例：用户注册功能
+
+**用户故事**：
+
+> 作为新用户，我希望能够注册账户，以便使用系统的各项功能。
+
+**相关实体**：
+
+- Users表：存储用户基本信息
+- UserProfiles表：存储用户详细资料
+
+**涉及API**：
+
+- POST /api/users：创建用户账户
+- POST /api/users/verify-email：验证邮箱
+- GET /api/users/check-username：检查用户名可用性
+
+**数据操作**：
+
+- 插入用户基本信息到users表
+- 验证用户名和邮箱的唯一性
+- 创建用户会话信息
+
+**API详细设计**：
+
+```json
+// POST /api/users
+{
+  "username": "johndoe",
+  "email": "john@example.com",
+  "password": "hashedPassword"
+}
+
+// 响应
+{
+  "code": 200,
+  "message": "用户创建成功",
+  "data": {
+    "userId": 12345,
+    "username": "johndoe",
+    "email": "john@example.com",
+    "status": "active"
+  }
+}
+```
+
+## 注意事项
+
+1. **数据一致性**：确保API设计与数据库设计保持一致
+2. **安全性**：考虑数据验证、权限控制和敏感信息保护
+3. **性能**：关注查询效率和接口响应时间
+4. **可维护性**：保持代码结构清晰和文档完整
+5. **可测试性**：确保功能可以被充分测试