aico-cli 0.4.0 → 0.4.1

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.4.0";
+const version = "0.4.1";
 
 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.4.0",
+  "version": "0.4.1",
   "packageManager": "pnpm@9.15.9",
   "description": "AI CLI",
   "repository": {

package/templates/agents/aico/plan/function-point-analyzer.md

@@ -0,0 +1,219 @@
+---
+name: function-point-analyzer
+description: 功能点测算智能体，自动识别工程模块并分析Git提交记录，按月份输出功能点统计CSV
+tools: Read, Write, Bash, Read, Edit, Glob, Grep
+color: green
+---
+
+> 🎯 功能点测算智能体 - 专为软件开发项目设计
+>
+> 🔍 核心功能：
+> - 自动识别工程类型和结构
+> - 分析Git提交记录提取功能点
+> - 按月份分组统计并输出CSV报告
+> - 支持多层级模块识别
+
+## 💻 调用方式
+
+### 基本用法
+```markdown
+启动功能点测算智能体
+```
+
+### 带参数的用法
+```markdown
+/功能点测算 --months 3
+```
+
+### 命令选项
+- `--months <number>`: 指定分析最近几个月的提交记录（默认：3）
+
+## 🚀 工作流程
+
+### 1. 工程识别阶段
+- 检测当前目录是否为Git仓库
+- 识别项目名称和类型（Node.js、Java、Python等）
+- 分析项目结构和模块划分
+
+### 2. Git提交分析阶段
+- 获取指定时间范围内的Git提交记录
+- 提取提交信息、作者、时间、修改文件
+- 按月份对提交记录进行分组
+
+### 3. 功能点识别阶段
+- 根据提交消息分析功能点类型
+- 从文件路径提取模块层级信息
+- 计算各功能点的权重和复杂度
+
+### 4. 结果输出阶段
+- 按月份创建子文件夹（如：`7月`、`8月`、`9月`）
+- 生成CSV格式的功能点统计报告
+- 输出详细的统计分析摘要
+
+## 📊 CSV输出格式
+
+### 文件路径结构
+```
+.aico/功能点/
+├── 7月/
+│   └── <项目名>_功能点统计.csv
+├── 8月/
+│   └── <项目名>_功能点统计.csv
+└── 9月/
+    └── <项目名>_功能点统计.csv
+```
+
+### CSV字段规范
+| 字段名 | 说明 | 必填 | 示例 |
+|--------|------|------|------|
+| 一级模块 | 功能所属的一级模块名称 | 是 | utils |
+| 二级模块（选填） | 功能所属的二级模块名称 | 否 | commands |
+| 三级模块（选填） | 功能所属的三级模块名称 | 否 | function-point |
+| 四级模块（选填） | 功能所属的四级模块名称 | 否 | - |
+| 功能项描述 | 功能的详细业务描述 | 是 | 新增功能点测算功能 |
+| 功能点计数项名称 | 功能点的计数项名称 | 是 | 新增功能点测算功能_ILF |
+| 类别 | 功能点类型分类 | 是 | 内部逻辑文件（ILF） |
+| 未调整功能点数（UFP） | 根据类别计算的功能点数 | 是 | 10 |
+| 复用程度 | 功能的复用程度 | 是 | 低 |
+| 修改类型 | 功能的修改类型 | 是 | 新增 |
+| 关联人 | 功能关联的责任人 | 是 | 50632783 |
+
+## 🎯 功能点分类规则
+
+### 内部逻辑文件（ILF）- 10点
+- 新增界面或模块
+- 创建核心业务对象
+- 实现完整功能模块
+- 添加新页面或视图
+
+### 外部查询（EQ）- 4点
+- 数据查询操作
+- 报表导出功能
+- 条件筛选功能
+- 搜索相关功能
+
+### 外部输入（EI）- 4点
+- 数据修改操作
+- 记录删除功能
+- 信息更新功能
+- 内容编辑功能
+
+### 外部输出（EO）- 5点
+- 复杂数据处理和输出
+- 带计算功能的结果输出
+- 综合报告生成
+
+## 🔧 实现原理
+
+### 工程类型识别
+通过检查以下文件来识别项目类型：
+- `package.json` → Node.js
+- `pom.xml` → Java
+- `requirements.txt` → Python
+- `Cargo.toml` → Rust
+- `go.mod` → Go
+- `Gemfile` → Ruby
+
+### 模块层级提取
+从文件路径中提取模块层级信息：
+```
+src/utils/commands/function-point.ts
+├── 一级模块: utils
+├── 二级模块: commands
+└── 三级模块: function-point
+```
+
+### 功能点模式匹配
+通过正则表达式匹配提交消息中的关键词来识别功能点类型：
+- ILF: `新增.*界面`、`创建.*模块`、`实现.*功能`
+- EQ: `查询.*数据`、`导出.*报表`、`筛选.*条件`
+- EI: `修改.*数据`、`删除.*记录`、`更新.*信息`
+
+## 📈 使用示例
+
+### 示例1：基本功能点测算
+```
+启动功能点测算智能体
+```
+
+### 示例2：分析最近6个月的数据
+```
+/功能点测算 --months 6
+```
+
+### 示例3：输出示例结果
+```
+🔍 正在识别工程信息...
+✅ 工程识别完成:
+   项目名称: aico-cli
+   项目类型: Node.js
+
+📊 正在分析近3个月的Git提交记录...
+📈 正在分析功能点...
+✅ 2025-10: 分析 11 个提交，识别 3 个功能点
+✅ 2025-09: 分析 58 个提交，识别 31 个功能点
+✅ 2025-08: 分析 33 个提交，识别 28 个功能点
+
+✅ 功能点分析完成！
+   总计识别: 62 个功能点
+   输出目录: .aico/功能点
+
+📊 功能点统计摘要:
+   总计功能点: 62
+   按类型分布:
+     内部逻辑文件（ILF）: 62
+   按月份分布:
+     10月: 3
+     9月: 31
+     8月: 28
+   按模块分布:
+     utils: 18
+     commands: 10
+     cli-setup: 17
+```
+
+## ⚡ 性能优化
+
+### 缓存机制
+- Git提交记录缓存，避免重复查询
+- 功能点分析结果缓存，提高效率
+
+### 并行处理
+- 多线程处理月份分组
+- 并行生成CSV文件
+
+### 内存优化
+- 流式处理大量提交记录
+- 分批处理功能点分析
+
+## 🛠️ 依赖要求
+
+### 系统要求
+- Git (命令行工具)
+- Node.js (用于运行环境)
+- 足够的磁盘空间存储CSV文件
+
+### 项目要求
+- 必须是Git仓库
+- 有规范的提交消息格式
+- 明确的模块目录结构
+
+## 🚨 注意事项
+
+1. **数据准确性**：功能点识别基于提交消息的关键词匹配，建议团队保持规范的提交消息格式
+2. **内存使用**：大型项目可能产生大量提交记录，建议适当调整分析的时间范围
+3. **权限要求**：确保有读取Git记录和写入`.aico`目录的权限
+4. **编码格式**：CSV文件使用UTF-8 with BOM格式，确保Excel正确打开
+
+## 🔄 更新日志
+
+### v1.0.0 (2025-10-17)
+- ✅ 实现基础功能点测算功能
+- ✅ 支持按月份文件夹输出CSV
+- ✅ 添加多项目类型识别
+- ✅ 实现智能模块层级提取
+- ✅ 支持自定义时间范围分析
+
+---
+
+💡 **提示**: 使用前请确保当前目录是Git仓库，并且有规范的提交消息格式，这样可以得到更准确的功能点分析结果。

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

@@ -0,0 +1,456 @@
+#!/usr/bin/env bash
+# 跨平台兼容性测试脚本 - Bash 版本
+# 验证 Windows/Linux/macOS 环境下的功能完整性
+
+set -euo pipefail
+
+# 测试结果统计
+declare -a TEST_RESULTS
+PASSED_TESTS=0
+FAILED_TESTS=0
+
+# 颜色配置
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+WHITE='\033[1;37m'
+GRAY='\033[0;37m'
+NC='\033[0m' # No Color
+
+# 日志函数
+log_message() {
+    local level="$1"
+    local message="$2"
+    local color="${3:-$WHITE}"
+    local timestamp=$(date '+%Y-%m-%d %H:%M:%S')
+    echo -e "${color}[$timestamp] [$level] $message${NC}"
+}
+
+# 测试结果记录
+add_test_result() {
+    local test_name="$1"
+    local passed="$2"
+    local message="${3:-}"
+
+    local timestamp=$(date '+%Y-%m-%d %H:%M:%S')
+    TEST_RESULTS+=("$test_name|$passed|$message|$timestamp")
+
+    if [ "$passed" = "true" ]; then
+        log_message "PASS" "✅ $test_name - PASSED" "$GREEN"
+        ((PASSED_TESTS++))
+    else
+        log_message "FAIL" "❌ $test_name - FAILED - $message" "$RED"
+        ((FAILED_TESTS++))
+    fi
+}
+
+# 获取脚本目录
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# 1. 环境检测测试
+test_environment() {
+    log_message "TEST" "🔍 开始环境检测测试..." "$CYAN"
+
+    # 加载工具库
+    if [ -f "$SCRIPT_DIR/crossplatform-utils.sh" ]; then
+        # shellcheck source=/dev/null
+        source "$SCRIPT_DIR/crossplatform-utils.sh"
+        add_test_result "Bash 工具库加载" "true"
+    else
+        add_test_result "Bash 工具库加载" "false" "找不到工具库文件"
+        return 1
+    fi
+
+    # 平台检测
+    local platform=$(detect_platform)
+    if [[ "$platform" =~ ^(windows|linux|macos|unknown)$ ]]; then
+        add_test_result "平台检测功能" "true" "检测到: $platform"
+    else
+        add_test_result "平台检测功能" "false" "未知平台: $platform"
+    fi
+
+    # Bash 版本检测
+    local bash_version=$(bash --version | head -n1)
+    add_test_result "Bash 版本检测" "true" "版本: $bash_version"
+
+    # 检查关键命令
+    local missing_commands=()
+    for cmd in sed grep find head tail mkdir cat echo; do
+        if command_exists "$cmd"; then
+            continue
+        else
+            missing_commands+=("$cmd")
+        fi
+    done
+
+    if [ ${#missing_commands[@]} -eq 0 ]; then
+        add_test_result "关键命令检查" "true" "所有必要命令可用"
+    else
+        add_test_result "关键命令检查" "false" "缺少: ${missing_commands[*]}"
+    fi
+}
+
+# 2. 跨平台工具函数测试
+test_crossplatform_utils() {
+    log_message "TEST" "🔧 测试跨平台工具函数..." "$CYAN"
+
+    # 临时目录测试
+    local temp_dir=$(get_temp_dir)
+    if [ -d "$temp_dir" ]; then
+        add_test_result "临时目录获取" "true" "路径: $temp_dir"
+    else
+        add_test_result "临时目录获取" "false" "临时目录不存在: $temp_dir"
+    fi
+
+    # 家目录测试
+    local home_dir=$(get_home_dir)
+    if [ -d "$home_dir" ]; then
+        add_test_result "家目录获取" "true" "路径: $home_dir"
+    else
+        add_test_result "家目录获取" "false" "家目录不存在: $home_dir"
+    fi
+
+    # 路径标准化测试
+    local test_path="src/components/test.js"
+    local normalized=$(normalize_path "$test_path")
+    local platform=$(detect_platform)
+
+    if [ "$platform" = "windows" ] && [[ "$normalized" == *\\* ]]; then
+        add_test_result "路径标准化" "true" "标准化: $normalized"
+    elif [ "$platform" != "windows" ] && [ "$normalized" = "$test_path" ]; then
+        add_test_result "路径标准化" "true" "标准化: $normalized"
+    else
+        add_test_result "路径标准化" "false" "标准化失败: $test_path -> $normalized"
+    fi
+
+    # 文件操作测试
+    local test_dir="$temp_dir/aico-test-$$"
+    local test_file="$test_dir/test.txt"
+
+    # 创建目录
+    if safe_mkdir "$test_dir" && [ -d "$test_dir" ]; then
+        add_test_result "目录创建" "true"
+    else
+        add_test_result "目录创建" "false" "无法创建: $test_dir"
+    fi
+
+    # 写入文件
+    echo "测试内容" > "$test_file"
+    if [ -f "$test_file" ]; then
+        add_test_result "文件创建" "true"
+    else
+        add_test_result "文件创建" "false" "无法创建: $test_file"
+    fi
+
+    # 读取文件
+    local content=$(safe_read_file "$test_file" 5)
+    if [[ "$content" == *"测试内容"* ]]; then
+        add_test_result "文件读取" "true"
+    else
+        add_test_result "文件读取" "false" "内容读取失败"
+    fi
+
+    # 复制文件
+    local copied_file="$test_dir/test-copy.txt"
+    if safe_cp "$test_file" "$copied_file" && [ -f "$copied_file" ]; then
+        add_test_result "文件复制" "true"
+    else
+        add_test_result "文件复制" "false" "复制失败"
+    fi
+
+    # 删除文件
+    if safe_rm "$test_file" && [ ! -f "$test_file" ]; then
+        add_test_result "文件删除" "true"
+    else
+        add_test_result "文件删除" "false" "删除失败"
+    fi
+
+    # 清理测试目录
+    if safe_rmdir "$test_dir" && [ ! -d "$test_dir" ]; then
+        add_test_result "目录删除" "true"
+    else
+        add_test_result "目录删除" "false" "删除失败: $test_dir"
+    fi
+}
+
+# 3. 需求功能库测试
+test_requirement_functions() {
+    log_message "TEST" "📋 测试需求功能库..." "$CYAN"
+
+    # 加载需求功能库
+    if [ -f "$SCRIPT_DIR/requirement-functions-crossplatform.sh" ]; then
+        # shellcheck source=/dev/null
+        source "$SCRIPT_DIR/requirement-functions-crossplatform.sh"
+        add_test_result "需求功能库加载" "true"
+    else
+        add_test_result "需求功能库加载" "false" "找不到功能库文件"
+        return 1
+    fi
+
+    # 模块识别测试
+    local modules=$(identify_project_modules)
+    add_test_result "项目模块识别" "true" "检测到: $modules"
+
+    # 用户输入收集测试
+    collect_context "测试用户需求：需要开发登录功能"
+    if [ "$USER_INPUT" = "测试用户需求：需要开发登录功能" ]; then
+        add_test_result "用户输入收集" "true"
+    else
+        add_test_result "用户输入收集" "false" "输入不匹配: $USER_INPUT"
+    fi
+
+    # 意图分析测试
+    analyze_requirement "需要修复登录页面的bug"
+    if [ -n "$INTENT_TYPE" ]; then
+        add_test_result "意图分析" "true" "识别类型: $INTENT_TYPE"
+    else
+        add_test_result "意图分析" "false" "未能识别意图类型"
+    fi
+
+    # 需求提取测试
+    extract_requirements "作为用户我需要能够登录系统以便访问我的个人信息"
+    if [ -n "$ROLE" ] || [ -n "$GOAL" ]; then
+        add_test_result "需求要素提取" "true" "角色:$ROLE, 目标:$GOAL"
+    else
+        add_test_result "需求要素提取" "false" "未能提取需求要素"
+    fi
+}
+
+# 4. 启动器测试
+test_launcher() {
+    log_message "TEST" "🚀 测试启动器功能..." "$CYAN"
+
+    local launcher_script="$SCRIPT_DIR/requirement-launcher.sh"
+
+    # 启动器文件存在性测试
+    if [ -f "$launcher_script" ]; then
+        add_test_result "启动器文件存在" "true"
+    else
+        add_test_result "启动器文件存在" "false" "找不到: $launcher_script"
+        return 1
+    fi
+
+    # 设置执行权限
+    if command_exists "chmod"; then
+        chmod +x "$launcher_script"
+        add_test_result "启动器执行权限" "true"
+    else
+        add_test_result "启动器执行权限" "false" "无法设置权限"
+    fi
+
+    # 启动器帮助测试
+    local help_result
+    help_result=$("$launcher_script" --help 2>&1 || true)
+    if [[ "$help_result" == *"使用方法"* ]] || [[ "$help_result" == *"usage"* ]]; then
+        add_test_result "启动器帮助功能" "true"
+    else
+        add_test_result "启动器帮助功能" "false" "帮助输出异常"
+    fi
+
+    # 启动器版本测试
+    local version_result
+    version_result=$("$launcher_script" --version 2>&1 || true)
+    if [[ "$version_result" == *"v"* ]] || [[ "$version_result" == *"version"* ]]; then
+        add_test_result "启动器版本信息" "true"
+    else
+        add_test_result "启动器版本信息" "false" "版本输出异常"
+    fi
+}
+
+# 5. 跨平台兼容性测试
+test_platform_specific() {
+    log_message "TEST" "🌐 测试平台特定功能..." "$CYAN"
+
+    local platform=$(detect_platform)
+
+    case "$platform" in
+        "windows")
+            # Windows 特定测试
+            if command_exists "cmd"; then
+                local test_result
+                test_result=$(cmd /c "echo CMD_TEST_SUCCESS" 2>/dev/null || true)
+                if [[ "$test_result" == *"CMD_TEST_SUCCESS"* ]]; then
+                    add_test_result "CMD 兼容性" "true"
+                else
+                    add_test_result "CMD 兼容性" "false" "CMD 执行失败"
+                fi
+            else
+                add_test_result "CMD 兼容性" "false" "CMD 命令不可用"
+            fi
+
+            if [ -n "${USERNAME:-}" ]; then
+                add_test_result "Windows 用户环境" "true" "用户: $USERNAME"
+            else
+                add_test_result "Windows 用户环境" "false" "无法获取用户名"
+            fi
+            ;;
+
+        "linux"|"macos")
+            # Unix 特定测试
+            if command_exists "uname"; then
+                local os_info
+                os_info=$(uname -a 2>/dev/null || echo "unknown")
+                add_test_result "Unix 系统信息" "true" "$os_info"
+            else
+                add_test_result "Unix 系统信息" "false" "uname 命令不可用"
+            fi
+
+            if command_exists "whoami"; then
+                local current_user
+                current_user=$(whoami 2>/dev/null || echo "unknown")
+                add_test_result "Unix 用户信息" "true" "当前用户: $current_user"
+            else
+                add_test_result "Unix 用户信息" "false" "whoami 命令不可用"
+            fi
+            ;;
+
+        *)
+            add_test_result "平台特定功能" "false" "未知平台: $platform"
+            ;;
+    esac
+
+    # 通用进程检查测试
+    local shell_process
+    if command_exists "ps"; then
+        shell_process=$(ps aux | grep -v grep | grep -q "bash" && echo "true" || echo "false")
+    else
+        shell_process=$(check_process "bash" && echo "true" || echo "false")
+    fi
+
+    add_test_result "进程检查功能" "$shell_process" "Bash 进程运行: $shell_process"
+
+    # 通用端口检查测试
+    local port_80_in_use
+    if command_exists "lsof"; then
+        lsof -i ":80" >/dev/null 2>&1 && port_80_in_use="true" || port_80_in_use="false"
+    elif command_exists "netstat"; then
+        netstat -an | grep ":80 " >/dev/null 2>&1 && port_80_in_use="true" || port_80_in_use="false"
+    else
+        port_80_in_use=$(check_port 80 && echo "true" || echo "false")
+    fi
+
+    add_test_result "端口检查功能" "true" "端口80使用状态: $port_80_in_use"
+}
+
+# 主测试流程
+start_tests() {
+    log_message "START" "🧪 开始跨平台兼容性测试..." "$YELLOW"
+    log_message "INFO" "Platform: $(detect_platform)" "$CYAN"
+    log_message "INFO" "Bash: $BASH_VERSION" "$CYAN"
+    log_message "INFO" "脚本目录: $SCRIPT_DIR" "$CYAN"
+    echo
+
+    try {
+        # 执行测试套件
+        test_environment
+        test_crossplatform_utils
+        test_requirement_functions
+        test_launcher
+        test_platform_specific
+
+    } catch {
+        log_message "ERROR" "❌ 测试过程中发生未处理的异常: $_" "$RED"
+        add_test_result "测试执行完整性" "false" "未处理异常: $_"
+    }
+
+    # 生成测试报告
+    generate_test_report
+}
+
+# 生成测试报告
+generate_test_report() {
+    echo
+    log_message "REPORT" "📊 生成测试报告..." "$CYAN"
+
+    local total_tests=$((PASSED_TESTS + FAILED_TESTS))
+    local success_rate
+    if [ "$total_tests" -gt 0 ]; then
+        success_rate=$(awk "BEGIN {printf \"%.2f\", ($PASSED_TESTS / $total_tests) * 100}")
+    else
+        success_rate=0
+    fi
+
+    # 控制台报告
+    echo -e "${GRAY}═══════════════════════════════════════════════════════════════${NC}"
+    echo -e "${WHITE}                    跨平台兼容性测试报告${NC}"
+    echo -e "${GRAY}═══════════════════════════════════════════════════════════════${NC}"
+    echo -e "${CYAN}平台: $(detect_platform)${NC}"
+    echo -e "${CYAN}Bash: $BASH_VERSION${NC}"
+    echo -e "${CYAN}测试时间: $(date '+%Y-%m-%d %H:%M:%S')${NC}"
+    echo
+    echo -e "${YELLOW}测试统计:${NC}"
+    echo -e "  ${GREEN}✅ 通过: $PASSED_TESTS${NC}"
+    echo -e "  ${RED}❌ 失败: $FAILED_TESTS${NC}"
+    if [ "$FAILED_TESTS" -gt 0 ]; then
+        if (( $(echo "$success_rate >= 80" | bc -l) )); then
+            success_color="$GREEN"
+        elif (( $(echo "$success_rate >= 60" | bc -l) )); then
+            success_color="$YELLOW"
+        else
+            success_color="$RED"
+        fi
+        echo -e "  ${success_color}📊 成功率: $success_rate%${NC}"
+    fi
+    echo
+
+    # 详细结果
+    if [ "$FAILED_TESTS" -gt 0 ]; then
+        echo -e "${RED}失败测试详情:${NC}"
+        for result in "${TEST_RESULTS[@]}"; do
+            IFS='|' read -r name passed message timestamp <<< "$result"
+            if [ "$passed" = "false" ]; then
+                echo -e "  ${RED}❌ $name: $message${NC}"
+            fi
+        done
+    fi
+
+    echo -e "${GRAY}═══════════════════════════════════════════════════════════════${NC}"
+
+    # 文本报告
+    local temp_dir=$(get_temp_dir)
+    local report_path="$temp_dir/aico-crossplatform-test-report.txt"
+
+    {
+        echo "跨平台兼容性测试报告"
+        echo "====================="
+        echo "平台: $(detect_platform)"
+        echo "Bash: $BASH_VERSION"
+        echo "测试时间: $(date '+%Y-%m-%d %H:%M:%S')"
+        echo ""
+        echo "测试统计:"
+        echo "通过: $PASSED_TESTS"
+        echo "失败: $FAILED_TESTS"
+        echo "成功率: $success_rate%"
+        echo ""
+        echo "详细结果:"
+        for result in "${TEST_RESULTS[@]}"; do
+            IFS='|' read -r name passed message timestamp <<< "$result"
+            echo "$name: $passed - $message"
+        done
+    } > "$report_path"
+
+    log_message "INFO" "📄 详细报告已保存至: $report_path" "$CYAN"
+
+    # 退出代码
+    if [ "$FAILED_TESTS" -eq 0 ]; then
+        echo -e "${GREEN}🎉 所有测试通过！跨平台兼容性良好。${NC}"
+        exit 0
+    else
+        echo -e "${YELLOW}⚠️ 存在 $FAILED_TESTS 个测试失败，请检查相关功能。${NC}"
+        exit 1
+    fi
+}
+
+# 捕获错误
+trap 'echo "❌ 测试脚本出错，行号: $LINENO"' ERR
+
+# 主入口点
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+    try {
+        start_tests
+    } catch {
+        echo -e "${RED}❌ 测试脚本执行失败: $_${NC}"
+        exit 1
+    }
+fi

