aico-cli 2.0.27 → 2.0.28

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

@@ -1,458 +0,0 @@
-# 需求场景识别智能体 - PowerShell 跨平台实用函数库
-# 支持 Windows PowerShell、PowerShell Core、Git Bash、Cygwin、WSL
-
-# 加载跨平台工具库
-. "$PSScriptRoot\crossplatform-utils.ps1"
-
-# 全局变量
-$global:USER_INPUT = ""
-$global:DIALOG_HISTORY = ""
-$global:PROJECT_CONTEXT = ""
-$global:INTENT_TYPE = ""
-$global:ROLE = ""
-$global:GOAL = ""
-$global:ACCEPTANCE = ""
-$global:REQUIREMENT_DESC = ""
-
-# 信息收集函数
-function Collect-Context {
-    param([string]$UserInput)
-
-    Write-Host "📋 收集需求上下文信息..." -ForegroundColor Cyan
-
-    # 用户输入
-    $global:USER_INPUT = $UserInput
-    $global:REQUIREMENT_DESC = $UserInput
-    Write-Host "用户输入: $UserInput" -ForegroundColor Green
-
-    # 对话历史（最近10条）
-    $conversationLog = ""
-    switch (Get-Platform) {
-        "windows" { $conversationLog = "$env:USERPROFILE\.claude\conversation.log" }
-        default { $conversationLog = "$env:HOME\.claude\conversation.log" }
-    }
-
-    if (Test-Path $conversationLog -PathType Leaf) {
-        try {
-            $global:DIALOG_HISTORY = Get-Content $conversationLog -Tail 10 -ErrorAction SilentlyContinue
-            if ($null -eq $global:DIALOG_HISTORY) {
-                $global:DIALOG_HISTORY = Get-Content $conversationLog -TotalCount 10 -ErrorAction SilentlyContinue
-            }
-            Write-Host "对话上下文已加载" -ForegroundColor Green
-        } catch {
-            $global:DIALOG_HISTORY = "无可用对话历史"
-        }
-    } else {
-        $global:DIALOG_HISTORY = "无可用对话历史"
-    }
-
-    # 项目背景
-    if (Test-Path "CLAUDE.md" -PathType Leaf) {
-        try {
-            $global:PROJECT_CONTEXT = Get-Content "CLAUDE.md" -TotalCount 50 -ErrorAction SilentlyContinue
-            Write-Host "项目配置文件已加载" -ForegroundColor Green
-        } catch {
-            $global:PROJECT_CONTEXT = "项目配置文件读取失败"
-        }
-    } else {
-        $global:PROJECT_CONTEXT = "未找到CLAUDE.md，请确保项目根目录存在此文件"
-    }
-}
-
-# 需求要素提取函数
-function Extract-Requirements {
-    param([string]$InputText)
-
-    # 使用兼容的正则表达式
-    # 提取角色（谁需要）
-    if ($InputText -match "(用户|客户|管理员|开发者)") {
-        $global:ROLE = ($InputText | Select-String -Pattern "(用户|客户|管理员|开发者)" -AllMatches).Matches[0].Value
-    }
-
-    # 提取目标（要做什么）
-    if ($InputText -match "(实现|开发|添加|创建|优化|修复)") {
-        $global:GOAL = ($InputText | Select-String -Pattern "(实现|开发|添加|创建|优化|修复)[^，。]*").Matches[0].Value
-    }
-
-    # 提取验收条件（如何验证）
-    if ($InputText -match "(能够|可以|支持|满足|达到)") {
-        $global:ACCEPTANCE = ($InputText | Select-String -Pattern "(能够|可以|支持|满足|达到)[^，。]*").Matches[0].Value
-    }
-}
-
-# 工程分析函数 - 分析项目现状
-function Explore-Project {
-    Write-Host "🔍 分析项目现状..." -ForegroundColor Cyan
-
-    # 检查项目结构
-    $projectStructure = ""
-    if (Test-Path "src" -PathType Container) {
-        $files = Find-Files -Pattern "*.js|*.ts|*.py|*.java" -MaxResults 10
-        $projectStructure = $files -join ","
-    } elseif (Test-Path "lib" -PathType Container) {
-        $files = Find-Files -Pattern "*.js|*.ts|*.py|*.java" -MaxResults 10
-        $projectStructure = $files -join ","
-    } else {
-        $files = Find-Files -Pattern "*.js|*.ts|*.py|*.java" -MaxResults 10
-        $projectStructure = $files -join ","
-    }
-
-    # 检查配置文件
-    $configFiles = @()
-    if (Test-Path "package.json" -PathType Leaf) { $configFiles += "package.json" }
-    if (Test-Path "requirements.txt" -PathType Leaf) { $configFiles += "requirements.txt" }
-    if (Test-Path "pom.xml" -PathType Leaf) { $configFiles += "pom.xml" }
-
-    $modules = Identify-ProjectModules
-    Write-Host "项目结构: $(if ($projectStructure) { $projectStructure } else { '未知' })" -ForegroundColor Green
-    Write-Host "配置文件: $(if ($configFiles.Count -gt 0) { $configFiles -join ',' } else { '无' })" -ForegroundColor Green
-    Write-Host "主要模块: $modules" -ForegroundColor Green
-}
-
-# 模块识别函数
-function Identify-ProjectModules {
-    $modules = @()
-
-    # 检查常见的模块目录
-    if (Test-Path "src\components" -PathType Container) -or (Test-Path "src\modules" -PathType Container) {
-        $modules += "前端组件"
-    }
-
-    if (Test-Path "src\services" -PathType Container) -or (Test-Path "src\api" -PathType Container) {
-        $modules += "API服务"
-    }
-
-    if (Test-Path "src\utils" -PathType Container) -or (Test-Path "src\helpers" -PathType Container) {
-        $modules += "工具函数"
-    }
-
-    if (Test-Path "src\models" -PathType Container) -or (Test-Path "src\entities" -PathType Container) {
-        $modules += "数据模型"
-    }
-
-    if (Test-Path "tests" -PathType Container) -or (Test-Path "src\__tests__" -PathType Container) {
-        $modules += "测试模块"
-    }
-
-    # 如果没有识别到特定模块，根据文件类型判断
-    if ($modules.Count -eq 0) {
-        $jsFiles = Find-Files -Pattern "*.js|*.ts|*.jsx|*.tsx" -MaxResults 1
-        $pyFiles = Find-Files -Pattern "*.py" -MaxResults 1
-        $javaFiles = Find-Files -Pattern "*.java" -MaxResults 1
-
-        if ($jsFiles.Count -gt 0) {
-            $modules += "前端应用"
-        } elseif ($pyFiles.Count -gt 0) {
-            $modules += "Python应用"
-        } elseif ($javaFiles.Count -gt 0) {
-            $modules += "Java应用"
-        }
-    }
-
-    if ($modules.Count -eq 0) {
-        return "通用应用"
-    } else {
-        return $modules -join ","
-    }
-}
-
-# 深度意图分析函数
-function Analyze-IntentDeeply {
-    param([string]$InputText)
-
-    # 第一阶段：初步关键词识别（用于快速分类）
-    $preliminaryType = ""
-    if ($InputText -match "(错误|问题|修复|bug|故障|异常)") {
-        $preliminaryType = "问题修复"
-    } elseif ($InputText -match "(文档|说明|手册|指南|帮助|如何|怎样)") {
-        $preliminaryType = "文档咨询"
-    } elseif ($InputText -match "(优化|性能|速度|效率|体验|界面|ui|ux)") {
-        $preliminaryType = "体验优化"
-    }
-
-    # 第二阶段：工程分析（针对功能相关需求）
-    if ([string]::IsNullOrEmpty($preliminaryType) -or $InputText -match "(开发|实现|添加|创建|修改|调整|改进|更新)") {
-        Explore-Project
-
-        # 基于工程分析判断是新增还是修改
-        if ($InputText -match "(修改|调整|改进|更新|重构|enhance|update|refactor)") {
-            $global:INTENT_TYPE = "功能修改"
-            Write-Host "识别到需求类型: 功能修改 (基于明确的修改关键词)" -ForegroundColor Green
-        } else {
-            # 需要进一步分析工程现状
-            if ((Test-Path "src" -PathType Container) -or (Test-Path "lib" -PathType Container) -or
-                (Test-Path "package.json" -PathType Leaf) -or (Test-Path "requirements.txt" -PathType Leaf) -or
-                (Test-Path "pom.xml" -PathType Leaf)) {
-                $global:INTENT_TYPE = "功能修改"
-                Write-Host "识别到需求类型: 功能修改 (基于现有工程结构)" -ForegroundColor Green
-            } else {
-                $global:INTENT_TYPE = "功能新增"
-                Write-Host "识别到需求类型: 功能新增 (基于空项目或新项目)" -ForegroundColor Green
-            }
-        }
-    } else {
-        $global:INTENT_TYPE = $preliminaryType
-        Write-Host "识别到需求类型: $global:INTENT_TYPE" -ForegroundColor Green
-    }
-
-    Extract-Requirements -InputText $InputText
-}
-
-# 分析函数（兼容旧接口）
-function Analyze-Requirement {
-    param([string]$InputText)
-    Analyze-IntentDeeply -InputText $InputText
-}
-
-# 确认模板生成函数
-function Generate-Confirmation {
-    param(
-        [string]$Requirement,
-        [string]$Intent
-    )
-
-    # 根据意图类型生成不同的确认描述
-    $actionDesc = ""
-    switch ($Intent) {
-        "功能新增" { $actionDesc = "开发全新的功能模块" }
-        "功能修改" { $actionDesc = "对现有功能进行迭代优化" }
-        "问题修复" { $actionDesc = "修复系统中的缺陷和问题" }
-        "体验优化" { $actionDesc = "提升系统性能和用户体验" }
-        "文档咨询" { $actionDesc = "提供技术文档和咨询服务" }
-        default { $actionDesc = "处理您的需求" }
-    }
-
-    $projectType = if ((Test-Path "src" -PathType Container) -or (Test-Path "lib" -PathType Container)) { "现有项目" } else { "新项目" }
-    $techStack = if (Test-Path "package.json" -PathType Leaf) { "Node.js" }
-                 elseif (Test-Path "requirements.txt" -PathType Leaf) { "Python" }
-                 elseif (Test-Path "pom.xml" -PathType Leaf) { "Java" }
-                 else { "未知" }
-
-    Write-Host @"
-
-## 📋 需求理解确认
-
-### 🎯 核心需求
-基于工程分析和您的描述，我理解您需要：
-[用一句话概括需求的核心目标]
-
-### 📖 详细描述
-我将为您$actionDesc：
-- 基于当前项目结构进行开发/修改
-- 解决 [问题描述]
-- 达到 [预期效果]
-
-### 🔍 工程分析结果
-- **项目类型**: $projectType
-- **技术栈**: $techStack
-- **涉及模块**: [主要模块]
-
-### ❓ 需要澄清的问题
-[如果有任何不确定的地方，列出具体问题]
-
----
-**请确认：以上基于工程分析的理解是否准确？如果正确，请回复"确认"或"正确"，我将为您生成正式的共识文档。**
-"@ -ForegroundColor Cyan
-}
-
-# 确认响应处理
-function Handle-Confirmation {
-    param([string]$Response)
-
-    # 确认关键词检测
-    if ($Response -match "(确认|正确|是的|没问题|ok|yes|确定)") {
-        Write-Host "✅ 需求已确认，开始生成共识文档..." -ForegroundColor Green
-        Generate-ConsensusDocument
-        return 0
-    } elseif ($Response -match "(不对|错误|不是|no|重新)") {
-        Write-Host "🔄 理解有误，请重新描述您的需求" -ForegroundColor Yellow
-        return 1
-    } else {
-        Write-Host "❓ 未能确认您的意图，请明确回复'确认'或指出需要修改的地方" -ForegroundColor Red
-        return 2
-    }
-}
-
-# 文档生成函数
-function Generate-ConsensusDocument {
-    # 使用兼容的文件名处理
-    $reqName = ($global:REQUIREMENT_DESC.Substring(0, [Math]::Min(20, $global:REQUIREMENT_DESC.Length)) -replace " ", "_") -replace "[^\w_\-]", ""
-    $docDir = ".aico\docs\$reqName"
-
-    # 创建文档目录
-    New-DirectorySafe -Path $docDir
-
-    # 跨平台日期格式
-    $currentDate = Get-Timestamp
-
-    $projectType = if ((Test-Path "src" -PathType Container) -or (Test-Path "lib" -PathType Container)) { "现有项目" } else { "新项目" }
-    $techStack = if (Test-Path "package.json" -PathType Leaf) { "Node.js" }
-                 elseif (Test-Path "requirements.txt" -PathType Leaf) { "Python" }
-                 elseif (Test-Path "pom.xml" -PathType Leaf) { "Java" }
-                 else { "未知" }
-
-    # 生成包含工程分析信息的共识文档
-    $docContent = @"
-# 需求共识文档 - $reqName
-
-**文档版本**：1.0
-**创建时间**：$currentDate
-**需求状态**：已确认
-**需求类型**：$global:INTENT_TYPE
-
-## 📋 原始需求
-$global:REQUIREMENT_DESC
-
-## 🔍 工程分析结果
-**项目结构分析**:
-- 项目类型: $projectType
-- 技术栈: $techStack
-- 主要模块: $(Identify-ProjectModules)
-
-**意图识别依据**:
-- 关键词分析: $(($global:REQUIREMENT_DESC | Select-String -Pattern "(开发|实现|添加|创建|修改|调整|修复|优化|文档)" -AllMatches).Matches.Value -join ',')
-- 工程上下文: $(if ((Test-Path "src" -PathType Container) -or (Test-Path "lib" -PathType Container)) { "现有代码库" } else { "新建项目" })
-
-## 🎯 确认后的需求理解
-[基于用户确认和工程分析的详细需求描述]
-
-## 🛠️ 实施建议
-基于工程分析，建议采用以下策略：
-$(
-    switch ($global:INTENT_TYPE) {
-        "功能新增" { "- 创建新的功能模块和组件" }
-        "功能修改" { "- 在现有架构基础上进行迭代开发" }
-        "问题修复" { "- 定位并修复现有代码中的缺陷" }
-        "体验优化" { "- 优化现有功能的性能和用户体验" }
-        "文档咨询" { "- 提供详细的技术文档和使用指南" }
-        default { "- 根据具体需求制定实施方案" }
-    }
-)
-
-"@
-
-    $docPath = Join-Path $docDir "共识文档.md"
-    try {
-        Set-Content -Path $docPath -Value $docContent -Encoding UTF8
-        Write-Host "📄 共识文档已生成至: $docPath" -ForegroundColor Green
-        Write-Host "🚀 是否需要我基于此文档开始进行任务分解或代码开发？" -ForegroundColor Cyan
-    } catch {
-        Write-Host "❌ 文档生成失败: $_" -ForegroundColor Red
-    }
-}
-
-# 状态文件处理
-function Set-RequirementStatus {
-    param([string]$Status)
-
-    $tempDir = Get-TempDirectory
-    $statusFile = Join-Path $tempDir "requirement_status"
-
-    try {
-        Set-Content -Path $statusFile -Value $Status -Encoding UTF8
-        Write-Host "状态已更新: $Status" -ForegroundColor Green
-    } catch {
-        Write-Host "状态更新失败: $_" -ForegroundColor Red
-    }
-}
-
-function Get-RequirementStatus {
-    $tempDir = Get-TempDirectory
-    $statusFile = Join-Path $tempDir "requirement_status"
-
-    if (Test-Path $statusFile -PathType Leaf) {
-        return Get-Content $statusFile -ErrorAction SilentlyContinue
-    } else {
-        return "暂无正在处理的需求"
-    }
-}
-
-# 主流程执行函数
-function Main-Workflow {
-    param([string]$UserInput)
-
-    # 阶段1: 信息收集
-    Collect-Context -UserInput $UserInput
-
-    # 阶段2: 分析与识别
-    Analyze-Requirement -InputText $UserInput
-
-    # 阶段3: 复述与确认
-    Generate-Confirmation -Requirement $UserInput -Intent $global:INTENT_TYPE
-
-    # 记录等待确认状态
-    Set-RequirementStatus -Status "CONFIRMATION_PENDING"
-}
-
-# 确认响应处理函数
-function Process-Confirmation {
-    param([string]$Response)
-
-    $status = Handle-Confirmation -Response $Response
-
-    switch ($status) {
-        0 { # 已确认
-            Write-Host "✅ 共识文档生成完成" -ForegroundColor Green
-            Set-RequirementStatus -Status "DOCUMENT_GENERATED"
-        }
-        1 { # 需要重新理解
-            Write-Host "🔄 请重新描述您的需求" -ForegroundColor Yellow
-            Set-RequirementStatus -Status "NEEDS_REDESCRIPTION"
-        }
-        2 { # 确认不明确
-            Write-Host "❓ 请明确回复'确认'或指出需要修改的地方" -ForegroundColor Red
-            Set-RequirementStatus -Status "CONFIRMATION_UNCLEAR"
-        }
-    }
-}
-
-# 异常处理函数
-function Handle-AmbiguousRequirement {
-    Write-Host "🤔 您的需求描述比较模糊，请帮助我理解：" -ForegroundColor Yellow
-    Write-Host "1. 这个需求要解决什么具体问题？" -ForegroundColor White
-    Write-Host "2. 期望达到什么样的效果？" -ForegroundColor White
-    Write-Host "3. 有哪些必须包含的功能点？" -ForegroundColor White
-    Write-Host "请详细描述，我会更好地为您服务。" -ForegroundColor Cyan
-}
-
-function Handle-TechnicalLimitation {
-    Write-Host "⚠️ 这个需求涉及的技术超出了我当前的能力范围。" -ForegroundColor Red
-    Write-Host "建议：" -ForegroundColor Yellow
-    Write-Host "- 考虑简化需求或分阶段实施" -ForegroundColor White
-    Write-Host "- 寻求专业开发团队的支持" -ForegroundColor White
-    Write-Host "- 使用现有的成熟解决方案" -ForegroundColor White
-    Write-Host "我可以帮您分析替代方案，请告诉我您的具体约束条件。" -ForegroundColor Cyan
-}
-
-function Handle-RequirementConflict {
-    Write-Host "⚖️ 检测到需求中存在潜在的冲突点：" -ForegroundColor Yellow
-    Write-Host "- [冲突点1描述]" -ForegroundColor White
-    Write-Host "- [冲突点2描述]" -ForegroundColor White
-    Write-Host "请帮助我确定优先级：" -ForegroundColor Cyan
-    Write-Host "1. 哪个需求更重要？" -ForegroundColor White
-    Write-Host "2. 是否有折中方案？" -ForegroundColor White
-    Write-Host "3. 是否需要分阶段实现？" -ForegroundColor White
-}
-
-# 状态查询命令
-function Get-RequirementStatusCmd {
-    return Get-RequirementStatus
-}
-
-# 后续行动建议
-function Suggest-NextActions {
-    Write-Host "🎉 共识文档已生成！接下来您可以：" -ForegroundColor Green
-    Write-Host "1. 📋 进行任务分解：将需求拆分为可执行的任务" -ForegroundColor Cyan
-    Write-Host "2. 💻 开始代码开发：基于共识文档实现功能" -ForegroundColor Cyan
-    Write-Host "3. 🧪 制定测试计划：编写验收测试用例" -ForegroundColor Cyan
-    Write-Host "4. 📊 评估资源需求：分析所需时间和资源" -ForegroundColor Cyan
-    Write-Host "请告诉我您希望进行哪项工作？" -ForegroundColor White
-}
-
-# 导出函数供其他脚本使用
-Export-ModuleMember -Function Collect-Context, Extract-Requirements, Explore-Project
-Export-ModuleMember -Function Identify-ProjectModules, Analyze-IntentDeeply, Analyze-Requirement
-Export-ModuleMember -Function Generate-Confirmation, Handle-Confirmation, Generate-ConsensusDocument
-Export-ModuleMember -Function Set-RequirementStatus, Get-RequirementStatus, Main-Workflow
-Export-ModuleMember -Function Process-Confirmation, Handle-AmbiguousRequirement, Handle-TechnicalLimitation
-Export-ModuleMember -Function Handle-RequirementConflict, Get-RequirementStatusCmd, Suggest-NextActions