aico-cli 0.3.12 → 0.3.14

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

package/templates/commands/base//344/272/247/345/223/201/350/256/276/350/256/241/346/231/272/350/203/275/344/275/223.md

@@ -0,0 +1,106 @@
+---
+description: 基于苹果设计哲学的产品界面设计智能体，生成极简、直观、优雅的HTML界面
+allowed-tools: Read(**), Write(.aico/prd/**/*.html), Edit(.aico/prd/**/*.html)
+argument-hint: <产品需求描述>
+---
+
+## 目标
+
+基于苹果产品设计哲学，为用户描述的产品需求生成高质量的HTML交互界面：
+
+- **极简主义**：去除冗余元素，聚焦核心功能
+- **直观交互**：用户无需学习即可上手
+- **优雅动效**：流畅的过渡和反馈
+- **统一视觉**：一致的色彩、字体和间距
+
+## 苹果设计哲学核心原则
+
+### 1. 极简主义
+- 去除一切不必要的装饰和元素
+- 聚焦核心功能和用户体验
+- 留白空间的艺术性运用
+
+### 2. 直观交互
+- 符合用户心理模型的界面设计
+- 清晰的视觉层次和信息架构
+- 自然的交互流程和反馈机制
+
+### 3. 优雅动效
+- 流畅的页面过渡和状态变化
+- 适度的微交互增强用户体验
+- 性能优先的动画实现
+
+### 4. 统一视觉
+- 苹果设计系统配色方案
+- 标准化的间距和布局系统
+
+## 执行流程
+
+**步骤 1**：分析产品需求，识别核心功能和用户场景
+
+**步骤 2**：应用苹果设计哲学进行界面设计规划
+- 确定信息架构和导航模式
+- 设计视觉层次和交互流程
+- 选择适合的色彩和字体方案
+
+**步骤 3**：生成HTML界面文件
+- 创建符合苹果设计规范的HTML结构
+- 实现响应式布局和优雅动效
+- 确保跨浏览器兼容性
+
+**步骤 4**：输出到项目目录的 `.aico/prd/` 目录
+- 按产品模块组织文件结构
+- 提供预览和修改建议
+
+## HTML生成规范
+
+### 布局系统
+- **网格系统**：12列响应式网格
+- **间距规范**：8px基础单位的间距系统
+- **边距规范**：标准化的页面边距
+
+### 组件规范
+- **按钮**：圆角、阴影、悬停效果
+- **表单**：清晰的标签和输入框
+- **导航**：直观的导航模式和指示器
+- **卡片**：阴影和圆角的卡片设计
+
+## 输出要求
+
+- 在 `.aico/prd/` 目录下生成HTML文件
+- 按产品模块组织文件结构
+- 包含完整的CSS样式和JavaScript交互
+- 提供响应式设计和移动端适配
+- 确保代码质量和可维护性
+
+## 示例输出结构
+
+```
+.aico/prd/
+├── 产品名称/
+│   ├── index.html          # 主界面
+│   ├── components/         # 组件库
+│   │   ├── buttons.html
+│   │   ├── forms.html
+│   │   └── navigation.html
+│   ├── styles/             # 样式文件
+│   │   ├── main.css
+│   │   └── components.css
+│   └── scripts/            # 交互脚本
+│       ├── main.js
+│       └── animations.js
+```
+
+## 质量保证
+
+- **设计一致性**：严格遵循苹果设计规范
+- **代码质量**：语义化HTML、模块化CSS、可维护JavaScript
+- **用户体验**：充分的用户测试和反馈收集
+- **性能优化**：快速加载和流畅交互
+
+## 扩展性考虑
+
+- 支持自定义设计主题
+- 可配置的组件库
+- 模块化的代码结构
+- 易于维护和迭代

package/templates/hooks/README.md

