aico-cli 0.3.12 → 0.3.13

package/templates/hooks/requirement/post-task-executor.sh

@@ -0,0 +1,78 @@
+#!/usr/bin/env bash
+# 任务执行阶段后置 Hook
+
+# 加载通用工具库
+source "$(dirname "${BASH_SOURCE[0]}")/common-utils.sh"
+
+# 主函数
+main() {
+    local task_list_path="$1"
+    local completion_report_path="$2"
+
+    hook_log "INFO" "开始执行任务执行后置处理"
+
+    # 初始化环境
+    init_hook_environment
+
+    # 检查完成报告文档是否存在
+    if [ ! -f "$completion_report_path" ]; then
+        hook_log "ERROR" "完成报告文档不存在: $completion_report_path"
+        return 1
+    fi
+
+    # 分析执行结果
+    local doc_dir=$(dirname "$task_list_path")
+    local req_name=$(basename "$doc_dir")
+
+    # 统计成功/失败任务数
+    local success_count=$(grep -c "✅\|成功" "$completion_report_path" 2>/dev/null || echo "0")
+    local failed_count=$(grep -c "❌\|失败" "$completion_report_path" 2>/dev/null || echo "0")
+    local total_count=$((success_count + failed_count))
+
+    # 更新执行状态
+    if [ "$failed_count" -eq 0 ]; then
+        echo "全部完成" > "$doc_dir/执行状态"
+        hook_log "INFO" "所有任务执行成功"
+    else
+        echo "部分完成" > "$doc_dir/执行状态"
+        hook_log "WARN" "有 $failed_count 个任务执行失败"
+    fi
+
+    # 记录处理完成时间
+    local completion_time=$(get_timestamp)
+    echo "$completion_time" > "$doc_dir/执行完成时间"
+
+    # 生成执行摘要
+    cat > "$doc_dir/执行摘要.txt" << EOF
+任务执行完成摘要
+================
+需求名称: $req_name
+完成时间: $completion_time
+完成报告: $completion_report_path
+总任务数: $total_count
+成功任务: $success_count
+失败任务: $failed_count
+执行状态: $(if [ "$failed_count" -eq 0 ]; then echo "全部完成"; else echo "部分完成"; fi)
+
+执行统计:
+- ✅ 成功: $success_count
+- ❌ 失败: $failed_count
+- ⏳ 总计: $total_count
+
+处理步骤:
+1. ✅ 任务执行完成
+2. ✅ 结果统计汇总
+3. ✅ 执行报告生成
+4. 🔄 等待质量验证
+EOF
+
+    hook_log "INFO" "任务执行后置处理完成，成功: $success_count, 失败: $failed_count"
+
+    # 更新 hook 状态
+    update_hook_status "task-executor" "success"
+
+    return 0
+}
+
+# 执行主函数
+main "$@"

package/templates/hooks/requirement/post-task-splitter-validator.sh

