aico-cli 0.2.4 → 0.2.7

package/templates/agents/aico/requirement/task-executor.md

@@ -1,6 +1,6 @@
 ---
 name: task-executor
-description: 任务自动执行智能体，负责具体开发任务的执行
+description: 任务自动执行智能体
 tools: Read, Write, Bash
 color: purple
 ---
@@ -9,6 +9,19 @@ color: purple
 
 遵循"领取-执行-验证-报告"的循环流程，自动执行开发任务清单中的原子任务。
 
+## 🌐 跨平台特性
+
+### 支持的操作系统
+- ✅ **Windows**: Git Bash, Cygwin, WSL, MSYS2
+- ✅ **macOS**: 原生终端, iTerm2
+- ✅ **Linux**: Ubuntu, CentOS, Fedora, Arch 等
+
+### 核心跨平台功能
+- 自动平台检测和环境适配
+- 统一的路径处理和文件操作
+- 兼容的命令执行和错误处理
+- 一致的临时目录和状态管理
+
 ## 主要职责
 
 ### 1. 任务领取与分析
@@ -40,8 +53,21 @@ color: purple
 ### 阶段一：任务队列分析
 
 ```bash
-# 读取任务清单
-cat ".aico/docs/[需求名称]/开发任务清单.md"
+# 读取任务清单 - 跨平台兼容
+source "$(dirname "$0")/../../utils/task-manager.sh"
+
+# 获取可用任务列表
+available_tasks=$(main list ".aico/docs/[需求名称]/开发任务清单.md")
+
+# 选择任务并原子领取
+for task_id in $available_tasks; do
+    if main check-deps ".aico/docs/[需求名称]/开发任务清单.md" "$task_id"; then
+        if main acquire ".aico/docs/[需求名称]/开发任务清单.md" "$task_id"; then
+            echo "成功领取任务: $task_id"
+            break
+        fi
+    fi
+done
 ```
 
 **任务选择逻辑：**
@@ -54,12 +80,19 @@ cat ".aico/docs/[需求名称]/开发任务清单.md"
 
 **环境检查：**
 ```bash
-# 检查项目状态
-git status
-npm ls --depth=0 2>/dev/null || yarn list --depth=0 2>/dev/null
+# 检查项目状态 - 跨平台兼容
+git_safe status
+
+# 分析包管理器状态
+PM=$(detect_package_manager)
+case "$PM" in
+    npm) npm ls --depth=0 2>/dev/null ;;
+    yarn) yarn list --depth=0 2>/dev/null ;;
+    *) echo "使用 $PM 包管理器" ;;
+esac
 
 # 分析涉及文件的当前状态
-find . -name "涉及文件名" | xargs ls -la
+find_files "涉及文件名" 5 | xargs ls -la 2>/dev/null
 ```
 
 **输出执行计划：**
@@ -93,8 +126,8 @@ find . -name "涉及文件名" | xargs ls -la
 
 #### 数据库任务执行
 ```bash
-# 创建数据库迁移文件
-mkdir -p migrations
+# 创建数据库迁移文件 - 跨平台兼容
+safe_mkdir "migrations"
 cat > "migrations/001_add_new_table.sql" << 'EOF'
 CREATE TABLE new_table (
     id BIGINT PRIMARY KEY AUTO_INCREMENT,
@@ -103,14 +136,14 @@ CREATE TABLE new_table (
 );
 EOF
 
-# 验证SQL语法
+# 验证SQL语法 - 跨平台兼容
 # (这里会根据项目使用的数据库类型进行相应验证)
 ```
 
 #### 后端代码任务执行
 ```bash
-# 创建API路由文件
-mkdir -p src/routes
+# 创建API路由文件 - 跨平台兼容
+safe_mkdir "src/routes"
 cat > "src/routes/newEndpoint.ts" << 'EOF'
 import { Router } from 'express';
 import { NewController } from '../controllers/NewController';
@@ -128,7 +161,7 @@ export default router;
 EOF
 
 # 创建控制器文件
-mkdir -p src/controllers
+safe_mkdir "src/controllers"
 cat > "src/controllers/NewController.ts" << 'EOF'
 // 控制器实现代码
 EOF
@@ -136,8 +169,8 @@ EOF
 
 #### 前端组件任务执行
 ```bash
-# 创建组件目录和文件
-mkdir -p "src/components/NewComponent"
+# 创建组件目录和文件 - 跨平台兼容
+safe_mkdir "src/components/NewComponent"
 
 # 创建主组件文件
 cat > "src/components/NewComponent/index.tsx" << 'EOF'
@@ -170,7 +203,7 @@ EOF
 
 #### 类型定义任务执行
 ```bash
-# 创建类型定义文件
+# 创建类型定义文件 - 跨平台兼容
 cat > "src/types/newTypes.ts" << 'EOF'
 export interface NewResource {
   id: number;
@@ -183,25 +216,45 @@ export interface CreateNewResourceRequest {
 }
 EOF
 
-# 更新全局类型导出
+# 更新全局类型导出 - 跨平台兼容
 echo "export * from './newTypes';" >> "src/types/index.ts"
 ```
 
 ### 阶段四：验证与质量检查
 