@@ -0,0 +1,265 @@
+# AICO 需求管理 Hook 系统
+
+## 📋 概述
+
+将原有的需求管理脚本重构为基于 Hook 触发的模块化系统，支持需求生命周期的全流程自动化处理。
+
+## 🏗️ 架构设计
+
+```
+templates/hooks/
+├── hooks-config.json             # Hook 配置中心
+├── requirement-processor.sh      # 🔧 主要使用脚本
+├── requirement/                  # Hook 机制
+│   ├── common-utils.sh           # 核心工具库
+│   ├── pre-requirement-identifier.sh
+│   ├── post-requirement-identifier.sh
+│   ├── pre-requirement-aligner.sh
+│   ├── post-requirement-aligner.sh
+│   ├── pre-task-splitter-validator.sh
+│   ├── post-task-splitter-validator.sh
+│   ├── pre-task-executor.sh
+│   ├── post-task-executor.sh
+│   ├── pre-task-executor-validator.sh
+│   └── post-task-executor-validator.sh
+└── ../agents/aico/requirement/   # 🎯 原有核心逻辑
+    ├── crossplatform-utils.sh            # 跨平台工具库
+    └── requirement-functions-crossplatform.sh  # 需求分析算法
+```
+
+## 🚀 使用方法
+
+### 1. 基本需求处理（推荐）
+
+```bash
+# 处理完整需求生命周期
+./templates/hooks/requirement-processor.sh "需要开发一个用户登录功能"
+
+# 查看帮助
+./templates/hooks/requirement-processor.sh --help
+```
+
+### 2. 单独调用 Hook（高级用法）
+
+```bash
+# 需求识别前置处理
+./templates/hooks/requirement/pre-requirement-identifier.sh "需求描述"
+
+# 需求识别后置处理
+./templates/hooks/requirement/post-requirement-identifier.sh "需求描述" "共识文档路径"
+```
+
+### 3. 手动调用原有脚本（兼容性）
+
+原有的核心逻辑仍然保留，可以通过以下方式使用：
+
+```bash
+# 使用原有的跨平台工具库
+source templates/agents/aico/requirement/crossplatform-utils.sh
+
+# 使用原有的需求分析函数
+source templates/agents/aico/requirement/requirement-functions-crossplatform.sh
+```
+
+## 📊 脚本用途说明
+
+### ✅ 有用的脚本（保留）
+
+| 脚本 | 用途 | 是否核心 |
+|------|------|----------|
+| `requirement-processor.sh` | 🎯 **主要使用脚本**，整合所有功能 | ✅ 是 |
+| `common-utils.sh` | Hook 框架核心，日志、状态管理 | ✅ 是 |
+| 10个 `pre/post` hook 脚本 | 生命周期各阶段的前后置处理 | ✅ 是 |
+| `crossplatform-utils.sh` | 跨平台兼容性工具库 | ✅ 是 |
+| `requirement-functions-crossplatform.sh` | 需求分析核心算法 | ✅ 是 |
+| `hooks-config.json` | Hook 配置管理 | ✅ 是 |
+
+### ❌ 已删除的脚本（冗余）
+
+| 原因 | 删除的脚本 |
+|------|------------|
+| 仅用于开发调试 | 所有 `test-*.sh` 脚本 |
+| 被 Hook 机制替代 | `requirement-launcher.sh` |
+
+## 🔄 工作流程
+
+### 完整生命周期流程
+
+1. **需求识别阶段** (`requirement-identifier`)
+   - 前置 Hook: 环境检查、参数验证
+   - 核心逻辑: 需求分析、意图识别
+   - 后置 Hook: 状态更新、摘要生成
+
+2. **需求对齐阶段** (`requirement-aligner`)
+   - 前置 Hook: 技术栈分析、依赖检查
+   - 核心逻辑: 技术方案设计
+   - 后置 Hook: 对齐状态更新
+
+3. **任务拆分阶段** (`task-splitter-validator`)
+   - 前置 Hook: 任务复杂度分析
+   - 核心逻辑: 任务分解、优先级排序
+   - 后置 Hook: 拆分摘要生成
+
+4. **任务执行阶段** (`task-executor`)
+   - 前置 Hook: 执行环境检查
+   - 核心逻辑: 代码实现、单元测试
+   - 后置 Hook: 执行统计汇总
+
+5. **质量验证阶段** (`task-executor-validator`)
+   - 前置 Hook: 验证环境准备
+   - 核心逻辑: 质量检查、集成测试
+   - 后置 Hook: 验证报告生成
+
+## 🎯 最佳实践
+
+### 推荐使用方式
+
+```bash
+# 日常使用 - 一步到位
+./templates/hooks/requirement-processor.sh "功能需求描述"
+
+# 开发调试 - 分步执行
+./templates/hooks/requirement/pre-requirement-identifier.sh "需求"
+# ... 检查前置处理结果 ...
+./templates/hooks/requirement/post-requirement-identifier.sh "需求" "文档"
+
+# 自定义流程 - 组合使用
+source templates/hooks/requirement/common-utils.sh
+execute_hook "pre" "requirement-identifier" "自定义参数"
+```
+
+## 🛠️ 配置管理
+
+### 1. 需求管理 Hook 配置
+
+编辑 `hooks-config.json` 可以：
+
+- 启用/禁用特定 Hook
+- 设置超时时间
+- 配置依赖关系
+- 调整重试策略
+
+```json
+{
+  "hooks": {
+    "requirement-identifier": {
+      "enabled": true,
+      "timeout": 30000,
+      "dependencies": []
+    }
+  }
+}
+```
+
+### 2. Claude Code 语音提醒配置
+
+语音提醒功能需要在 Claude Code 的 `settings.json` 中配置 Hook。使用 `claude-code-hook-config.json` 作为模板：
+
+**部署步骤：**
+
+1. **复制配置文件**
+   ```bash
+   # 将模板配置添加到 Claude Code 配置中
+   cat templates/hooks/claude-code-hook-config.json >> ~/.claude/settings.json
+   ```
+
+2. **或者手动添加配置**
+   在 `~/.claude/settings.json` 的 `hooks` 字段中添加：
+   ```json
+   "hooks": {
+     "UserPromptSubmit": [
+       {
+         "hooks": [
+           {
+             "type": "command",
+             "command": "~/.claude/hooks/notify.sh input"
+           }
+         ]
+       }
+     ],
+     "Stop": [
+       {
+         "hooks": [
+           {
+             "type": "command",
+             "command": "~/.claude/hooks/notify.sh complete"
+           }
+         ]
+       }
+     ],
+     "Notification": [
+       {
+         "hooks": [
+           {
+             "type": "command",
+             "command": "~/.claude/hooks/notify.sh complete"
+           }
+         ]
+       }
+     ]
+   }
+   ```
+
+**功能说明：**
+
+- **UserPromptSubmit**: 当 Claude 需要用户输入时播放提示音
+- **Stop**: 当 Claude 停止工作时播放完成音（退出提醒）
+- **Notification**: 当 Claude 发送通知时播放完成音（任务完成提醒）
+
+**验证配置：**
+
+```bash
+# 测试语音提醒脚本
+~/.claude/hooks/notify.sh input
+~/.claude/hooks/notify.sh complete
+```
+
+**重启 Claude Code** 使配置生效。
+
+## 🔧 扩展开发
+
+### 添加新的 Hook
+
+1. 在对应目录创建 `pre-stage-name.sh` 和 `post-stage-name.sh`
+2. 在 `hooks-config.json` 中添加配置
+3. 更新 `requirement-processor.sh` 中的流程调用
+
+### 自定义处理逻辑
+
+原有脚本的核心逻辑函数可以在 Hook 中直接调用：
+
+```bash
+source ../agents/aico/requirement/requirement-functions-crossplatform.sh
+
+# 在 Hook 中调用原有函数
+analyze_requirement "$user_input"
+generate_consensus_document
+```
+
+## ⚠️ 注意事项
+
+1. **依赖关系**: Hook 严格按照依赖顺序执行
+2. **状态管理**: 每个 Hook 会更新对应的状态文件
+3. **错误处理**: Hook 失败会中断整个流程
+4. **跨平台**: 保持与原有脚本的跨平台兼容性
+
+## 📚 迁移指南
+
+如果你之前使用 `requirement-launcher.sh`，现在可以这样迁移：
+
+### 旧方式
+```bash
+./templates/agents/aico/requirement/requirement-launcher.sh "需求描述"
+```
+
+### 新方式（推荐）
+```bash
+./templates/hooks/requirement-processor.sh "需求描述"
+```
+
+新方式的优势：
+- ✅ 自动 Hook 触发
+- ✅ 更好的状态管理
+- ✅ 更强的错误处理
+- ✅ 模块化架构
+- ✅ 易于扩展

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