@@ -0,0 +1,73 @@
+#!/usr/bin/env bash
+# 任务拆分阶段后置 Hook
+
+# 加载通用工具库
+source "$(dirname "${BASH_SOURCE[0]}")/common-utils.sh"
+
+# 主函数
+main() {
+    local technical_doc_path="$1"
+    local task_list_path="$2"
+
+    hook_log "INFO" "开始执行任务拆分后置处理"
+
+    # 初始化环境
+    init_hook_environment
+
+    # 检查任务清单文档是否存在
+    if [ ! -f "$task_list_path" ]; then
+        hook_log "ERROR" "任务清单文档不存在: $task_list_path"
+        return 1
+    fi
+
+    # 分析任务清单
+    local task_count=$(grep -c "^-\|^\d\+\." "$task_list_path" 2>/dev/null || echo "0")
+    local estimated_time=""
+
+    if [ "$task_count" -gt 0 ]; then
+        # 简单估算：每个任务约2-4小时
+        local total_hours=$((task_count * 3))
+        estimated_time="约 ${total_hours} 小时"
+    else
+        estimated_time="待评估"
+    fi
+
+    # 更新需求状态
+    local doc_dir=$(dirname "$technical_doc_path")
+    local req_name=$(basename "$doc_dir")
+
+    echo "待确认" > "$doc_dir/拆分状态"
+    hook_log "INFO" "任务拆分状态已设置为: 待确认"
+
+    # 记录处理完成时间
+    local completion_time=$(get_timestamp)
+    echo "$completion_time" > "$doc_dir/拆分完成时间"
+
+    # 生成任务拆分摘要
+    cat > "$doc_dir/拆分摘要.txt" << EOF
+任务拆分完成摘要
+================
+需求名称: $req_name
+拆分时间: $completion_time
+任务清单: $task_list_path
+任务数量: $task_count
+预估时间: $estimated_time
+状态: 待确认
+
+处理步骤:
+1. ✅ 任务分解完成
+2. ✅ 优先级排序
+3. ✅ 依赖关系分析
+4. ⏳ 等待用户确认
+EOF
+
+    hook_log "INFO" "任务拆分后置处理完成，共识别 $task_count 个任务"
+
+    # 更新 hook 状态
+    update_hook_status "task-splitter-validator" "success"
+
+    return 0
+}
+
+# 执行主函数
+main "$@"

package/templates/hooks/requirement/pre-requirement-aligner.sh

@@ -0,0 +1,70 @@
+#!/usr/bin/env bash
+# 需求对齐阶段前置 Hook
+
+# 加载通用工具库
+source "$(dirname "${BASH_SOURCE[0]}")/common-utils.sh"
+
+# 主函数
+main() {
+    local consensus_doc_path="$1"
+
+    hook_log "INFO" "开始执行需求对齐前置检查"
+
+    # 初始化环境
+    init_hook_environment
+
+    # 检查前置条件
+    if ! check_hook_prerequisites "requirement-aligner"; then
+        return 1
+    fi
+
+    # 检查依赖
+    if ! check_dependencies "requirement-aligner"; then
+        return 1
+    fi
+
+    # 验证共识文档
+    if [ ! -f "$consensus_doc_path" ]; then
+        hook_log "ERROR" "共识文档不存在: $consensus_doc_path"
+        return 1
+    fi
+
+    # 检查需求状态是否为"已确认"
+    local doc_dir=$(dirname "$consensus_doc_path")
+    if ! validate_requirement_status "$(basename "$doc_dir")" "已确认"; then
+        hook_log "ERROR" "需求状态不是'已确认'，无法进行技术对齐"
+        return 1
+    fi
+
+    # 检查项目代码库
+    if [ ! -d "src" ] && [ ! -d "lib" ]; then
+        hook_log "WARN" "未找到标准代码目录(src/lib)，可能影响技术分析准确性"
+    fi
+
+    # 检查技术栈配置文件
+    local tech_stack=""
+    if [ -f "package.json" ]; then
+        tech_stack="Node.js"
+    elif [ -f "requirements.txt" ]; then
+        tech_stack="Python"
+    elif [ -f "pom.xml" ]; then
+        tech_stack="Java"
+    else
+        hook_log "WARN" "未识别到明确的技术栈配置文件"
+    fi
+
+    hook_log "INFO" "检测到技术栈: ${tech_stack:-未知}"
+
+    # 保存技术分析上下文
+    cat > "$AICO_HOOKS_TEMP_DIR/tech-context.txt" << EOF
+技术栈: $tech_stack
+代码目录: $(if [ -d "src" ]; then echo "src"; elif [ -d "lib" ]; then echo "lib"; else echo "无"; fi)
+配置文件: $(if [ -f "package.json" ]; then echo "package.json"; elif [ -f "requirements.txt" ]; then echo "requirements.txt"; elif [ -f "pom.xml" ]; then echo "pom.xml"; else echo "无"; fi)
+EOF
+
+    hook_log "INFO" "需求对齐前置检查完成"
+    return 0
+}
+
+# 执行主函数
+main "$@"

package/templates/hooks/requirement/pre-requirement-identifier.sh