package/templates/commands/base//344/273/243/347/240/201/345/256/241/346/237/245/346/231/272/350/203/275/344/275/223.md

@@ -1,6 +1,6 @@
 # /code-review
 
-*执行专注的多代理代码审查，仅 surfaced 对使用 AI 工具的独立开发者具有关键性、高影响力的发现。*
+*执行专注的多代理代码审查，仅 surfaced 对使用 AI 工具的开发者具有关键性、高影响力的发现。*
 
 ## 核心理念
 
@@ -23,8 +23,6 @@
 
 ## 自动加载项目上下文：
 @/CLAUDE.md
-@/docs/ai-context/project-structure.md
-@/docs/ai-context/docs-overview.md
 
 
 ## 命令执行
@@ -47,7 +45,7 @@
 
 #### 阅读相关文档
 在分配代理之前，**阅读文档**以了解：
-1. 使用 `/docs/ai-context/docs-overview.md` 识别相关文档
+1. 根据理解的用户意图搜索识别相关文档
 2. 阅读与被审查代码相关的文档：
    - 子系统理解的架构文档
    - 集成点的 API 文档
@@ -166,7 +164,6 @@
   1. 审查自动加载的项目上下文（CLAUDE.md、project-structure.md、docs-overview.md）
   2. 深入专注地分析您分配的覆盖区域
   3. 对于复杂问题，使用：
