@zeyue0329/xiaoma-cli 1.0.22 → 1.0.24

package/xiaoma-core/scripts/build-validation/progressive-validation.sh

@@ -0,0 +1,88 @@
+#!/bin/bash
+# <!-- Powered by XIAOMA™ Core -->
+# 渐进式验证脚本
+# 分阶段验证，快速发现问题
+
+echo "🔄 执行渐进式验证..."
+echo "================================"
+
+# 阶段1：快速检查（30秒）
+echo ""
+echo "【阶段1】快速检查（目标: 30秒）"
+echo "--------------------------------"
+start_time=$(date +%s)
+
+mvn compile -q -DskipTests=true
+if [ $? -ne 0 ]; then
+    echo "❌ 阶段1失败：编译错误"
+    exit 1
+fi
+
+end_time=$(date +%s)
+duration=$((end_time - start_time))
+echo "✅ 阶段1完成（用时: ${duration}秒）"
+
+# 阶段2：单元测试（2分钟）
+echo ""
+echo "【阶段2】单元测试（目标: 2分钟）"
+echo "--------------------------------"
+start_time=$(date +%s)
+
+mvn test -Dtest=*Test -DskipIntegrationTests=true -q
+if [ $? -ne 0 ]; then
+    echo "❌ 阶段2失败：单元测试未通过"
+    echo "   运行 'mvn test' 查看详细错误"
+    exit 2
+fi
+
+end_time=$(date +%s)
+duration=$((end_time - start_time))
+echo "✅ 阶段2完成（用时: ${duration}秒）"
+
+# 阶段3：集成测试（5分钟）
+echo ""
+echo "【阶段3】集成测试（目标: 5分钟）"
+echo "--------------------------------"
+start_time=$(date +%s)
+
+# 检查是否有集成测试
+if ls src/test/java/**/*IntegrationTest.java 1> /dev/null 2>&1 || ls src/test/java/**/*IT.java 1> /dev/null 2>&1; then
+    mvn verify -DskipUnitTests=true -q
+    if [ $? -ne 0 ]; then
+        echo "❌ 阶段3失败：集成测试未通过"
+        exit 3
+    fi
+else
+    echo "  - 未找到集成测试，跳过"
+fi
+
+end_time=$(date +%s)
+duration=$((end_time - start_time))
+echo "✅ 阶段3完成（用时: ${duration}秒）"
+
+# 阶段4：打包验证（2分钟）
+echo ""
+echo "【阶段4】打包验证（目标: 2分钟）"
+echo "--------------------------------"
+start_time=$(date +%s)
+
+mvn package -DskipTests=true -q
+if [ $? -ne 0 ]; then
+    echo "❌ 阶段4失败：打包失败"
+    exit 4
+fi
+
+end_time=$(date +%s)
+duration=$((end_time - start_time))
+echo "✅ 阶段4完成（用时: ${duration}秒）"
+
+# 总结
+echo ""
+echo "================================"
+echo "🎯 渐进式验证完成！"
+echo "   ✓ 编译检查通过"
+echo "   ✓ 单元测试通过"
+echo "   ✓ 集成测试通过"
+echo "   ✓ 打包验证通过"
+echo ""
+echo "代码质量验证成功，可以提交！"

package/xiaoma-core/scripts/build-validation/quick-check.sh

@@ -0,0 +1,69 @@
+#!/bin/bash
+# <!-- Powered by XIAOMA™ Core -->
+# 30秒快速验证脚本
+# 用于开发过程中的快速反馈
+
+echo "⚡ 执行30秒快速验证..."
+echo "========================"
+
+# 设置超时
+timeout_duration=30
+
+# 使用timeout命令限制执行时间
+timeout $timeout_duration bash <<'EOF'
+set -e
+
+# 1. 快速编译检查（不清理）
+echo "→ 快速编译检查..."
+mvn compile -q -DskipTests=true
+if [ $? -eq 0 ]; then
+    echo "  ✓ 编译通过"
+else
+    echo "  ✗ 编译失败"
+    exit 1
+fi
+
+# 2. 测试编译检查
+echo "→ 测试编译检查..."
+mvn test-compile -q
+if [ $? -eq 0 ]; then
+    echo "  ✓ 测试编译通过"
+else
+    echo "  ✗ 测试编译失败"
+    exit 1
+fi
+
+# 3. 运行冒烟测试（如果存在）
+echo "→ 运行冒烟测试..."
+if ls src/test/java/**/*SmokeTest.java 1> /dev/null 2>&1; then
+    mvn surefire:test -Dtest=*SmokeTest -q
+    if [ $? -eq 0 ]; then
+        echo "  ✓ 冒烟测试通过"
+    else
+        echo "  ✗ 冒烟测试失败"
+        exit 1
+    fi
+else
+    echo "  - 未找到冒烟测试，跳过"
+fi
+
+echo ""
+echo "✅ 快速验证完成！"
+EOF
+
+exit_code=$?
+
+if [ $exit_code -eq 124 ]; then
+    echo ""
+    echo "⚠️  验证超时（超过30秒）"
+    echo "   建议检查编译性能"
+    exit 1
+elif [ $exit_code -ne 0 ]; then
+    echo ""
+    echo "❌ 快速验证失败"
+    echo "   请修复问题后重试"
+    exit $exit_code
+fi
+
+echo "========================"
+echo "⚡ 所有检查通过（用时<30秒）"

package/xiaoma-core/tasks/batch-story-generation.md

@@ -0,0 +1,354 @@
+# 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
+```