@@ -0,0 +1,61 @@
+#!/usr/bin/env bash
+# 需求识别阶段前置 Hook
+
+# 加载通用工具库
+source "$(dirname "${BASH_SOURCE[0]}")/common-utils.sh"
+
+# 主函数
+main() {
+    local requirement_desc="$1"
+
+    hook_log "INFO" "开始执行需求识别前置检查"
+
+    # 初始化环境
+    init_hook_environment
+
+    # 检查前置条件
+    if ! check_hook_prerequisites "requirement-identifier"; then
+        return 1
+    fi
+
+    # 检查依赖
+    if ! check_dependencies "requirement-identifier"; then
+        return 1
+    fi
+
+    # 验证输入参数
+    if [ -z "$requirement_desc" ]; then
+        hook_log "ERROR" "需求描述不能为空"
+        return 1
+    fi
+
+    # 检查项目环境
+    if [ ! -f "CLAUDE.md" ]; then
+        hook_log "WARN" "未找到 CLAUDE.md 文件，可能影响需求分析准确性"
+    fi
+
+    # 创建需求文档目录
+    local req_name=$(echo "$requirement_desc" | head -c 20 | tr ' ' '_' | tr -cd '[:alnum:]_-')
+    local doc_dir=".aico/docs/$req_name"
+
+    if [ -d "$doc_dir" ]; then
+        hook_log "INFO" "需求目录已存在: $doc_dir"
+
+        # 检查是否已有共识文档
+        if [ -f "$doc_dir/共识文档.md" ]; then
+            hook_log "INFO" "发现现有共识文档，将进行更新"
+        fi
+    else
+        safe_mkdir "$doc_dir"
+        hook_log "INFO" "创建需求文档目录: $doc_dir"
+    fi
+
+    # 保存需求描述到临时文件
+    echo "$requirement_desc" > "$AICO_HOOKS_TEMP_DIR/requirement-desc.txt"
+
+    hook_log "INFO" "需求识别前置检查完成"
+    return 0
+}
+
+# 执行主函数
+main "$@"

package/templates/hooks/requirement/pre-task-executor-validator.sh

@@ -0,0 +1,81 @@
+#!/usr/bin/env bash
+# 质量验证阶段前置 Hook
+
+# 加载通用工具库
+source "$(dirname "${BASH_SOURCE[0]}")/common-utils.sh"
+
+# 主函数
+main() {
+    local completion_report_path="$1"
+
+    hook_log "INFO" "开始执行质量验证前置检查"
+
+    # 初始化环境
+    init_hook_environment
+
+    # 检查前置条件
+    if ! check_hook_prerequisites "task-executor-validator"; then
+        return 1
+    fi
+
+    # 检查依赖
+    if ! check_dependencies "task-executor-validator"; then
+        return 1
+    fi
+
+    # 验证完成报告文档
+    if [ ! -f "$completion_report_path" ]; then
+        hook_log "ERROR" "完成报告文档不存在: $completion_report_path"
+        return 1
+    fi
+
+    # 检查执行状态
+    local doc_dir=$(dirname "$completion_report_path")
+    local req_name=$(basename "$doc_dir")
+
+    if [ ! -f "$doc_dir/执行状态" ]; then
+        hook_log "ERROR" "执行状态文件不存在"
+        return 1
+    fi
+
+    local execution_status=$(cat "$doc_dir/执行状态")
+
+    # 分析执行结果
+    local success_count=$(grep -c "✅\|成功" "$completion_report_path" 2>/dev/null || echo "0")
+    local failed_count=$(grep -c "❌\|失败" "$completion_report_path" 2>/dev/null || echo "0")
+    local total_count=$((success_count + failed_count))
+
+    # 准备验证上下文
+    cat > "$AICO_HOOKS_TEMP_DIR/validation-context.txt" << EOF
+完成报告路径: $completion_report_path
+执行状态: $execution_status
+成功任务: $success_count
+失败任务: $failed_count
+总任务数: $total_count
+需求名称: $req_name
+EOF
+
+    # 检查测试环境
+    local test_env=""
+    if [ -d "test" ] || [ -d "tests" ] || [ -d "src/__tests__" ]; then
+        test_env="已配置"
+        # 检查测试框架
+        if [ -f "package.json" ] && grep -q "jest\|mocha\|vitest" "package.json"; then
+            test_env="JavaScript测试框架"
+        elif [ -f "requirements.txt" ] && grep -q "pytest\|unittest" "requirements.txt"; then
+            test_env="Python测试框架"
+        elif [ -f "pom.xml" ] && grep -q "junit\|testng" "pom.xml"; then
+            test_env="Java测试框架"
+        fi
+    else
+        test_env="未配置"
+    fi
+
+    hook_log "INFO" "测试环境: $test_env"
+    hook_log "INFO" "质量验证前置检查完成，将验证 $total_count 个任务的执行质量"
+
+    return 0
+}
+
+# 执行主函数
+main "$@"