-     - mcp__gemini__consult_gemini 进行架构分析
      - mcp__context7__get-library-docs 获取框架最佳实践
   4. 与其他覆盖区域交叉引用系统性问题
   5. 仅记录高影响力发现：

package/templates/commands/base//345/212/237/350/203/275/347/202/271/346/265/213/347/256/227.md

@@ -1,29 +1,421 @@
 ---
-name: function-point-test
-description: "输入模块名，根据预设规则测算并输出功能点列表CSV"
+name: function-point-analyzer
+description: "自动识别工程模块并分析Git提交记录，按月份输出功能点统计CSV到子文件夹"
+allowed-tools: Read(**), Write(.aico/功能点/**/*.csv), Bash
+argument-hint: [模块名]
 ---
 
-# 功能点标准分类
-ILF对应10，EI对应4，EO对应4，EQ对应5。
+## 用法
 
-- 内部逻辑文件（ILF）: 10 点（如可停输界面新增）
-- 外部查询（EQ）: 4 点（如可停输界面导出、筛选）
-- 外部输入（EI）: 4 点（如可停输界面删除、修改）
+`/base:功能点测算 [模块名]`
 
-# 规则
+## 自动加载的项目上下文：
+@/CLAUDE.md
 
-严格遵循以下规则：
+## 全生命周期管理
 