-**执行验证步骤：**
+**执行验证步骤 - 跨平台兼容：**
 ```bash
 # 语法检查
-npm run lint 2>/dev/null || yarn lint 2>/dev/null || echo "跳过语法检查"
+PM=$(detect_package_manager)
+case "$PM" in
+    npm) npm run lint 2>/dev/null ;;
+    yarn) yarn lint 2>/dev/null ;;
+    *) echo "跳过语法检查 - 包管理器: $PM" ;;
+esac
+
+# 记录验证结果用于最终状态更新
+validation_result=$?
 
 # TypeScript编译检查
-npm run type-check 2>/dev/null || npx tsc --noEmit 2>/dev/null || echo "跳过类型检查"
+case "$PM" in
+    npm) npm run type-check 2>/dev/null ;;
+    yarn) yarn type-check 2>/dev/null ;;
+    *) npx tsc --noEmit 2>/dev/null ;;
+esac
 
 # 单元测试
-npm test 2>/dev/null || yarn test 2>/dev/null || echo "跳过单元测试"
+case "$PM" in
+    npm) npm test 2>/dev/null ;;
+    yarn) yarn test 2>/dev/null ;;
+    *) echo "跳过单元测试" ;;
+esac
 
 # 构建验证
-npm run build 2>/dev/null || yarn build 2>/dev/null || echo "跳过构建验证"
+case "$PM" in
+    npm) npm run build 2>/dev/null ;;
+    yarn) yarn build 2>/dev/null ;;
+    *) echo "跳过构建验证" ;;
+esac
 ```
 
 **验证结果输出：**
@@ -227,12 +280,19 @@ npm run build 2>/dev/null || yarn build 2>/dev/null || echo "跳过构建验证"
 ### 阶段五：执行报告生成
 
 ```bash
-# 更新任务完成报告
+# 更新任务状态 - 跨平台兼容
+if [ "$validation_result" -eq 0 ]; then
+    main complete ".aico/docs/[需求名称]/开发任务清单.md" "$task_id" "成功"
+else
+    main fail ".aico/docs/[需求名称]/开发任务清单.md" "$task_id" "验证失败"
+fi
+
+# 更新任务完成报告 - 跨平台兼容
 cat >> ".aico/docs/[需求名称]/开发任务完成报告.md" << 'EOF'
 
 ## 任务执行报告 - TASK-001
 
-**执行时间**: {current_timestamp}
+**执行时间**: $(get_timestamp)
 **任务状态**: ✅ 完成 / ❌ 失败 / ⏸️ 暂停
 
 ### 📋 执行摘要
@@ -282,8 +342,8 @@ EOF
 
 #### 依赖检查
 ```bash
-# 检查前置任务完成状态
-grep -A 5 "任务状态.*✅ 完成" ".aico/docs/[需求名称]/开发任务完成报告.md"
+# 检查前置任务完成状态 - 跨平台兼容
+grep -A 5 "任务状态.*✅ 完成" ".aico/docs/[需求名称]/开发任务完成报告.md" 2>/dev/null
 ```
 
 #### 并行执行管理
@@ -358,7 +418,7 @@ Property 'newProp' does not exist on type 'ComponentProps'
 
 #### 重试策略
 ```bash
-# 自动重试逻辑
+# 自动重试逻辑 - 跨平台兼容
 for i in {1..3}; do
   if execute_task; then
     echo "任务执行成功"
@@ -372,12 +432,12 @@ done
 
 #### 回滚机制
 ```bash
-# 创建执行前的代码快照
-git add -A
-git commit -m "执行任务前的代码快照 - TASK-001"
+# 创建执行前的代码快照 - 跨平台兼容
+git_safe add -A
+git_safe commit -m "执行任务前的代码快照 - TASK-001"
 
-# 执行失败后的回滚
-git reset --hard HEAD~1
+# 执行失败后的回滚 - 跨平台兼容
+git_safe reset --hard HEAD~1
 echo "已回滚到任务执行前状态"
 ```
 
@@ -398,4 +458,32 @@ echo "已回滚到任务执行前状态"
 - **信息共享**：提供充分的上下文给质量评估智能体
 - **持续优化**：基于执行经验优化后续任务的执行策略
 
-严格按照"一次一个原子任务"的原则执行，确保每个任务的完整性和质量。
+严格按照"一次一个原子任务"的原则执行，确保每个任务的完整性和质量。
+
+## 🌐 跨平台使用说明
+
+### 所有平台通用命令
+```bash
+# 赋予执行权限
+chmod +x task-executor.sh
+
+# 运行任务执行
+./task-executor.sh "执行开发任务"
+```
+
+### Windows 特定示例
+```bash
+# 在 Git Bash 中
+./task-executor.sh "创建用户管理模块"
+```
+
+### 依赖检查
+```bash
+# 检查跨平台工具库
+source "$(dirname "$0")/crossplatform-utils.sh"
+
+# 验证平台支持
+echo "当前平台: $PLATFORM"
+echo "临时目录: $(get_temp_dir)"
+echo "家目录: $(get_home_dir)"
+```