@@ -0,0 +1,35 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "hooks": {
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "~/.claude/hooks/notify.sh input"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "~/.claude/hooks/notify.sh complete"
+          }
+        ]
+      }
+    ],
+    "Notification": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "~/.claude/hooks/notify.sh complete"
+          }
+        ]
+      }
+    ]
+  }
+}

package/templates/hooks/hooks-config.json

@@ -0,0 +1,47 @@
+{
+  "version": "1.0.0",
+  "description": "需求管理生命周期 Hook 配置",
+  "hooks": {
+    "requirement-identifier": {
+      "pre": "requirement/pre-requirement-identifier.sh",
+      "post": "requirement/post-requirement-identifier.sh",
+      "dependencies": [],
+      "timeout": 30000,
+      "enabled": true
+    },
+    "requirement-aligner": {
+      "pre": "requirement/pre-requirement-aligner.sh",
+      "post": "requirement/post-requirement-aligner.sh",
+      "dependencies": ["requirement-identifier"],
+      "timeout": 30000,
+      "enabled": true
+    },
+    "task-splitter-validator": {
+      "pre": "requirement/pre-task-splitter-validator.sh",
+      "post": "requirement/post-task-splitter-validator.sh",
+      "dependencies": ["requirement-aligner"],
+      "timeout": 30000,
+      "enabled": true
+    },
+    "task-executor": {
+      "pre": "requirement/pre-task-executor.sh",
+      "post": "requirement/post-task-executor.sh",
+      "dependencies": ["task-splitter-validator"],
+      "timeout": 60000,
+      "enabled": true
+    },
+    "task-executor-validator": {
+      "pre": "requirement/pre-task-executor-validator.sh",
+      "post": "requirement/post-task-executor-validator.sh",
+      "dependencies": ["task-executor"],
+      "timeout": 30000,
+      "enabled": true
+    }
+  },
+  "global": {
+    "maxRetries": 3,
+    "retryDelay": 1000,
+    "logLevel": "info",
+    "tempDir": "/tmp/aico-hooks"
+  }
+}