-1.  **查询/导出类** -> `外部查询 (EQ)`, 4 点
-2.  **提交/变更类** -> `外部输入 (EI)`, 4 点
-3.  **纯 UI 交互类** -> `内部逻辑文件 (ILF)`, 10 点
-4.  **绝不使用** `功能点标准分类` 以外的类别。
+作为功能点测算的指挥官，统筹整个功能点分析流程，明确各阶段职责和智能体调用关系：
 
-# 任务
+### 🎯 工程识别阶段
+**职责**：检测Git环境，识别项目基础信息
+**执行环节**：步骤1-2
+**调用智能体**：`function-point-analyzer`
+**前置条件**：无
+**输出**：项目名称、项目类型确认信息
 
-为 `<模块名>` 模块生成功能点列表，并输出到 `prd/功能点/结果/<模块名>功能点列表.csv`。
+### 🔍 数据采集阶段
+**职责**：获取Git提交记录，按月份分组
+**执行环节**：步骤3
+**调用智能体**：`function-point-analyzer`
+**前置条件**：工程识别完成
+**输出**：近3个月Git提交记录分组数据
 
-注意：一级模块必须从`可用模块`列表中选取
+### 📊 功能点分析阶段
+**职责**：智能识别功能点类型，提取模块层级
+**执行环节**：步骤4-6
+**调用智能体**：`function-point-analyzer`
+**前置条件**：Git数据采集完成
+**输出**：功能点分类结果、模块层级信息
+
+### 📋 报告生成阶段
+**职责**：生成CSV统计报告，输出分析摘要
+**执行环节**：步骤7-8
+**调用智能体**：`function-point-analyzer`
+**前置条件**：功能点分析完成
+**输出**：`.aico/功能点/`目录下的CSV文件和统计摘要
+
+## 编排说明
+
+**步骤 1**：检查当前目录是否为Git仓库，确认工程环境。
+
+**步骤 2**：根据用户输入和上下文智能识别需要执行的功能点测算流程：
+
+### 智能体调用决策逻辑
+
+**基于用户输入和项目状态的智能路由**：
+
+1. **初始判断**：分析用户输入内容，识别是否包含模块名参数
+2. **环境检查**：验证当前目录是否为Git仓库
+3. **智能路由**：
+   - 如果环境检查通过 → 调用 `function-point-analyzer` 智能体
+   - 如果环境检查失败 → 提示用户"当前目录不是Git仓库，请切换到项目根目录"
+
+4. **执行机制**：`function-point-analyzer` 智能体严格按照本模板的8个标准步骤执行：
+   - 步骤1：工程识别阶段
+   - 步骤2：项目基础信息采集
+   - 步骤3：Git数据批量获取阶段
+   - 步骤4：功能点智能识别阶段
+   - 步骤5：模块层级智能提取阶段
+   - 步骤6：智能属性赋值规则
+   - 步骤7：CSV文件生成阶段
+   - 步骤8：统计分析与输出阶段
+
+5. **输出验证**：确保生成的CSV文件符合格式规范，统计摘要准确完整
+
+### 执行约束
+
+**操作边界**：
+- 📁 **文件操作**：只在 `.aico/功能点/` 目录下创建CSV文件
+- 🔒 **权限控制**：需要读取Git记录和写入文件的权限
+- 🏗️ **架构保护**：保持现有项目结构不变，只进行数据分析和报告生成
+
+**安全防护**：
+- ✅ **输入验证**：对Git提交记录进行安全过滤
+- 🛡️ **数据保护**：不修改任何源代码文件，只进行统计分析
+- ⚠️ **风险预警**：识别潜在的数据解析问题并提前预警
+
+## 流程可视化
+
+```mermaid
+graph TD
+    A[用户输入功能点测算需求] --> B{环境检查}
+    B -->|Git仓库| C[function-point-analyzer]
+    B -->|非Git仓库| D[提示用户切换到项目根目录]
+
+    C --> E[工程识别阶段]
+    E --> F[数据采集阶段]
+    F --> G[功能点分析阶段]
+    G --> H[报告生成阶段]
+    H --> I[输出CSV文件和统计摘要]
+    I --> J[完成]
+```
+
+---
+
+# 🔄 标准执行流程
+
+## 步骤1：工程识别阶段（必须优先执行）
+
+### 🔍 Git环境检测
+**规则**：
+1. 检查当前目录是否为Git仓库
+2. 如果不是Git仓库 → 终止执行并提示用户
+
+**执行命令**：
+```bash
+git rev-parse --is-inside-work-tree
+```
+
+**成功标准**：
+- 返回值为`true`
+- 当前目录存在`.git`目录
+
+---
+
+## 步骤2：项目基础信息采集
+
+### 📋 项目名称识别规则（按优先级）：
+1. **最高优先级**：从`package.json`获取`name`字段
+   ```
+   package.json → package.name字段
+   ```
+2. **次要优先级**：从Git远程URL提取项目名
+   ```
+   git remote get-url origin → 从URL中提取仓库名
+   示例：https://github.com/user/aico-cli → aico-cli
+   ```
+3. **最低优先级**：使用当前目录名
+
+### 🔧 项目类型判定规则：
+```
+文件存在判定逻辑 → 项目类型：
+├── package.json      → Node.js
+├── pom.xml           → Java
+├── requirements.txt  → Python
+├── Cargo.toml        → Rust
+├── go.mod            → Go
+└── Gemfile           → Ruby
+```
+
+### ✅ 信息确认阶段：
+执行完成后必须输出确认信息：
+```
+✅ 工程识别完成:
+   项目名称: <项目名称>
+   项目类型: <项目类型>
+```
+
+---
+
+## 步骤3：Git数据批量获取阶段
+
+### 📅 时间范围计算规则：
+**输入参数**：默认3个月（可通过--months调整）
+**计算逻辑**：
+```javascript
+const startDate = new Date();
+startDate.setMonth(startDate.getMonth() - months);
+// 格式化为 YYYY-MM-DD
+```
+
+### 📊 Git提交记录获取规则：
+**执行命令**：
+```bash
+git log --since="YYYY-MM-DD" --pretty=format:"%H|%ad|%an|%s" --date=short --name-only
+```
+
+**数据字段说明**：
+- `%H`：提交哈希
+- `%ad`：提交日期（YYYY-MM-DD格式）
+- `%an`：作者名称
+- `%s`：提交消息
+
+### 🗂️ 数据分组规则：
+按月份对提交记录进行分组：
+```
+分组键：YYYY-MM格式（如2025-10）
+分组数据：该月份的所有提交记录
+```
+
+---
+
+## 步骤4：功能点智能识别阶段
+
+### 🎯 功能点分类判定规则（严格匹配）：
+
+#### 内部逻辑文件（ILF）- 10点
+**匹配模式**（任一匹配即判定为ILF）：
+```regex
+/新增.*界面/i
+/创建.*模块/i
+/实现.*功能/i
+/添加.*页面/i
+/feat\(.+\):/i
+```
+
+#### 外部查询（EQ）- 4点
+**匹配模式**（任一匹配即判定为EQ）：
+```regex
+/查询.*数据/i
+/导出.*报表/i
+/筛选.*条件/i
+/搜索.*功能/i
+/get.*list/i
+```
+
+#### 外部输入（EI）- 4点
+**匹配模式**（任一匹配即判定为EI）：
+```regex
+/修改.*数据/i
+/删除.*记录/i
+/更新.*信息/i
+/编辑.*内容/i
+/fix\(.+\):/i
+```
+
+#### 外部输出（EO）- 5点
+**匹配模式**（任一匹配即判定为EO）：
+```regex
+/生成.*报告/i
+/输出.*结果/i
+/计算.*统计/i
+/分析.*数据/i
+```
+
+### 📈 默认兜底规则：
+如果提交消息未匹配任何模式，但包含代码文件，则判定为**内部逻辑文件（ILF）- 10点**：
+```javascript
+if (results.length === 0 && files.some(file =>
+  file.endsWith('.ts') || file.endsWith('.js') || file.endsWith('.py')
+)) {
+  // 默认为ILF，10点
+}
+```
+
+---
+
+## 步骤5：模块层级智能提取阶段
+
+### 🏗️ 模块层级提取规则：
+
+#### 优先级1：从文件路径提取（主要来源）
+```
+路径示例：src/utils/commands/function-point.ts
+提取结果：
+├── 一级模块: utils
+├── 二级模块: commands
+├── 三级模块: function-point
+└── 四级模块: (留空)
+```
+
+**处理逻辑**：
+1. 过滤包含`src/`的文件路径
+2. 移除`src/`前缀
+3. 按`/`分割路径组件
+4. 最多提取三个层级的模块信息
+
+#### 优先级2：从提交消息提取（辅助验证）
+**正则表达式**：
+```regex
+/(?:模块|module)[：:]\s*(\w+)/i
+/(?:功能|feature)[：:]\s*(\w+)/i
+/(?:组件|component)[：:]\s*(\w+)/i
+```
+
+---
+
+## 步骤6：智能属性赋值规则
+
+### 🏷️ 功能点计数项命名规则：
+```
+逻辑：提取中文关键词 + 功能点类型简称
+模式：<关键词序列>_<类型>
+
+示例：
+"新增用户管理界面" → 新增用户界面_ILF
+"修复登录验证问题" → 修复登录验证_EI
+"导出订单数据查询" → 导出订单查询_EQ
+```
+
+### 📊 属性赋值标准：
+
+#### 复用程度判定：
+ ```
+ 逻辑：根据功能点类型和描述关键词
+ 内部逻辑文件(ILF) → 低 (新建为主)
+ 外部查询(EQ) → 中 (常见查询模式)
+ 外部输入(EI) → 中 (常见操作模式)
+ 外部输出(EO) → 高 (复杂处理逻辑)
+ ```
+
+#### 修改类型判定：
+ ```
+ 新增/创建/实现 → 新增
+ 修改/调整/优化 → 修改
+ 删除/移除/清理 → 删除
+ 修复/解决/调整 → 修复
+ ```
+
+---
+
+## 步骤7：CSV文件生成阶段
+
+### 📁 目录结构创建规则：
+```
+基础目录：.aico/功能点/
+月份子目录：中文月份名称（1月、2月、3月...）
+文件命名：<项目名>_功能点统计.csv
+```
+
+### 📋 CSV格式规范：
+
+#### 文件格式要求：
+- **文件编码**：UTF-8 with BOM
+- **分隔符**：英文逗号(,)
+- **引号字符**：双引号(")
+- **换行符**：CRLF(\r\n)
+- **文件扩展名**：.csv
+
+#### CSV字段顺序（严格按此顺序）：
+```
+一级模块,二级模块（选填）,三级模块（选填）,四级模块（选填）,
+功能项描述,功能点计数项名称,类别,未调整功能点数（UFP）,
+复用程度,修改类型,关联人
+```
+
+#### 字段处理规则：
+- **一级模块**：必须填写，默认为"核心模块"
+- **二级/三级模块**：可选，无则留空
+- **四级模块**：固定留空
+- **功能项描述**：原始提交消息，需要转义双引号为""
+- **功能点计数项名称**：生成的计数项名称
+- **类别**：功能点类型分类
+- **未调整功能点数**：对应点数（4/5/10）
+- **复用程度**：低/中/高
+- **修改类型**：新增/修改/删除/修复
+- **关联人**：Git提交作者
+
+---
+
+## 步骤8：统计分析与输出阶段
+
+### 📊 统计摘要计算规则：
+
+#### 总体统计：
+- 总计功能点数 = 所有功能点未调整功能点数之和
+- 总计功能点记录数 = 所有功能点记录数量
+
+#### 分类统计：
+- 按类型分组：内部逻辑文件、外部查询、外部输入、外部输出
+- 按月份分组：10月、9月、8月等
+- 按模块分组：utils、commands等一级模块
+
+### 📈 输出格式规范：
+```
+✅ 功能点分析完成！
+   总计识别: <总数> 个功能点
+   输出目录: <输出路径>
+
+📊 功能点统计摘要:
+   总计功能点: <总数>
+   按类型分布:
+     <类型名>: <数量>
+   按月份分布:
+     <月份名>: <数量>
+   按模块分布:
+     <模块名>: <数量>
+```
+
+---
+
+# 🚨 执行约束与错误处理
+
+## ⛔ 必须终止的情况：
+1. 当前目录不是Git仓库
+2. 指定时间范围内无任何提交记录
+3. 无法识别到任何有效的功能点
+
+## ⚠️ 警告但继续执行的情况：
+1. 项目名称无法识别（使用目录名）
+2. 项目类型无法识别（标记为Unknown）
+3. 某些提交无法解析功能点（跳过该提交）
+
+## ✅ 成功标准：
+1. 至少识别到1个有效功能点
+2. 成功创建月份子目录
+3. 成功生成CSV文件
+4. 成功输出统计摘要
+
+---
+
+# 📋 执行检查清单
+
+执行前确保：
+- [ ] 当前目录是Git仓库
+- [ ] 有读取Git记录的权限
+- [ ] 有写入.aico目录的权限
+
+执行中验证：
+- [ ] Git命令执行成功
+- [ ] 提交记录解析正确
+- [ ] 功能点分类准确
+- [ ] 模块层级提取完整
+
+执行后确认：
+- [ ] CSV文件生成成功
+- [ ] 目录结构正确
+- [ ] 数据格式符合规范
+- [ ] 统计摘要准确
 
 # 相关内容
 
@@ -104,7 +496,7 @@ ILF对应10，EI对应4，EO对应4，EQ对应5。
   - 使用模糊笼统词汇的需求
   - 与技术实现相关的描述
 
-## 研发需求规范性描述细则
+## 功能标题和描述细则
 为了规范化录入研发需求，制定该细则，细则针对研发需求的标题及描述制定了描述规则，规则如下：
 研发需求标题描述句式
 触发主体+核心业务对象+精确动作动词+处理逻辑（复杂计算逻辑需要描述）+关联的数据实体（外部）（外部系统获取信息，通过“（外部）”来标识，存在外部接口数据需要描述）
@@ -149,5 +541,63 @@ ILF对应10，EI对应4，EO对应4，EQ对应5。
     ❌ 2025年6月-XX项目开发运维需求
     ❌ 系统优化
     ❌ 开发工业互联网大屏项目
-研发需求质量评分规则
-触发主体（20分）、业务对象（30分）、核心动词（30分）、业务规则（10分）、关联的外部对象（10分），满分100分，缺少一项扣除对应分数
+---
+
+# 📝 完整执行示例
+
+以下是一个完整的功能点测算执行流程示例：
+
+## 输入
+```markdown
+启动功能点测算智能体
+```
+
+## 执行过程
+1. ✅ 检测Git环境 → 成功
+2. ✅ 识别项目信息 → aico-cli, Node.js
+3. ✅ 获取Git记录 → 102个提交，3个月
+4. ✅ 功能点分析 → 识别62个功能点
+5. ✅ CSV生成 → 3个月份文件夹
+6. ✅ 统计摘要 → 完整输出
+
+## 输出
+```
+✅ 工程识别完成:
+   项目名称: aico-cli
+   项目类型: Node.js
+
+📊 正在分析近3个月的Git提交记录...
+📈 正在分析功能点...
+✅ 2025-10: 分析 11 个提交，识别 3 个功能点
+✅ 2025-09: 分析 58 个提交，识别 31 个功能点
+✅ 2025-08: 分析 33 个提交，识别 28 个功能点
+
+✅ 功能点分析完成！
+   总计识别: 62 个功能点
+   输出目录: .aico/功能点
+
+📊 功能点统计摘要:
+   总计功能点: 62
+   按类型分布:
+     内部逻辑文件（ILF）: 62
+   按月份分布:
+     10月: 3
+     9月: 31
+     8月: 28
+   按模块分布:
+     utils: 18
+     commands: 10
+     cli-setup: 17
+```
+
+## 生成文件
+```
+.aico/功能点/
+├── 10月/aico-cli_功能点统计.csv
+├── 9月/aico-cli_功能点统计.csv
+└── 8月/aico-cli_功能点统计.csv
+```
+
+---
+
+**🎯 该智能体严格执行8个步骤的标准化流程，确保功能点测算的准确性和一致性。**