aico-cli 0.2.2 → 0.2.5

package/templates/agents/aico/requirement/requirement-functions-crossplatform.sh

@@ -0,0 +1,472 @@
+#!/usr/bin/env bash
+# 需求场景识别智能体 - 跨平台实用函数库
+# 支持 Windows (Git Bash/Cygwin/WSL)、Linux、macOS
+
+# 平台检测函数
+detect_platform() {
+    case "$(uname -s)" in
+        Darwin)
+            PLATFORM="macos"
+            ;;
+        Linux)
+            PLATFORM="linux"
+            ;;
+        CYGWIN*|MINGW*|MSYS*)
+            PLATFORM="windows"
+            ;;
+        *)
+            PLATFORM="unknown"
+            ;;
+    esac
+    echo "检测到平台: $PLATFORM"
+}
+
+# 跨平台临时目录
+get_temp_dir() {
+    case "$PLATFORM" in
+        windows)
+            # Windows: 使用用户临时目录
+            if [ -n "$TEMP" ]; then
+                echo "$TEMP"
+            elif [ -n "$TMP" ]; then
+                echo "$TMP"
+            else
+                echo "/tmp"
+            fi
+            ;;
+        *)
+            # Linux/macOS: 使用标准临时目录
+            echo "/tmp"
+            ;;
+    esac
+}
+
+# 跨平台文件路径处理
+normalize_path() {
+    local path="$1"
+    case "$PLATFORM" in
+        windows)
+            # 将路径转换为 Windows 兼容格式
+            echo "$path" | sed 's|/|\\|g'
+            ;;
+        *)
+            echo "$path"
+            ;;
+    esac
+}
+
+# 信息收集函数
+collect_context() {
+    echo "📋 收集需求上下文信息..."
+    
+    # 用户输入
+    USER_INPUT="$1"
+    echo "用户输入: $USER_INPUT"
+    
+    # 对话历史（最近10条）
+    local conversation_log=""
+    case "$PLATFORM" in
+        windows)
+            conversation_log="$USERPROFILE/.claude/conversation.log"
+            ;;
+        *)
+            conversation_log="$HOME/.claude/conversation.log"
+            ;;
+    esac
+    
+    if [ -f "$conversation_log" ]; then
+        DIALOG_HISTORY=$(tail -n 10 "$conversation_log" 2>/dev/null || head -n 10 "$conversation_log")
+        echo "对话上下文已加载"
+    else
+        DIALOG_HISTORY="无可用对话历史"
+    fi
+    
+    # 项目背景
+    if [ -f "CLAUDE.md" ]; then
+        PROJECT_CONTEXT=$(head -n 50 CLAUDE.md 2>/dev/null || sed -n '1,50p' CLAUDE.md)
+        echo "项目配置文件已加载"
+    else
+        PROJECT_CONTEXT="未找到CLAUDE.md，请确保项目根目录存在此文件"
+    fi
+}
+
+# 需求要素提取函数
+extract_requirements() {
+    local input="$1"
+    
+    # 使用兼容的正则表达式
+    # 提取角色（谁需要）
+    if echo "$input" | grep -q -E "(用户|客户|管理员|开发者)"; then
+        ROLE=$(echo "$input" | grep -o -E "(用户|客户|管理员|开发者)" | head -1)
+    fi
+    
+    # 提取目标（要做什么）
+    if echo "$input" | grep -q -E "(实现|开发|添加|创建|优化|修复)"; then
+        GOAL=$(echo "$input" | grep -o -E "(实现|开发|添加|创建|优化|修复)[^，。]*")
+    fi
+    
+    # 提取验收条件（如何验证）
+    if echo "$input" | grep -q -E "(能够|可以|支持|满足|达到)"; then
+        ACCEPTANCE=$(echo "$input" | grep -o -E "(能够|可以|支持|满足|达到)[^，。]*")
+    fi
+}
+
+# 工程分析函数 - 分析项目现状
+explore_project() {
+    echo "🔍 分析项目现状..."
+    
+    # 检查项目结构
+    local project_structure=""
+    if [ -d "src" ]; then
+        project_structure="$(find src -type f -name "*.js" -o -name "*.ts" -o -name "*.py" -o -name "*.java" 2>/dev/null | head -10 | tr '\n' ',' | sed 's/,$//')"
+    elif [ -d "lib" ]; then
+        project_structure="$(find lib -type f -name "*.js" -o -name "*.ts" -o -name "*.py" -o -name "*.java" 2>/dev/null | head -10 | tr '\n' ',' | sed 's/,$//')"
+    else
+        project_structure="$(find . -maxdepth 2 -type f -name "*.js" -o -name "*.ts" -o -name "*.py" -o -name "*.java" 2>/dev/null | head -10 | tr '\n' ',' | sed 's/,$//')"
+    fi
+    
+    # 检查配置文件
+    local config_files=""
+    if [ -f "package.json" ]; then
+        config_files="package.json"
+    fi
+    if [ -f "requirements.txt" ]; then
+        config_files="$config_files,requirements.txt"
+    fi
+    if [ -f "pom.xml" ]; then
+        config_files="$config_files,pom.xml"
+    fi
+    
+    local modules=$(identify_project_modules)
+    echo "项目结构: ${project_structure:-未知}"
+    echo "配置文件: ${config_files:-无}"
+    echo "主要模块: $modules"
+}
+
+# 模块识别函数
+identify_project_modules() {
+    local modules=""
+    
+    # 检查常见的模块目录
+    if [ -d "src/components" ] || [ -d "src/modules" ]; then
+        modules="前端组件"
+    fi
+    
+    if [ -d "src/services" ] || [ -d "src/api" ]; then
+        modules="${modules:+$modules,}API服务"
+    fi
+    
+    if [ -d "src/utils" ] || [ -d "src/helpers" ]; then
+        modules="${modules:+$modules,}工具函数"
+    fi
+    
+    if [ -d "src/models" ] || [ -d "src/entities" ]; then
+        modules="${modules:+$modules,}数据模型"
+    fi
+    
+    if [ -d "tests" ] || [ -d "src/__tests__" ]; then
+        modules="${modules:+$modules,}测试模块"
+    fi
+    
+    # 如果没有识别到特定模块，根据文件类型判断
+    if [ -z "$modules" ]; then
+        if find . -name "*.js" -o -name "*.ts" -o -name "*.jsx" -o -name "*.tsx" | head -1 > /dev/null 2>&1; then
+            modules="前端应用"
+        elif find . -name "*.py" | head -1 > /dev/null 2>&1; then
+            modules="Python应用"
+        elif find . -name "*.java" | head -1 > /dev/null 2>&1; then
+            modules="Java应用"
+        fi
+    fi
+    
+    echo "${modules:-通用应用}"
+}
+
+# 深度意图分析函数
+analyze_intent_deeply() {
+    local input="$1"
+    
+    # 第一阶段：初步关键词识别（用于快速分类）
+    local preliminary_type=""
+    if echo "$input" | grep -q -E "(错误|问题|修复|bug|故障|异常)"; then
+        preliminary_type="问题修复"
+    elif echo "$input" | grep -q -E "(文档|说明|手册|指南|帮助|如何|怎样)"; then
+        preliminary_type="文档咨询"
+    elif echo "$input" | grep -q -E "(优化|性能|速度|效率|体验|界面|ui|ux)"; then
+        preliminary_type="体验优化"
+    fi
+    
+    # 第二阶段：工程分析（针对功能相关需求）
+    if [ -z "$preliminary_type" ] || echo "$input" | grep -q -E "(开发|实现|添加|创建|修改|调整|改进|更新)"; then
+        explore_project
+        
+        # 基于工程分析判断是新增还是修改
+        if echo "$input" | grep -q -E "(修改|调整|改进|更新|重构|enhance|update|refactor)"; then
+            INTENT_TYPE="功能修改"
+            echo "识别到需求类型: 功能修改 (基于明确的修改关键词)"
+        else
+            # 需要进一步分析工程现状
+            if [ -d "src" ] || [ -d "lib" ] || [ -f "package.json" ] || [ -f "requirements.txt" ] || [ -f "pom.xml" ]; then
+                INTENT_TYPE="功能修改"
+                echo "识别到需求类型: 功能修改 (基于现有工程结构)"
+            else
+                INTENT_TYPE="功能新增"
+                echo "识别到需求类型: 功能新增 (基于空项目或新项目)"
+            fi
+        fi
+    else
+        INTENT_TYPE="$preliminary_type"
+        echo "识别到需求类型: $INTENT_TYPE"
+    fi
+    
+    extract_requirements "$input"
+}
+
+# 分析函数（兼容旧接口）
+analyze_requirement() {
+    analyze_intent_deeply "$1"
+}
+
+# 确认模板生成函数
+generate_confirmation() {
+    local requirement="$1"
+    local intent="$2"
+    
+    # 根据意图类型生成不同的确认描述
+    local action_desc=""
+    case "$intent" in
+        "功能新增")
+            action_desc="开发全新的功能模块"
+            ;;
+        "功能修改")
+            action_desc="对现有功能进行迭代优化"
+            ;;
+        "问题修复")
+            action_desc="修复系统中的缺陷和问题"
+            ;;
+        "体验优化")
+            action_desc="提升系统性能和用户体验"
+            ;;
+        "文档咨询")
+            action_desc="提供技术文档和咨询服务"
+            ;;
+        *)
+            action_desc="处理您的需求"
+            ;;
+    esac
+    
+    cat << EOF
+
+## 📋 需求理解确认
+
+### 🎯 核心需求
+基于工程分析和您的描述，我理解您需要：
+[用一句话概括需求的核心目标]
+
+### 📖 详细描述
+我将为您$action_desc：
+- 基于当前项目结构进行开发/修改
+- 解决 [问题描述] 
+- 达到 [预期效果]
+
+### 🔍 工程分析结果
+- **项目类型**: $(if [ -d "src" ] || [ -d "lib" ]; then echo "现有项目"; else echo "新项目"; fi)
+- **技术栈**: $(if [ -f "package.json" ]; then echo "Node.js"; elif [ -f "requirements.txt" ]; then echo "Python"; elif [ -f "pom.xml" ]; then echo "Java"; else echo "未知"; fi)
+- **涉及模块**: [主要模块]
+
+### ❓ 需要澄清的问题
+[如果有任何不确定的地方，列出具体问题]
+
+---
+**请确认：以上基于工程分析的理解是否准确？如果正确，请回复"确认"或"正确"，我将为您生成正式的共识文档。**
+EOF
+}
+
+# 确认响应处理
+handle_confirmation() {
+    local response="$1"
+    
+    # 确认关键词检测 - 使用兼容的正则
+    if echo "$response" | grep -q -E "(确认|正确|是的|没问题|ok|yes|确定)"; then
+        echo "✅ 需求已确认，开始生成共识文档..."
+        generate_consensus_document
+        return 0
+    elif echo "$response" | grep -q -E "(不对|错误|不是|no|重新)"; then
+        echo "🔄 理解有误，请重新描述您的需求"
+        return 1
+    else
+        echo "❓ 未能确认您的意图，请明确回复"确认"或指出需要修改的地方"
+        return 2
+    fi
+}
+
+# 文档生成函数
+generate_consensus_document() {
+    # 使用兼容的文件名处理
+    local req_name=$(echo "$REQUIREMENT_DESC" | head -c 20 | tr ' ' '_' | tr -cd '[:alnum:]_-')
+    local doc_dir=".aico/docs/$req_name"
+    
+    # 创建文档目录
+    mkdir -p "$doc_dir"
+    
+    # 跨平台日期格式
+    local current_date
+    case "$PLATFORM" in
+        windows)
+            current_date=$(date "+%Y-%m-%d %H:%M:%S" 2>/dev/null || echo "$(date +'%Y-%m-%d %H:%M:%S')")
+            ;;
+        *)
+            current_date=$(date '+%Y-%m-%d %H:%M:%S')
+            ;;
+    esac
+    
+    # 生成包含工程分析信息的共识文档
+    cat > "$doc_dir/共识文档.md" << EOF
+# 需求共识文档 - $req_name
+
+**文档版本**：1.0  
+**创建时间**：$current_date
+**需求状态**：已确认
+**需求类型**：$INTENT_TYPE
+
+## 📋 原始需求
+$REQUIREMENT_DESC
+
+## 🔍 工程分析结果
+**项目结构分析**:
+- 项目类型: $(if [ -d "src" ] || [ -d "lib" ]; then echo "现有项目"; else echo "新项目"; fi)
+- 技术栈: $(if [ -f "package.json" ]; then echo "Node.js"; elif [ -f "requirements.txt" ]; then echo "Python"; elif [ -f "pom.xml" ]; then echo "Java"; else echo "未知"; fi)
+- 主要模块: $(identify_project_modules)
+
+**意图识别依据**:
+- 关键词分析: $(echo "$REQUIREMENT_DESC" | grep -o -E "(开发|实现|添加|创建|修改|调整|修复|优化|文档)" | head -3 | tr '\n' ',' | sed 's/,$//')
+- 工程上下文: $(if [ -d "src" ] || [ -d "lib" ]; then echo "现有代码库"; else echo "新建项目"; fi)
+
+## 🎯 确认后的需求理解
+[基于用户确认和工程分析的详细需求描述]
+
+## 🛠️ 实施建议
+基于工程分析，建议采用以下策略：
+$(case "$INTENT_TYPE" in
+    "功能新增") echo "- 创建新的功能模块和组件" ;;
+    "功能修改") echo "- 在现有架构基础上进行迭代开发" ;;
+    "问题修复") echo "- 定位并修复现有代码中的缺陷" ;;
+    "体验优化") echo "- 优化现有功能的性能和用户体验" ;;
+    "文档咨询") echo "- 提供详细的技术文档和使用指南" ;;
+    *) echo "- 根据具体需求制定实施方案" ;;
+esac)
+
+EOF
+    
+    echo "📄 共识文档已生成至: $doc_dir/共识文档.md"
+    echo "🚀 是否需要我基于此文档开始进行任务分解或代码开发？"
+}
+
+# 状态文件处理
+set_requirement_status() {
+    local status="$1"
+    local temp_dir=$(get_temp_dir)
+    local status_file="$temp_dir/requirement_status"
+    
+    echo "$status" > "$status_file"
+    echo "状态已更新: $status"
+}
+
+get_requirement_status() {
+    local temp_dir=$(get_temp_dir)
+    local status_file="$temp_dir/requirement_status"
+    
+    if [ -f "$status_file" ]; then
+        cat "$status_file"
+    else
+        echo "暂无正在处理的需求"
+    fi
+}
+
+# 主流程执行函数
+main_workflow() {
+    local user_input="$1"
+    
+    # 初始化平台检测
+    detect_platform
+    
+    # 阶段1: 信息收集
+    collect_context "$user_input"
+    
+    # 阶段2: 分析与识别
+    analyze_requirement "$user_input"
+    
+    # 阶段3: 复述与确认
+    generate_confirmation "$user_input" "$INTENT_TYPE"
+    
+    # 记录等待确认状态
+    set_requirement_status "CONFIRMATION_PENDING"
+}
+
+# 确认响应处理函数
+process_confirmation() {
+    local response="$1"
+    local status=$(handle_confirmation "$response")
+    
+    case $status in
+        0) # 已确认
+            echo "✅ 共识文档生成完成"
+            set_requirement_status "DOCUMENT_GENERATED"
+            ;;
+        1) # 需要重新理解
+            echo "🔄 请重新描述您的需求"
+            set_requirement_status "NEEDS_REDESCRIPTION"
+            ;;
+        2) # 确认不明确
+            echo "❓ 请明确回复'确认'或指出需要修改的地方"
+            set_requirement_status "CONFIRMATION_UNCLEAR"
+            ;;
+    esac
+}
+
+# 异常处理函数
+handle_ambiguous_requirement() {
+    echo "🤔 您的需求描述比较模糊，请帮助我理解："
+    echo "1. 这个需求要解决什么具体问题？"
+    echo "2. 期望达到什么样的效果？"
+    echo "3. 有哪些必须包含的功能点？"
+    echo "请详细描述，我会更好地为您服务。"
+}
+
+handle_technical_limitation() {
+    echo "⚠️ 这个需求涉及的技术超出了我当前的能力范围。"
+    echo "建议："
+    echo "- 考虑简化需求或分阶段实施"
+    echo "- 寻求专业开发团队的支持"
+    echo "- 使用现有的成熟解决方案"
+    echo "我可以帮您分析替代方案，请告诉我您的具体约束条件。"
+}
+
+handle_requirement_conflict() {
+    echo "⚖️ 检测到需求中存在潜在的冲突点："
+    echo "- [冲突点1描述]"
+    echo "- [冲突点2描述]"
+    echo "请帮助我确定优先级："
+    echo "1. 哪个需求更重要？"
+    echo "2. 是否有折中方案？"
+    echo "3. 是否需要分阶段实现？"
+}
+
+# 状态查询命令
+requirement_status() {
+    get_requirement_status
+}
+
+# 后续行动建议
+suggest_next_actions() {
+    echo "🎉 共识文档已生成！接下来您可以："
+    echo "1. 📋 进行任务分解：将需求拆分为可执行的任务"
+    echo "2. 💻 开始代码开发：基于共识文档实现功能"
+    echo "3. 🧪 制定测试计划：编写验收测试用例"
+    echo "4. 📊 评估资源需求：分析所需时间和资源"
+    echo "请告诉我您希望进行哪项工作？"
+}
+
+# 初始化
+detect_platform
+echo "✅ 跨平台需求场景识别智能体函数库已加载 (支持 Windows/Linux/macOS)"