aico-cli 0.3.17 → 0.4.0

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

@@ -0,0 +1,458 @@
+# 需求场景识别智能体 - 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

package/templates/agents/aico/requirement/requirement-identifier.md

@@ -5,11 +5,50 @@ tools: Read, Write, Bash
 color: blue
 ---
 
-> 📦 实用函数库: 
-> - [requirement-functions-crossplatform.sh](./requirement-functions-crossplatform.sh) (支持 Windows/Linux/macOS)
-> - [requirement-launcher.sh](./requirement-launcher.sh) (跨平台启动器)
+> 📦 实用函数库:
+> - [requirement-functions-crossplatform.sh](./requirement-functions-crossplatform.sh) (Bash 版本，支持 Windows/Linux/macOS)
+> - [requirement-functions-crossplatform.ps1](./requirement-functions-crossplatform.ps1) (PowerShell 版本，支持 Windows/Linux/macOS)
+> - [crossplatform-utils.sh](./crossplatform-utils.sh) (Bash 跨平台工具库)
+> - [crossplatform-utils.ps1](./crossplatform-utils.ps1) (PowerShell 跨平台工具库)
+>
+> 🚀 启动器:
+> - [requirement-launcher.sh](./requirement-launcher.sh) (Bash 跨平台启动器)
+> - [requirement-launcher.ps1](./requirement-launcher.ps1) (PowerShell 跨平台启动器)
+>
+> 🌐 跨平台支持: 详细请参考 [WINDOWS_USAGE.md](./WINDOWS_USAGE.md)
+
+## 💻 调用方式
+
+### Linux/macOS 和 Windows Git Bash/WSL
+```bash
+# 使用 Bash 启动器
+./requirement-launcher.sh "需要开发一个用户登录功能"
+
+# 直接调用函数库
+source requirement-functions-crossplatform.sh
+main_workflow "修复页面加载速度慢的问题"
+```
 
-> 🌐 跨平台支持: 详细请参考 [PLATFORM_COMPATIBILITY.md](./PLATFORM_COMPATIBILITY.md)
+### Windows PowerShell
+```powershell
+# 使用 PowerShell 启动器
+.\requirement-launcher.ps1 "需要开发一个用户登录功能"
+
+# 直接调用函数库
+. .\requirement-functions-crossplatform.ps1
+Main-Workflow -UserInput "修复页面加载速度慢的问题"
+```
+
+### 跨平台通用示例
+```bash
+# Linux/macOS/PowerShell 统一接口
+# 基本用法
+启动器 "您的需求描述"
+
+# 带参数的详细用法
+./requirement-launcher.sh "优化数据库查询性能" -Verbose
+.\requirement-launcher.ps1 "优化数据库查询性能" -Verbose
+```
 
 # 需求场景识别智能体