package/templates/agents/aico/requirement/task-splitter-validator.md

@@ -153,13 +153,27 @@ graph TD
 
 ## 📋 详细任务清单
 
+### 任务模板
+- **任务ID**: 任务唯一标识 (e.g., `DB-001`, `BE-001`)
+- **状态**: 待执行 | 执行中 | 已完成 | 失败
+- **优先级**: 🔴 高 | 🟡 中 | 🟢 低
+- **依赖**: 依赖的任务ID列表
+- **执行者**: 领取任务的执行者ID
+- **开始时间**: 任务开始执行的时间
+- **完成时间**: 任务完成或失败的时间
+- **结果**: 成功 | 失败 | [其他]
+
 ### 🗄️ 数据层任务
 
 #### 任务A: 数据库迁移
-**ID**: `DB-001`  
-**优先级**: 🔴 高  
-**依赖**: 无  
-**预估时间**: 30分钟
+- **任务ID**: `DB-001`
+- **状态**: 待执行
+- **优先级**: 🔴 高
+- **依赖**: 无
+- **执行者**:
+- **开始时间**:
+- **完成时间**:
+- **结果**:
 
 **具体操作**：
 1. 创建数据库迁移文件 `migrations/001_add_new_table.sql`

package/templates/commands/aico/requirement.md

@@ -13,7 +13,7 @@ argument-hint: <需求描述>
 作为需求管理的指挥官，统筹整个需求从识别、对齐、拆分到执行的全生命周期：
 
 - 🎯 **需求识别**：深度理解用户意图，生成共识文档
-- 🔄 **需求对齐**：分析现有代码库，制定技术实施方案  
+- 🔄 **需求对齐**：分析现有代码库，制定技术实施方案
 - 📋 **任务拆分**：将需求分解为可执行的原子任务
 - ⚡ **自动执行**：按依赖关系自动执行开发任务
 - ✅ **质量保障**：全程质量评估和验证
@@ -27,9 +27,20 @@ argument-hint: <需求描述>
 ### 阶段判断逻辑
 
 1. **识别阶段**：用户提供新需求描述 → 调用 `requirement-identifier`
-2. **对齐阶段**：存在共识文档但无技术方案 → 调用 `requirement-aligner`  
-3. **拆分阶段**：存在技术方案但无任务清单 → 调用 `task-splitter-validator`
-4. **执行阶段**：存在任务清单且有待执行任务 → 调用 `task-executor`
+   - 必须生成 `.aico/docs/[需求名称]/共识文档.md`
+   - 文档状态必须设置为`待确认`
+   - 必须等待用户确认后，自动更新状态为`已确认`并进入下一阶段
+2. **对齐阶段**：存在共识文档且状态为`已确认`但无技术方案 → 调用 `requirement-aligner`
+   - 必须存在 `.aico/docs/[需求名称]/共识文档.md`并且需求状态为`已确认`
+   - 必须生成 `.aico/docs/[需求名称]/技术对齐方案文档.md`
+   - 文档状态必须设置为`待确认`
+   - 必须等待用户确认后，自动更新状态为`已确认`并进入下一阶段
+3. **拆分阶段**：存在技术方案且状态为`已确认`但无任务清单 → 调用 `task-splitter-validator`
+   - 必须存在 `.aico/docs/[需求名称]/技术对齐方案文档.md`并且状态为`已确认`
+   - 必须生成 `.aico/docs/[需求名称]/开发任务清单.md`
+   - 文档状态必须设置为`待确认`
+   - 必须等待用户确认后，自动更新状态为`已确认`并进入下一阶段
+4. **执行阶段**：存在任务清单且状态为`已确认`且有待执行任务 → 调用 `task-executor`
 5. **验证阶段**：任务执行后需要质量评估 → 调用 `task-executor-validator`
 
 ### 智能体调用参数
@@ -38,19 +49,23 @@ argument-hint: <需求描述>
   - `user_input`: $ARGUMENTS
   - `current_timestamp`: (来自步骤1的时间戳)
   - `project_context`: (当前项目的 CLAUDE.md 信息)
+  - `document_status`: `待确认`
 
 - **requirement-aligner**：
   - `consensus_document_path`: `.aico/docs/[需求名称]/共识文档.md`
   - `current_timestamp`: (来自步骤1的时间戳)
+  - `document_status`: `待确认`
 
 - **task-splitter-validator**：
   - `consensus_document_path`: `.aico/docs/[需求名称]/共识文档.md`
   - `technical_alignment_path`: `.aico/docs/[需求名称]/技术对齐方案文档.md`
   - `current_timestamp`: (来自步骤1的时间戳)
+  - `document_status`: `待确认`
 
 - **task-executor**：
   - `task_list_path`: `.aico/docs/[需求名称]/开发任务清单.md`
   - `current_timestamp`: (来自步骤1的时间戳)
+  - `document_status`: `已确认`
 
 - **task-executor-validator**：
   - `task_list_path`: `.aico/docs/[需求名称]/开发任务清单.md`