aico-cli 0.3.12 → 0.3.13

package/dist/chunks/simple-config.mjs

@@ -13,7 +13,7 @@ import { join as join$1 } from 'node:path';
 import { join, dirname, basename } from 'pathe';
 import { fileURLToPath } from 'node:url';
 
-const version = "0.3.12";
+const version = "0.3.13";
 
 function displayBanner(subtitle) {
   const defaultSubtitle = "\u4E00\u952E\u914D\u7F6E\u4F60\u7684\u5F00\u53D1\u73AF\u5883";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aico-cli",
-  "version": "0.3.12",
+  "version": "0.3.13",
   "packageManager": "pnpm@9.15.9",
   "description": "AI CLI",
   "repository": {

package/templates/hooks/README.md

@@ -0,0 +1,198 @@
+# AICO 需求管理 Hook 系统
+
+## 📋 概述
+
+将原有的需求管理脚本重构为基于 Hook 触发的模块化系统，支持需求生命周期的全流程自动化处理。
+
+## 🏗️ 架构设计
+
+```
+templates/hooks/
+├── hooks-config.json             # Hook 配置中心
+├── requirement-processor.sh      # 🔧 主要使用脚本
+├── requirement/                  # Hook 机制
+│   ├── common-utils.sh           # 核心工具库
+│   ├── pre-requirement-identifier.sh
+│   ├── post-requirement-identifier.sh
+│   ├── pre-requirement-aligner.sh
+│   ├── post-requirement-aligner.sh
+│   ├── pre-task-splitter-validator.sh
+│   ├── post-task-splitter-validator.sh
+│   ├── pre-task-executor.sh
+│   ├── post-task-executor.sh
+│   ├── pre-task-executor-validator.sh
+│   └── post-task-executor-validator.sh
+└── ../agents/aico/requirement/   # 🎯 原有核心逻辑
+    ├── crossplatform-utils.sh            # 跨平台工具库
+    └── requirement-functions-crossplatform.sh  # 需求分析算法
+```
+
+## 🚀 使用方法
+
+### 1. 基本需求处理（推荐）
+
+```bash
+# 处理完整需求生命周期
+./templates/hooks/requirement-processor.sh "需要开发一个用户登录功能"
+
+# 查看帮助
+./templates/hooks/requirement-processor.sh --help
+```
+
+### 2. 单独调用 Hook（高级用法）
+
+```bash
+# 需求识别前置处理
+./templates/hooks/requirement/pre-requirement-identifier.sh "需求描述"
+
+# 需求识别后置处理
+./templates/hooks/requirement/post-requirement-identifier.sh "需求描述" "共识文档路径"
+```
+
+### 3. 手动调用原有脚本（兼容性）
+
+原有的核心逻辑仍然保留，可以通过以下方式使用：
+
+```bash
+# 使用原有的跨平台工具库
+source templates/agents/aico/requirement/crossplatform-utils.sh
+
+# 使用原有的需求分析函数
+source templates/agents/aico/requirement/requirement-functions-crossplatform.sh
+```
+
+## 📊 脚本用途说明
+
+### ✅ 有用的脚本（保留）
+
+| 脚本 | 用途 | 是否核心 |
+|------|------|----------|
+| `requirement-processor.sh` | 🎯 **主要使用脚本**，整合所有功能 | ✅ 是 |
+| `common-utils.sh` | Hook 框架核心，日志、状态管理 | ✅ 是 |
+| 10个 `pre/post` hook 脚本 | 生命周期各阶段的前后置处理 | ✅ 是 |
+| `crossplatform-utils.sh` | 跨平台兼容性工具库 | ✅ 是 |
+| `requirement-functions-crossplatform.sh` | 需求分析核心算法 | ✅ 是 |
+| `hooks-config.json` | Hook 配置管理 | ✅ 是 |
+
+### ❌ 已删除的脚本（冗余）
+
+| 原因 | 删除的脚本 |
+|------|------------|
+| 仅用于开发调试 | 所有 `test-*.sh` 脚本 |
+| 被 Hook 机制替代 | `requirement-launcher.sh` |
+
+## 🔄 工作流程
+
+### 完整生命周期流程
+
+1. **需求识别阶段** (`requirement-identifier`)
+   - 前置 Hook: 环境检查、参数验证
+   - 核心逻辑: 需求分析、意图识别
+   - 后置 Hook: 状态更新、摘要生成
+
+2. **需求对齐阶段** (`requirement-aligner`)
+   - 前置 Hook: 技术栈分析、依赖检查
+   - 核心逻辑: 技术方案设计
+   - 后置 Hook: 对齐状态更新
+
+3. **任务拆分阶段** (`task-splitter-validator`)
+   - 前置 Hook: 任务复杂度分析
+   - 核心逻辑: 任务分解、优先级排序
+   - 后置 Hook: 拆分摘要生成
+
+4. **任务执行阶段** (`task-executor`)
+   - 前置 Hook: 执行环境检查
+   - 核心逻辑: 代码实现、单元测试
+   - 后置 Hook: 执行统计汇总
+
+5. **质量验证阶段** (`task-executor-validator`)
+   - 前置 Hook: 验证环境准备
+   - 核心逻辑: 质量检查、集成测试
+   - 后置 Hook: 验证报告生成
+
+## 🎯 最佳实践
+
+### 推荐使用方式
+
+```bash
+# 日常使用 - 一步到位
+./templates/hooks/requirement-processor.sh "功能需求描述"
+
+# 开发调试 - 分步执行
+./templates/hooks/requirement/pre-requirement-identifier.sh "需求"
+# ... 检查前置处理结果 ...
+./templates/hooks/requirement/post-requirement-identifier.sh "需求" "文档"
+
+# 自定义流程 - 组合使用
+source templates/hooks/requirement/common-utils.sh
+execute_hook "pre" "requirement-identifier" "自定义参数"
+```
+
+## 🛠️ 配置管理
+
+编辑 `hooks-config.json` 可以：
+
+- 启用/禁用特定 Hook
+- 设置超时时间
+- 配置依赖关系
+- 调整重试策略
+
+```json
+{
+  "hooks": {
+    "requirement-identifier": {
+      "enabled": true,
+      "timeout": 30000,
+      "dependencies": []
+    }
+  }
+}
+```
+
+## 🔧 扩展开发
+
+### 添加新的 Hook
+
+1. 在对应目录创建 `pre-stage-name.sh` 和 `post-stage-name.sh`
+2. 在 `hooks-config.json` 中添加配置
+3. 更新 `requirement-processor.sh` 中的流程调用
+
+### 自定义处理逻辑
+
+原有脚本的核心逻辑函数可以在 Hook 中直接调用：
+
+```bash
+source ../agents/aico/requirement/requirement-functions-crossplatform.sh
+
+# 在 Hook 中调用原有函数
+analyze_requirement "$user_input"
+generate_consensus_document
+```
+
+## ⚠️ 注意事项
+
+1. **依赖关系**: Hook 严格按照依赖顺序执行
+2. **状态管理**: 每个 Hook 会更新对应的状态文件
+3. **错误处理**: Hook 失败会中断整个流程
+4. **跨平台**: 保持与原有脚本的跨平台兼容性
+
+## 📚 迁移指南
+
+如果你之前使用 `requirement-launcher.sh`，现在可以这样迁移：
+
+### 旧方式
+```bash
+./templates/agents/aico/requirement/requirement-launcher.sh "需求描述"
+```
+
+### 新方式（推荐）
+```bash
+./templates/hooks/requirement-processor.sh "需求描述"
+```
+
+新方式的优势：
+- ✅ 自动 Hook 触发
+- ✅ 更好的状态管理
+- ✅ 更强的错误处理
+- ✅ 模块化架构
+- ✅ 易于扩展

package/templates/hooks/hooks-config.json

@@ -0,0 +1,47 @@
+{
+  "version": "1.0.0",
+  "description": "需求管理生命周期 Hook 配置",
+  "hooks": {
+    "requirement-identifier": {
+      "pre": "requirement/pre-requirement-identifier.sh",
+      "post": "requirement/post-requirement-identifier.sh",
+      "dependencies": [],
+      "timeout": 30000,
+      "enabled": true
+    },
+    "requirement-aligner": {
+      "pre": "requirement/pre-requirement-aligner.sh",
+      "post": "requirement/post-requirement-aligner.sh",
+      "dependencies": ["requirement-identifier"],
+      "timeout": 30000,
+      "enabled": true
+    },
+    "task-splitter-validator": {
+      "pre": "requirement/pre-task-splitter-validator.sh",
+      "post": "requirement/post-task-splitter-validator.sh",
+      "dependencies": ["requirement-aligner"],
+      "timeout": 30000,
+      "enabled": true
+    },
+    "task-executor": {
+      "pre": "requirement/pre-task-executor.sh",
+      "post": "requirement/post-task-executor.sh",
+      "dependencies": ["task-splitter-validator"],
+      "timeout": 60000,
+      "enabled": true
+    },
+    "task-executor-validator": {
+      "pre": "requirement/pre-task-executor-validator.sh",
+      "post": "requirement/post-task-executor-validator.sh",
+      "dependencies": ["task-executor"],
+      "timeout": 30000,
+      "enabled": true
+    }
+  },
+  "global": {
+    "maxRetries": 3,
+    "retryDelay": 1000,
+    "logLevel": "info",
+    "tempDir": "/tmp/aico-hooks"
+  }
+}

package/templates/hooks/requirement/common-utils.sh

@@ -0,0 +1,186 @@
+#!/usr/bin/env bash
+# 需求管理 Hook 通用工具库
+
+# 加载跨平台基础工具
+# 计算相对路径
+HOOKS_DIR="$(dirname "$(dirname "${BASH_SOURCE[0]}")")"
+CROSSPLATFORM_UTILS="$HOOKS_DIR/../agents/aico/requirement/crossplatform-utils.sh"
+
+if [ -f "$CROSSPLATFORM_UTILS" ]; then
+    source "$CROSSPLATFORM_UTILS"
+else
+    echo "⚠️  跨平台工具库未找到: $CROSSPLATFORM_UTILS"
+    # 提供基本的兼容函数
+    get_timestamp() { date '+%Y-%m-%d %H:%M:%S'; }
+    safe_mkdir() { mkdir -p "$1"; }
+    safe_rmdir() { rm -rf "$1" 2>/dev/null || true; }
+    get_temp_dir() { echo "/tmp"; }
+fi
+
+# Hook 日志函数
+hook_log() {
+    local level="$1"
+    local message="$2"
+    local timestamp=$(get_timestamp)
+
+    case "$level" in
+        "INFO") echo "[INFO] $timestamp - $message" ;;
+        "WARN") echo "[WARN] $timestamp - $message" >&2 ;;
+        "ERROR") echo "[ERROR] $timestamp - $message" >&2 ;;
+        "DEBUG") echo "[DEBUG] $timestamp - $message" ;;
+        *) echo "[$level] $timestamp - $message" ;;
+    esac
+}
+
+# 检查 Hook 前置条件
+check_hook_prerequisites() {
+    local hook_name="$1"
+    local config_file="$HOOKS_DIR/hooks-config.json"
+
+    if [ ! -f "$config_file" ]; then
+        hook_log "WARN" "Hook 配置文件不存在: $config_file，跳过配置检查"
+        return 0
+    fi
+
+    # 检查 Hook 是否启用
+    if command -v jq >/dev/null 2>&1; then
+        local enabled=$(jq -r ".hooks.\"$hook_name\".enabled" "$config_file" 2>/dev/null)
+        if [ "$enabled" != "true" ]; then
+            hook_log "WARN" "Hook $hook_name 未启用，跳过执行"
+            return 2
+        fi
+    else
+        hook_log "DEBUG" "jq 命令不可用，跳过配置检查"
+    fi
+
+    return 0
+}
+
+# 执行 Hook 脚本
+execute_hook() {
+    local hook_type="$1"  # pre 或 post
+    local hook_name="$2"  # hook 名称
+    local hook_args="${@:3}"  # 额外参数
+
+    local config_file="$HOOKS_DIR/hooks-config.json"
+    local hook_script=""
+
+    if [ -f "$config_file" ] && command -v jq >/dev/null 2>&1; then
+        hook_script=$(jq -r ".hooks.\"$hook_name\".\"$hook_type\"" "$config_file" 2>/dev/null)
+    fi
+
+    # 如果没有配置文件或 jq 不可用，使用默认路径
+    if [ -z "$hook_script" ] || [ "$hook_script" = "null" ]; then
+        hook_script="requirement/$hook_type-$hook_name.sh"
+        hook_log "DEBUG" "使用默认 Hook 路径: $hook_script"
+    fi
+
+    local full_script_path="$HOOKS_DIR/$hook_script"
+
+    if [ ! -f "$full_script_path" ]; then
+        hook_log "ERROR" "Hook 脚本不存在: $full_script_path"
+        return 1
+    fi
+
+    if [ ! -x "$full_script_path" ]; then
+        set_executable "$full_script_path"
+    fi
+
+    hook_log "INFO" "执行 $hook_type hook: $hook_name"
+
+    # 执行 hook 脚本
+    if "$full_script_path" $hook_args; then
+        hook_log "INFO" "Hook $hook_name $hook_type 执行成功"
+        return 0
+    else
+        hook_log "ERROR" "Hook $hook_name $hook_type 执行失败"
+        return 1
+    fi
+}
+
+# 检查依赖关系
+check_dependencies() {
+    local hook_name="$1"
+    local config_file="$(dirname "${BASH_SOURCE[0]}")/../../hooks-config.json"
+
+    local dependencies=$(jq -r ".hooks.\"$hook_name\".dependencies[]" "$config_file" 2>/dev/null)
+
+    for dep in $dependencies; do
+        if [ -n "$dep" ] && [ "$dep" != "null" ]; then
+            # 检查依赖的 hook 是否已成功执行
+            local dep_status_file="$(get_temp_dir)/aico-hooks/$dep.status"
+            if [ ! -f "$dep_status_file" ] || [ "$(cat "$dep_status_file")" != "success" ]; then
+                hook_log "ERROR" "依赖的 hook $dep 未成功执行"
+                return 1
+            fi
+        fi
+    done
+
+    return 0
+}
+
+# 更新 Hook 状态
+update_hook_status() {
+    local hook_name="$1"
+    local status="$2"  # success 或 failed
+
+    local status_dir="$(get_temp_dir)/aico-hooks"
+    safe_mkdir "$status_dir"
+
+    echo "$status" > "$status_dir/$hook_name.status"
+}
+
+# 获取 Hook 状态
+get_hook_status() {
+    local hook_name="$1"
+    local status_file="$(get_temp_dir)/aico-hooks/$hook_name.status"
+
+    if [ -f "$status_file" ]; then
+        cat "$status_file"
+    else
+        echo "unknown"
+    fi
+}
+
+# 清理临时状态
+cleanup_hook_status() {
+    local hook_name="$1"
+    local status_dir="$(get_temp_dir)/aico-hooks"
+
+    safe_rm "$status_dir/$hook_name.status"
+}
+
+# 验证需求文档状态
+validate_requirement_status() {
+    local requirement_name="$1"
+    local expected_status="$2"  # 如 "已确认"
+
+    local doc_dir=".aico/docs/$requirement_name"
+    local status_file="$doc_dir/状态"
+
+    if [ ! -f "$status_file" ]; then
+        hook_log "ERROR" "需求状态文件不存在: $status_file"
+        return 1
+    fi
+
+    local current_status=$(cat "$status_file")
+    if [ "$current_status" != "$expected_status" ]; then
+        hook_log "ERROR" "需求状态不匹配。期望: $expected_status, 实际: $current_status"
+        return 1
+    fi
+
+    return 0
+}
+
+# 初始化 Hook 环境
+init_hook_environment() {
+    export AICO_HOOKS_DIR="$(dirname "${BASH_SOURCE[0]}")/../.."
+    export AICO_HOOKS_TEMP_DIR="$(get_temp_dir)/aico-hooks"
+
+    safe_mkdir "$AICO_HOOKS_TEMP_DIR"
+
+    # 设置日志级别
+    if [ -z "$AICO_HOOKS_LOG_LEVEL" ]; then
+        export AICO_HOOKS_LOG_LEVEL="info"
+    fi
+}

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