package/templates/hooks/requirement/pre-task-executor.sh

@@ -0,0 +1,91 @@
+#!/usr/bin/env bash
+# 任务执行阶段前置 Hook
+
+# 加载通用工具库
+source "$(dirname "${BASH_SOURCE[0]}")/common-utils.sh"
+
+# 主函数
+main() {
+    local task_list_path="$1"
+
+    hook_log "INFO" "开始执行任务执行前置检查"
+
+    # 初始化环境
+    init_hook_environment
+
+    # 检查前置条件
+    if ! check_hook_prerequisites "task-executor"; then
+        return 1
+    fi
+
+    # 检查依赖
+    if ! check_dependencies "task-executor"; then
+        return 1
+    fi
+
+    # 验证任务清单文档
+    if [ ! -f "$task_list_path" ]; then
+        hook_log "ERROR" "任务清单文档不存在: $task_list_path"
+        return 1
+    fi
+
+    # 检查任务拆分状态是否为"已确认"
+    local doc_dir=$(dirname "$task_list_path")
+    local req_name=$(basename "$doc_dir")
+
+    if [ ! -f "$doc_dir/拆分状态" ] || [ "$(cat "$doc_dir/拆分状态")" != "已确认" ]; then
+        hook_log "ERROR" "任务拆分状态不是'已确认'，无法开始执行"
+        return 1
+    fi
+
+    # 分析任务清单
+    local task_count=$(grep -c "^-\|^\d\+\." "$task_list_path" 2>/dev/null || echo "0")
+
+    if [ "$task_count" -eq 0 ]; then
+        hook_log "WARN" "任务清单为空或格式不正确"
+    fi
+
+    # 检查执行环境
+    local execution_env=""
+    if [ -f "package.json" ]; then
+        execution_env="Node.js"
+        # 检查 npm/pnpm/yarn 可用性
+        if command_exists "npm"; then
+            execution_env="$execution_env (npm)"
+        elif command_exists "pnpm"; then
+            execution_env="$execution_env (pnpm)"
+        elif command_exists "yarn"; then
+            execution_env="$execution_env (yarn)"
+        fi
+    elif [ -f "requirements.txt" ]; then
+        execution_env="Python"
+        if command_exists "pip"; then
+            execution_env="$execution_env (pip)"
+        fi
+    elif [ -f "pom.xml" ]; then
+        execution_env="Java"
+        if command_exists "mvn"; then
+            execution_env="$execution_env (Maven)"
+        fi
+    else
+        execution_env="Shell/通用"
+    fi
+
+    # 保存执行上下文
+    cat > "$AICO_HOOKS_TEMP_DIR/execution-context.txt" << EOF
+任务清单路径: $task_list_path
+任务数量: $task_count
+执行环境: $execution_env
+需求名称: $req_name
+开始时间: $(get_timestamp)
+EOF
+
+    # 创建执行日志目录
+    safe_mkdir "$doc_dir/执行日志"
+
+    hook_log "INFO" "任务执行前置检查完成，将在 $execution_env 环境中执行 $task_count 个任务"
+    return 0
+}
+
+# 执行主函数
+main "$@"

package/templates/hooks/requirement/pre-task-splitter-validator.sh

