aico-cli 0.3.20 → 0.4.1

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个步骤的标准化流程，确保功能点测算的准确性和一致性。**

package/templates/hooks/claude-code-hooks.json

@@ -0,0 +1,69 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "if [ \"$OS\" = \"Windows_NT\" ]; then powershell -File \"$env:USERPROFILE/.claude/hooks/scripts/PreToolUse/powershell/command-logger.ps1\"; else ~/.claude/hooks/scripts/PreToolUse/bash/command-logger.sh; fi"
+          }
+        ]
+      },
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "if [ \"$OS\" = \"Windows_NT\" ]; then powershell -File \"$env:USERPROFILE/.claude/hooks/scripts/PreToolUse/powershell/file-protection.ps1\"; else ~/.claude/hooks/scripts/PreToolUse/bash/file-protection.sh; fi"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "if [ \"$OS\" = \"Windows_NT\" ]; then powershell -File \"$env:USERPROFILE/.claude/hooks/scripts/PostToolUse/powershell/code-formatter.ps1\"; else ~/.claude/hooks/scripts/PostToolUse/bash/code-formatter.sh; fi"
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "if [ \"$OS\" = \"Windows_NT\" ]; then powershell -File \"$env:USERPROFILE/.claude/hooks/scripts/UserPromptSubmit/powershell/input-notifier.ps1\"; else ~/.claude/hooks/scripts/UserPromptSubmit/bash/input-notifier.sh; fi"
+          }
+        ]
+      }
+    ],
+    "Notification": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "if [ \"$OS\" = \"Windows_NT\" ]; then powershell -File \"$env:USERPROFILE/.claude/hooks/scripts/Notification/powershell/desktop-notifier.ps1\"; else ~/.claude/hooks/scripts/Notification/bash/desktop-notifier.sh; fi"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "if [ \"$OS\" = \"Windows_NT\" ]; then powershell -File \"$env:USERPROFILE/.claude/hooks/scripts/Stop/powershell/session-summary.ps1\"; else ~/.claude/hooks/scripts/Stop/bash/session-summary.sh; fi"
+          }
+        ]
+      }
+    ]
+  }
+}

package/templates/hooks/notify.ps1

@@ -7,24 +7,12 @@ param(
     [string]$EventType
 )
 
-# Debug logging
-$LogFile = "$env:USERPROFILE\.claude\hooks\notify-ps.log"
-$LogDir = Split-Path $LogFile -Parent
-New-Item -ItemType Directory -Force -Path $LogDir | Out-Null
 
-function Write-Log {
-    param([string]$Message)
-    $Timestamp = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
-    Add-Content -Path $LogFile -Value "${Timestamp}: $Message"
-}
 
 # Get the directory where this script is located
 $ScriptDir = $PSScriptRoot
 $SoundsDir = Join-Path $ScriptDir "sounds"
 
-Write-Log "notify.ps1 called with EventType: $EventType"
-Write-Log "Script directory: $ScriptDir"
-Write-Log "Sounds directory: $SoundsDir"
 
 # Function to play a sound file
 function Play-SoundFile {
@@ -32,22 +20,17 @@ function Play-SoundFile {
 
     # Check if file exists
     if (-not (Test-Path $SoundFile)) {
-        Write-Log "ERROR: Sound file not found: $SoundFile"
         return $false
     }
 
-    Write-Log "Playing sound: $SoundFile"
-
     try {
         # Method 1: Use .NET SoundPlayer (most reliable)
         Add-Type -AssemblyName System.Windows.Forms
         $Sound = New-Object System.Media.SoundPlayer($SoundFile)
         $Sound.PlaySync()
-        Write-Log "Sound played successfully using .NET SoundPlayer"
         return $true
     }
     catch {
-        Write-Log "SoundPlayer failed: $($_.Exception.Message)"
 
         try {
             # Method 2: Use Windows Media Player as fallback
@@ -64,20 +47,16 @@ function Play-SoundFile {
                 $Elapsed += 0.1
             }
             $Player.close()
-            Write-Log "Sound played using Windows Media Player"
             return $true
         }
         catch {
-            Write-Log "Windows Media Player failed: $($_.Exception.Message)"
 
             try {
                 # Method 3: System beep as final fallback
                 [System.Media.SystemSounds]::Beep.Play()
-                Write-Log "System beep played as fallback"
                 return $true
             }
             catch {
-                Write-Log "All audio methods failed"
                 return $false
             }
         }
@@ -87,22 +66,17 @@ function Play-SoundFile {
 # Main script logic
 switch ($EventType) {
     "input" {
-        Write-Log "Input needed event triggered"
         $SoundFile = Join-Path $SoundsDir "input-needed.wav"
         Play-SoundFile $SoundFile
     }
 
     "complete" {
-        Write-Log "Complete event triggered"
         $SoundFile = Join-Path $SoundsDir "complete.wav"
         Play-SoundFile $SoundFile
     }
 
     default {
-        Write-Log "ERROR: Invalid event type: $EventType"
         Write-Host "Usage: .\notify.ps1 {input|complete}"
         exit 1
     }
-}
-
-Write-Log "Script execution completed"
+}