@@ -0,0 +1,61 @@
+#!/usr/bin/env bash
+# 需求对齐阶段后置 Hook
+
+# 加载通用工具库
+source "$(dirname "${BASH_SOURCE[0]}")/common-utils.sh"
+
+# 主函数
+main() {
+    local consensus_doc_path="$1"
+    local technical_doc_path="$2"
+
+    hook_log "INFO" "开始执行需求对齐后置处理"
+
+    # 初始化环境
+    init_hook_environment
+
+    # 检查技术方案文档是否存在
+    if [ ! -f "$technical_doc_path" ]; then
+        hook_log "ERROR" "技术方案文档不存在: $technical_doc_path"
+        return 1
+    fi
+
+    # 更新需求状态
+    local doc_dir=$(dirname "$consensus_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
+技术方案: $technical_doc_path
+状态: 待确认
+
+涉及技术栈:
+$(cat "$AICO_HOOKS_TEMP_DIR/tech-context.txt" 2>/dev/null || echo "未记录")
+
+处理步骤:
+1. ✅ 技术分析完成
+2. ✅ 实施方案制定
+3. ⏳ 等待用户确认
+EOF
+
+    hook_log "INFO" "需求对齐后置处理完成"
+
+    # 更新 hook 状态
+    update_hook_status "requirement-aligner" "success"
+
+    return 0
+}
+
+# 执行主函数
+main "$@"

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

@@ -0,0 +1,58 @@
+#!/usr/bin/env bash
+# 需求识别阶段后置 Hook
+
+# 加载通用工具库
+source "$(dirname "${BASH_SOURCE[0]}")/common-utils.sh"
+
+# 主函数
+main() {
+    local requirement_desc="$1"
+    local consensus_doc_path="$2"
+
+    hook_log "INFO" "开始执行需求识别后置处理"
+
+    # 初始化环境
+    init_hook_environment
+
+    # 检查共识文档是否存在
+    if [ ! -f "$consensus_doc_path" ]; then
+        hook_log "ERROR" "共识文档不存在: $consensus_doc_path"
+        return 1
+    fi
+
+    # 更新需求状态
+    local req_name=$(echo "$requirement_desc" | head -c 20 | tr ' ' '_' | tr -cd '[:alnum:]_-')
+    local doc_dir=".aico/docs/$req_name"
+
+    echo "待确认" > "$doc_dir/状态"
+    hook_log "INFO" "需求状态已设置为: 待确认"
+
+    # 记录处理完成时间
+    local completion_time=$(get_timestamp)
+    echo "$completion_time" > "$doc_dir/识别完成时间"
+
+    # 生成处理摘要
+    cat > "$doc_dir/识别摘要.txt" << EOF
+需求识别完成摘要
+================
+需求描述: $requirement_desc
+识别时间: $completion_time
+共识文档: $consensus_doc_path
+状态: 待确认
+
+处理步骤:
+1. ✅ 需求分析完成
+2. ✅ 共识文档生成
+3. ⏳ 等待用户确认
+EOF
+
+    hook_log "INFO" "需求识别后置处理完成"
+
+    # 更新 hook 状态
+    update_hook_status "requirement-identifier" "success"
+
+    return 0
+}
+
+# 执行主函数
+main "$@"

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

@@ -0,0 +1,96 @@
+#!/usr/bin/env bash
+# 质量验证阶段后置 Hook
+
+# 加载通用工具库
+source "$(dirname "${BASH_SOURCE[0]}")/common-utils.sh"
+
+# 主函数
+main() {
+    local completion_report_path="$1"
+    local validation_report_path="$2"
+
+    hook_log "INFO" "开始执行质量验证后置处理"
+
+    # 初始化环境
+    init_hook_environment
+
+    # 检查验证报告文档是否存在
+    if [ ! -f "$validation_report_path" ]; then
+        hook_log "ERROR" "验证报告文档不存在: $validation_report_path"
+        return 1
+    fi
+
+    # 分析验证结果
+    local doc_dir=$(dirname "$completion_report_path")
+    local req_name=$(basename "$doc_dir")
+
+    # 统计验证结果
+    local passed_count=$(grep -c "✅\|通过" "$validation_report_path" 2>/dev/null || echo "0")
+    local failed_count=$(grep -c "❌\|失败" "$validation_report_path" 2>/dev/null || echo "0")
+    local total_count=$((passed_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
+验证报告: $validation_report_path
+总验证项: $total_count
+通过项: $passed_count
+未通过项: $failed_count
+验证状态: $(if [ "$failed_count" -eq 0 ]; then echo "验证通过"; else echo "验证未通过"; fi)
+
+验证统计:
+- ✅ 通过: $passed_count
+- ❌ 未通过: $failed_count
+- 📊 总计: $total_count
+
+质量评级: $(if [ "$failed_count" -eq 0 ]; then echo "优秀"; elif [ "$passed_count" -gt "$failed_count" ]; then echo "良好"; else echo "需改进"; fi)
+
+处理步骤:
+1. ✅ 质量验证完成
+2. ✅ 验证报告生成
+3. ✅ 质量评级确定
+4. 🎯 需求生命周期完成
+EOF
+
+    # 更新整体需求状态
+    if [ "$failed_count" -eq 0 ]; then
+        echo "已完成" > "$doc_dir/需求状态"
+        hook_log "INFO" "需求生命周期完成，质量评级: 优秀"
+    else
+        echo "部分完成" > "$doc_dir/需求状态"
+        hook_log "INFO" "需求生命周期完成，质量评级: $(if [ "$passed_count" -gt "$failed_count" ]; then echo "良好"; else echo "需改进"; fi)"
+    fi
+
+    hook_log "INFO" "质量验证后置处理完成，通过: $passed_count, 未通过: $failed_count"
+
+    # 更新 hook 状态
+    update_hook_status "task-executor-validator" "success"
+
+    # 清理临时状态文件
+    cleanup_hook_status "requirement-identifier"
+    cleanup_hook_status "requirement-aligner"
+    cleanup_hook_status "task-splitter-validator"
+    cleanup_hook_status "task-executor"
+    cleanup_hook_status "task-executor-validator"
+
+    return 0
+}
+
+# 执行主函数
+main "$@"