@@ -0,0 +1,61 @@
+#!/usr/bin/env bash
+# 任务拆分阶段前置 Hook
+
+# 加载通用工具库
+source "$(dirname "${BASH_SOURCE[0]}")/common-utils.sh"
+
+# 主函数
+main() {
+    local technical_doc_path="$1"
+
+    hook_log "INFO" "开始执行任务拆分前置检查"
+
+    # 初始化环境
+    init_hook_environment
+
+    # 检查前置条件
+    if ! check_hook_prerequisites "task-splitter-validator"; then
+        return 1
+    fi
+
+    # 检查依赖
+    if ! check_dependencies "task-splitter-validator"; then
+        return 1
+    fi
+
+    # 验证技术方案文档
+    if [ ! -f "$technical_doc_path" ]; then
+        hook_log "ERROR" "技术方案文档不存在: $technical_doc_path"
+        return 1
+    fi
+
+    # 检查技术方案状态是否为"已确认"
+    local doc_dir=$(dirname "$technical_doc_path")
+    local req_name=$(basename "$doc_dir")
+
+    if [ ! -f "$doc_dir/对齐状态" ] || [ "$(cat "$doc_dir/对齐状态")" != "已确认" ]; then
+        hook_log "ERROR" "技术方案状态不是'已确认'，无法进行任务拆分"
+        return 1
+    fi
+
+    # 分析任务复杂度
+    local tech_content=$(safe_read_file "$technical_doc_path" 100)
+    local task_count=$(echo "$tech_content" | grep -c "###\|##\|-" || echo "0")
+
+    if [ "$task_count" -lt 3 ]; then
+        hook_log "WARN" "技术方案内容较少，可能需要更详细的任务分解"
+    fi
+
+    # 保存任务分析上下文
+    cat > "$AICO_HOOKS_TEMP_DIR/task-analysis.txt" << EOF
+技术方案路径: $technical_doc_path
+预估任务数量: $task_count
+需求名称: $req_name
+EOF
+
+    hook_log "INFO" "任务拆分前置检查完成，预估任务数: $task_count"
+    return 0
+}
+
+# 执行主函数
+main "$@"

package/templates/hooks/requirement-processor.sh