package/templates/hooks/requirement/common-utils.sh

@@ -0,0 +1,186 @@
+#!/usr/bin/env bash
+# 需求管理 Hook 通用工具库
+
+# 加载跨平台基础工具
+# 计算相对路径
+HOOKS_DIR="$(dirname "$(dirname "${BASH_SOURCE[0]}")")"
+CROSSPLATFORM_UTILS="$HOOKS_DIR/../agents/aico/requirement/crossplatform-utils.sh"
+
+if [ -f "$CROSSPLATFORM_UTILS" ]; then
+    source "$CROSSPLATFORM_UTILS"
+else
+    echo "⚠️  跨平台工具库未找到: $CROSSPLATFORM_UTILS"
+    # 提供基本的兼容函数
+    get_timestamp() { date '+%Y-%m-%d %H:%M:%S'; }
+    safe_mkdir() { mkdir -p "$1"; }
+    safe_rmdir() { rm -rf "$1" 2>/dev/null || true; }
+    get_temp_dir() { echo "/tmp"; }
+fi
+
+# Hook 日志函数
+hook_log() {
+    local level="$1"
+    local message="$2"
+    local timestamp=$(get_timestamp)
+
+    case "$level" in
+        "INFO") echo "[INFO] $timestamp - $message" ;;
+        "WARN") echo "[WARN] $timestamp - $message" >&2 ;;
+        "ERROR") echo "[ERROR] $timestamp - $message" >&2 ;;
+        "DEBUG") echo "[DEBUG] $timestamp - $message" ;;
+        *) echo "[$level] $timestamp - $message" ;;
+    esac
+}
+
+# 检查 Hook 前置条件
+check_hook_prerequisites() {
+    local hook_name="$1"
+    local config_file="$HOOKS_DIR/hooks-config.json"
+
+    if [ ! -f "$config_file" ]; then
+        hook_log "WARN" "Hook 配置文件不存在: $config_file，跳过配置检查"
+        return 0
+    fi
+
+    # 检查 Hook 是否启用
+    if command -v jq >/dev/null 2>&1; then
+        local enabled=$(jq -r ".hooks.\"$hook_name\".enabled" "$config_file" 2>/dev/null)
+        if [ "$enabled" != "true" ]; then
+            hook_log "WARN" "Hook $hook_name 未启用，跳过执行"
+            return 2
+        fi
+    else
+        hook_log "DEBUG" "jq 命令不可用，跳过配置检查"
+    fi
+
+    return 0
+}
+
+# 执行 Hook 脚本
+execute_hook() {
+    local hook_type="$1"  # pre 或 post
+    local hook_name="$2"  # hook 名称
+    local hook_args="${@:3}"  # 额外参数
+
+    local config_file="$HOOKS_DIR/hooks-config.json"
+    local hook_script=""
+
+    if [ -f "$config_file" ] && command -v jq >/dev/null 2>&1; then
+        hook_script=$(jq -r ".hooks.\"$hook_name\".\"$hook_type\"" "$config_file" 2>/dev/null)
+    fi
+
+    # 如果没有配置文件或 jq 不可用，使用默认路径
+    if [ -z "$hook_script" ] || [ "$hook_script" = "null" ]; then
+        hook_script="requirement/$hook_type-$hook_name.sh"
+        hook_log "DEBUG" "使用默认 Hook 路径: $hook_script"
+    fi
+
+    local full_script_path="$HOOKS_DIR/$hook_script"
+
+    if [ ! -f "$full_script_path" ]; then
+        hook_log "ERROR" "Hook 脚本不存在: $full_script_path"
+        return 1
+    fi
+
+    if [ ! -x "$full_script_path" ]; then
+        set_executable "$full_script_path"
+    fi
+
+    hook_log "INFO" "执行 $hook_type hook: $hook_name"
+
+    # 执行 hook 脚本
+    if "$full_script_path" $hook_args; then
+        hook_log "INFO" "Hook $hook_name $hook_type 执行成功"
+        return 0
+    else
+        hook_log "ERROR" "Hook $hook_name $hook_type 执行失败"
+        return 1
+    fi
+}
+
+# 检查依赖关系
+check_dependencies() {
+    local hook_name="$1"
+    local config_file="$(dirname "${BASH_SOURCE[0]}")/../../hooks-config.json"
+
+    local dependencies=$(jq -r ".hooks.\"$hook_name\".dependencies[]" "$config_file" 2>/dev/null)
+
+    for dep in $dependencies; do
+        if [ -n "$dep" ] && [ "$dep" != "null" ]; then
+            # 检查依赖的 hook 是否已成功执行
+            local dep_status_file="$(get_temp_dir)/aico-hooks/$dep.status"
+            if [ ! -f "$dep_status_file" ] || [ "$(cat "$dep_status_file")" != "success" ]; then
+                hook_log "ERROR" "依赖的 hook $dep 未成功执行"
+                return 1
+            fi
+        fi
+    done
+
+    return 0
+}
+
+# 更新 Hook 状态
+update_hook_status() {
+    local hook_name="$1"
+    local status="$2"  # success 或 failed
+
+    local status_dir="$(get_temp_dir)/aico-hooks"
+    safe_mkdir "$status_dir"
+
+    echo "$status" > "$status_dir/$hook_name.status"
+}
+
+# 获取 Hook 状态
+get_hook_status() {
+    local hook_name="$1"
+    local status_file="$(get_temp_dir)/aico-hooks/$hook_name.status"
+
+    if [ -f "$status_file" ]; then
+        cat "$status_file"
+    else
+        echo "unknown"
+    fi
+}
+
+# 清理临时状态
+cleanup_hook_status() {
+    local hook_name="$1"
+    local status_dir="$(get_temp_dir)/aico-hooks"
+
+    safe_rm "$status_dir/$hook_name.status"
+}
+
+# 验证需求文档状态
+validate_requirement_status() {
+    local requirement_name="$1"
+    local expected_status="$2"  # 如 "已确认"
+
+    local doc_dir=".aico/docs/$requirement_name"
+    local status_file="$doc_dir/状态"
+
+    if [ ! -f "$status_file" ]; then
+        hook_log "ERROR" "需求状态文件不存在: $status_file"
+        return 1
+    fi
+
+    local current_status=$(cat "$status_file")
+    if [ "$current_status" != "$expected_status" ]; then
+        hook_log "ERROR" "需求状态不匹配。期望: $expected_status, 实际: $current_status"
+        return 1
+    fi
+
+    return 0
+}
+
+# 初始化 Hook 环境
+init_hook_environment() {
+    export AICO_HOOKS_DIR="$(dirname "${BASH_SOURCE[0]}")/../.."
+    export AICO_HOOKS_TEMP_DIR="$(get_temp_dir)/aico-hooks"
+
+    safe_mkdir "$AICO_HOOKS_TEMP_DIR"
+
+    # 设置日志级别
+    if [ -z "$AICO_HOOKS_LOG_LEVEL" ]; then
+        export AICO_HOOKS_LOG_LEVEL="info"
+    fi
+}