@zeyue0329/xiaoma-cli 1.0.49 → 1.0.66

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

@@ -1,370 +0,0 @@
-# 自动化用户故事开发循环
-
-## 任务概述
-
-执行完整的自动化用户故事开发循环，从故事创建到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/batch-story-generation.md

@@ -1,354 +0,0 @@
-# Batch Story Generation - 批量用户故事生成
-
-## Task Overview
-
-**任务名称**: 批量用户故事生成  
-**任务ID**: batch-story-generation  
-**分类**: 需求分析与故事管理  
-**复杂度**: ⭐⭐⭐⭐⭐
-
-## Task Description
-
-基于完整的PRD文档，自动识别并批量生成整个需求范围内的所有用户故事。该任务将深度分析PRD结构，提取业务场景，创建完整的用户故事清单，并建立故事间的依赖关系。
-
-## Input Requirements
-
-### 必需输入
-
-1. **PRD文档** (prd.md)
-   - 完整的产品需求文档
-   - 包含功能模块、用户场景、业务流程
-
-2. **数据库设计** (database_design.md)
-   - 数据模型和实体关系
-   - 为故事生成提供数据层面的上下文
-
-3. **技术架构设计** (architecture.md) [可选]
-   - 系统架构和技术选型
-   - 用于确定技术实现约束
-
-## Processing Steps
-
-### 第1步: PRD深度分析
-
-```yaml
-prd_analysis:
-  structure_parsing:
-    - identify_feature_modules: 识别功能模块
-    - extract_user_scenarios: 提取用户场景
-    - analyze_business_flows: 分析业务流程
-    - identify_stakeholders: 识别利益相关者
-
-  requirements_categorization:
-    - functional_requirements: 功能性需求分类
-    - non_functional_requirements: 非功能性需求分类
-    - business_rules: 业务规则提取
-    - validation_requirements: 验证需求识别
-```
-
-### 第2步: 故事识别与分解
-
-```yaml
-story_identification:
-  story_extraction_rules:
-    - one_story_per_user_action: 每个用户操作一个故事
-    - crud_operation_separation: CRUD操作分离
-    - business_process_breakdown: 业务流程分解
-    - validation_scenario_isolation: 验证场景隔离
-
-  story_sizing_guidelines:
-    - small_story_preference: 优先小故事(1-3天)
-    - epic_breakdown: 大模块分解策略
-    - dependency_minimization: 依赖最小化
-```
-
-### 第3步: 故事优先级排序
-
-```yaml
-prioritization_algorithm:
-  priority_factors:
-    - business_value_score: 业务价值评分(1-10)
-    - technical_dependency: 技术依赖权重
-    - user_impact_level: 用户影响级别
-    - implementation_risk: 实现风险评估
-
-  priority_calculation:
-    formula: "business_value * user_impact / (dependency_weight + risk_factor)"
-
-  priority_levels:
-    - p0_critical: 关键路径故事
-    - p1_high: 高优先级故事
-    - p2_medium: 中等优先级故事
-    - p3_low: 低优先级故事
-```
-
-### 第4步: 依赖关系建立
-
-```yaml
-dependency_analysis:
-  dependency_types:
-    - technical_dependency: 技术实现依赖
-    - business_flow_dependency: 业务流程依赖
-    - data_dependency: 数据依赖关系
-    - ui_component_dependency: UI组件依赖
-
-  dependency_graph_construction:
-    - node_creation: 为每个故事创建节点
-    - edge_establishment: 建立依赖边
-    - cycle_detection: 循环依赖检测
-    - critical_path_identification: 关键路径识别
-```
-
-### 第5步: 增强故事生成
-
-```yaml
-enhanced_story_generation:
-  story_template: enhanced-story-with-database-tmpl.yaml
-
-  generation_process:
-    1. basic_story_structure: 基础故事结构生成
-    2. database_mapping_integration: 数据库映射集成
-    3. api_specification_creation: API规范创建
-    4. acceptance_criteria_definition: 验收标准定义
-    5. technical_implementation_notes: 技术实现说明
-
-  quality_validation:
-    - completeness_check: 完整性检查
-    - consistency_validation: 一致性验证
-    - testability_assessment: 可测试性评估
-```
-
-## Output Generation
-
-### 主要输出文件
-
-1. **project_story_backlog.md** - 项目故事积压清单
-2. **stories/** 目录 - 所有个体用户故事文件
-3. **story_dependency_graph.yaml** - 故事依赖关系图
-4. **development_roadmap.md** - 开发路线图
-5. **story_statistics.json** - 故事统计数据
-
-### 故事积压清单示例
-
-```markdown
-# 项目用户故事积压清单
-
-## 概览统计
-
-- **总故事数量**: 45个
-- **预计开发周期**: 8-10周
-- **关键路径故事**: 12个
-- **并行开发组**: 4组
-
-## 优先级分组
-
-### P0 - 关键路径 (12个故事)
-
-1. 用户注册与登录 (US001) - 前置依赖
-2. 权限管理基础 (US002) - 核心安全
-3. 主数据管理 (US003) - 数据基础
-   ...
-
-### P1 - 高优先级 (18个故事)
-
-1. 用户个人信息管理 (US013)
-2. 基础数据查询 (US014)
-   ...
-
-### P2 - 中优先级 (10个故事)
-
-### P3 - 低优先级 (5个故事)
-
-## 并行开发计划
-
-### 开发组A - 用户管理模块
-
-- US001: 用户注册与登录
-- US002: 权限管理基础
-- US013: 用户个人信息管理
-
-### 开发组B - 数据管理模块
-
-- US003: 主数据管理
-- US014: 基础数据查询
-- US025: 数据导出功能
-```
-
-### 依赖关系图示例
-
-```yaml
-# story_dependency_graph.yaml
-dependency_graph:
-  nodes:
-    - id: US001
-      title: "用户注册与登录"
-      priority: P0
-      estimated_effort: 3
-
-    - id: US002
-      title: "权限管理基础"
-      priority: P0
-      estimated_effort: 5
-
-  edges:
-    - from: US001
-      to: US002
-      type: technical_dependency
-      description: "权限管理需要用户身份认证"
-
-    - from: US002
-      to: US013
-      type: business_flow_dependency
-      description: "个人信息管理需要权限控制"
-
-critical_paths:
-  - path: [US001, US002, US013, US025]
-    duration: 15
-    description: "用户管理关键路径"
-
-parallel_groups:
-  - group_id: A
-    stories: [US001, US002, US013]
-    focus: "用户管理"
-
-  - group_id: B
-    stories: [US003, US014, US025]
-    focus: "数据管理"
-```
-
-## Automation Integration
-
-### 与全需求编排器集成
-
-```yaml
-integration_points:
-  trigger_command: "*generate-all-stories"
-
-  input_sources:
-    - file: "prd.md"
-      validator: prd_completeness_check
-    - file: "database_design.md"
-      validator: schema_consistency_check
-
-  output_handlers:
-    - target: "project_story_backlog.md"
-      post_processor: priority_validation
-    - target: "stories/"
-      post_processor: story_format_validation
-```
-
-### 质量控制检查点
-
-```yaml
-quality_gates:
-  story_completeness:
-    - all_sections_filled: 所有必需章节已填写
-    - acceptance_criteria_clear: 验收标准清晰
-    - database_mapping_complete: 数据库映射完整
-
-  story_consistency:
-    - naming_conventions: 命名规范一致性
-    - priority_logic: 优先级逻辑合理性
-    - dependency_validity: 依赖关系有效性
-
-  story_testability:
-    - measurable_criteria: 可量化的验收标准
-    - clear_test_scenarios: 清晰的测试场景
-    - edge_case_coverage: 边界案例覆盖
-```
-
-## Advanced Features
-
-### 智能故事优化
-
-```yaml
-story_optimization:
-  size_balancing:
-    - detect_oversized_stories: 检测过大故事
-    - auto_decomposition: 自动分解建议
-    - complexity_assessment: 复杂度评估
-
-  dependency_optimization:
-    - circular_dependency_resolution: 循环依赖解决
-    - critical_path_shortening: 关键路径优化
-    - parallel_opportunity_identification: 并行机会识别
-```
-
-### 动态调整能力
-
-```yaml
-dynamic_adjustment:
-  priority_rebalancing:
-    - business_priority_changes: 业务优先级变更响应
-    - technical_constraint_updates: 技术约束更新
-    - resource_availability_impact: 资源可用性影响
-
-  dependency_updates:
-    - new_dependency_detection: 新依赖关系检测
-    - obsolete_dependency_removal: 过时依赖移除
-    - dependency_impact_analysis: 依赖影响分析
-```
-
-## Error Handling
-
-### 常见问题处理
-
-```yaml
-error_scenarios:
-  incomplete_prd:
-    detection: "PRD缺少关键信息章节"
-    handling: "生成缺失信息提示，暂停生成"
-    recovery: "要求补充PRD信息后重新生成"
-
-  conflicting_requirements:
-    detection: "需求之间存在逻辑冲突"
-    handling: "标记冲突点，生成冲突报告"
-    recovery: "人工review和冲突解决"
-
-  circular_dependencies:
-    detection: "故事间存在循环依赖"
-    handling: "依赖环检测和报告"
-    recovery: "自动依赖重构建议"
-```
-
-### 质量保证措施
-
-```yaml
-quality_assurance:
-  validation_rules:
-    - story_format_compliance: 故事格式合规性
-    - business_logic_consistency: 业务逻辑一致性
-    - technical_feasibility: 技术可行性
-
-  automated_reviews:
-    - cross_story_impact_analysis: 跨故事影响分析
-    - integration_point_validation: 集成点验证
-    - performance_consideration_check: 性能考量检查
-```
-
-## Usage Examples
-
-### 基本使用
-
-```bash
-# 在全需求编排器中执行
-*agent full-requirement-orchestrator
-*generate-all-stories
-
-# 或在automation-orchestrator中执行
-*agent automation-orchestrator
-*execute batch-story-generation
-```
-
-### 高级配置
-
-```bash
-# 指定特定的PRD文档
-*generate-all-stories --prd custom_prd.md
-
-# 包含技术架构约束
-*generate-all-stories --include-architecture-constraints
-
-# 生成详细依赖分析
-*generate-all-stories --detailed-dependency-analysis
-```