@@ -0,0 +1,180 @@
+#!/usr/bin/env bash
+# 需求处理器 - 集成原有脚本逻辑与 Hook 机制
+
+# 加载 Hook 工具库
+source "$(dirname "${BASH_SOURCE[0]}")/requirement/common-utils.sh"
+
+# 加载原有的需求分析函数库
+ORIGINAL_FUNCTIONS="$(dirname "${BASH_SOURCE[0]}")/../agents/aico/requirement/requirement-functions-crossplatform.sh"
+if [ -f "$ORIGINAL_FUNCTIONS" ]; then
+    source "$ORIGINAL_FUNCTIONS"
+fi
+
+# 大行完整需求处理流程
+execute_requirement_lifecycle() {
+    local user_input="$1"
+
+    hook_log "INFO" "开始需求生命周期处理: $user_input"
+    init_hook_environment
+
+    # 阶段1: 需求识别
+    hook_log "INFO" "=== 🎯 需求识别阶段 ==="
+
+    # 调用前置 Hook
+    if ! execute_hook "pre" "requirement-identifier" "$user_input"; then
+        hook_log "ERROR" "需求识别前置处理失败"
+        return 1
+    fi
+
+    # 执行核心需求分析逻辑
+    if command -v main_workflow >/dev/null 2>&1; then
+        main_workflow "$user_input"
+    else
+        # 如果没有原函数，使用简化逻辑
+        detect_platform
+        analyze_requirement "$user_input"
+    fi
+
+    # 生成共识文档路径
+    local req_name=$(echo "$user_input" | head -c 20 | tr ' ' '_' | tr -cd '[:alnum:]_-')
+    local doc_dir=".aico/docs/$req_name"
+    local consensus_doc="$doc_dir/共识文档.md"
+
+    # 创建共识文档
+    if ! [ -f "$consensus_doc" ]; then
+        mkdir -p "$doc_dir"
+        cat > "$consensus_doc" << EOF
+# 需求共识文档 - $req_name
+
+**状态**: 待确认
+**创建时间**: $(get_timestamp)
+**原始需求**: $user_input
+
+## 🎯 需求理解
+基于您的描述，我理解您需要：
+$(echo "$user_input")
+
+## 📋 工程分析
+- **意图类型**: ${INTENT_TYPE:-自动识别}
+- **项目类型**: $(if [ -d "src" ] || [ -d "lib" ]; then echo "现有项目"; else echo "新项目"; fi)
+
+## ✨ 下一步
+请确认此需求理解是否准确，确认后我将继续进行技术方案设计。
+EOF
+    fi
+
+    # 调用后置 Hook
+    if ! execute_hook "post" "requirement-identifier" "$user_input" "$consensus_doc"; then
+        hook_log "ERROR" "需求识别后置处理失败"
+        return 1
+    fi
+
+    hook_log "INFO" "需求识别阶段完成，等待用户确认..."
+    return 0
+}
+
+# 需求对齐阶段
+execute_requirement_alignment() {
+    local consensus_doc="$1"
+
+    hook_log "INFO" "=== 🔄 需求对齐阶段 ==="
+
+    # 调用前置 Hook
+    if ! execute_hook "pre" "requirement-aligner" "$consensus_doc"; then
+        return 1
+    fi
+
+    # 生成技术方案
+    local doc_dir=$(dirname "$consensus_doc")
+    local tech_doc="$doc_dir/技术对齐方案文档.md"
+
+    if ! [ -f "$tech_doc" ]; then
+        cat > "$tech_doc" << EOF
+# 技术对齐方案文档
+
+**状态**: 待确认
+**创建时间**: $(get_timestamp)
+**基于共识**: $consensus_doc
+
+## 🔧 技术实现方案
+
+### 架构设计
+- 采用**模块化设计**，保持与现有架构的一致性
+- 遵循**SOLID原则**，确保代码的可维护性
+
+### 实施步骤
+1. **需求确认** ✅
+2. **技术实现** 🔄
+3. **测试验证** ⏳
+4. **部署上线** ⏳
+
+### 风险评估
+- **技术风险**: 低 - 基于成熟技术栈
+- **时间风险**: 中 - 需要充分测试
+- **资源风险**: 低 - 利用现有资源
+
+请确认此技术方案是否可行，确认后我将进行任务分解。
+EOF
+    fi
+
+    # 调用后置 Hook
+    if ! execute_hook "post" "requirement-aligner" "$consensus_doc" "$tech_doc"; then
+        return 1
+    fi
+
+    hook_log "INFO" "需求对齐阶段完成"
+    return 0
+}
+
+# 显示使用帮助
+show_usage() {
+    cat << EOF
+
+🚀 AICO 需求生命周期处理器
+
+使用方法:
+  $0 "用户需求描述"                    # 完整生命周期处理
+  $0 --align "共识文档路径"             # 仅执行需求对齐阶段
+  $0 --help                           # 显示帮助信息
+
+示例:
+  $0 "需要开发一个用户登录功能"
+  $0 --align ".aico/docs/user_login/共识文档.md"
+
+功能特性:
+  ✅ 自动 Hook 触发
+  ✅ 状态自动管理
+  ✅ 错误处理和重试
+  ✅ 跨平台兼容
+
+EOF
+}
+
+# 主函数
+main() {
+    case "$1" in
+        --help|-h)
+            show_usage
+            exit 0
+            ;;
+        --align)
+            if [ -z "$2" ]; then
+                hook_log "ERROR" "请提供共识文档路径"
+                exit 1
+            fi
+            execute_requirement_alignment "$2"
+            ;;
+        "")
+            hook_log "ERROR" "请提供需求描述或使用 --help 查看帮助"
+            exit 1
+            ;;
+        *)
+            execute_requirement_lifecycle "$*"
+            ;;
+    esac
+}
+
+# 执行主函数
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+    main "$@"
+fi