@waoooo/claude-skills 1.0.0

package/skills/task-execute/SKILL.md

@@ -0,0 +1,399 @@
+# Skill: task-execute
+
+## 功能
+
+执行单个开发任务，调用 AI Agent 完成代码开发工作。
+
+## 何时调用
+
+- 步骤 15：执行任务循环中
+- 获取到可执行任务后（无依赖阻塞）
+- 需要 AI Agent 开发代码时
+
+## 输入
+
+- `taskId` - 任务 ID（例如：TASK-001）
+- `jobId` - Job ID（例如：2026-02-10-1520-pricing-system）
+- `tasksPath` - tasks.json 文件路径
+
+## 输出
+
+- 代码变更（文件修改、新增、删除）
+- 执行日志（记录开发过程）
+- 任务状态更新
+
+## 执行步骤
+
+### 1. 读取任务详情
+
+```typescript
+const tasks = JSON.parse(readFile(tasksPath))
+const task = tasks.tasks.find(t => t.taskId === taskId)
+
+if (!task) {
+  throw new Error(`Task ${taskId} not found`)
+}
+
+// 检查任务状态
+if (task.status !== 'pending') {
+  throw new Error(`Task ${taskId} is not pending (current: ${task.status})`)
+}
+
+// 检查依赖
+if (task.blockedBy && task.blockedBy.length > 0) {
+  const blockedTasks = task.blockedBy.filter(id => {
+    const dep = tasks.tasks.find(t => t.taskId === id)
+    return dep && dep.status !== 'completed'
+  })
+  
+  if (blockedTasks.length > 0) {
+    throw new Error(`Task ${taskId} is blocked by: ${blockedTasks.join(', ')}`)
+  }
+}
+```
+
+### 2. 准备任务上下文
+
+```typescript
+const context = {
+  task: {
+    id: task.taskId,
+    title: task.title,
+    description: task.description,
+    type: task.type,
+    priority: task.priority,
+    estimatedHours: task.estimatedHours,
+    subtasks: task.subtasks,
+    verification: task.verification
+  },
+  job: {
+    id: jobId,
+    name: job.name,
+    goal: job.goal
+  },
+  requirements: task.requirements, // 关联的需求
+  capability: task.capability, // 关联的能力
+  dependencies: task.dependencies // 依赖的能力
+}
+```
+
+### 3. 调用 dev-engineer Agent
+
+```typescript
+const prompt = `
+你是一个资深的软件工程师，请完成以下开发任务。
+
+## 任务信息
+
+**任务 ID**: ${context.task.id}
+**任务标题**: ${context.task.title}
+**任务类型**: ${context.task.type}
+**优先级**: ${context.task.priority}
+**预计工时**: ${context.task.estimatedHours}h
+
+## 任务描述
+
+${context.task.description}
+
+## 子任务
+
+${context.task.subtasks.map((st, i) => `${i + 1}. ${st.title}`).join('\n')}
+
+## 验证标准
+
+完成后需要通过以下验证：
+${context.task.verification.map(v => `- ${v}`).join('\n')}
+
+## 相关需求
+
+${context.requirements.map(r => `- ${r.id}: ${r.title}`).join('\n')}
+
+## 依赖能力
+
+${context.dependencies.map(d => `- ${d} (已实现)`).join('\n')}
+
+## 开发要求
+
+1. 遵循项目代码规范
+2. 编写清晰的代码注释（英文）
+3. 确保代码可测试
+4. 完成所有子任务
+5. 满足验证标准
+
+## 请开始开发
+
+请按照以下步骤完成任务：
+1. 分析需求和技术方案
+2. 编写代码实现
+3. 编写测试（如需要）
+4. 运行验证命令
+5. 确认所有子任务完成
+
+开始吧！
+`
+
+// 调用 dev-engineer Agent
+const result = await callAgent('dev-engineer', {
+  prompt: prompt,
+  context: context,
+  workdir: projectPath
+})
+```
+
+### 4. 记录执行日志
+
+```typescript
+const log = {
+  taskId: taskId,
+  jobId: jobId,
+  startedAt: new Date().toISOString(),
+  completedAt: new Date().toISOString(),
+  duration: calculateDuration(startedAt, completedAt),
+  
+  changes: {
+    filesModified: result.filesModified,
+    filesAdded: result.filesAdded,
+    filesDeleted: result.filesDeleted,
+    linesAdded: result.linesAdded,
+    linesDeleted: result.linesDeleted
+  },
+  
+  commits: result.commits,
+  
+  status: 'completed',
+  
+  notes: result.notes
+}
+
+// 保存日志
+writeFile(`exports/jobs/${jobId}/logs/${taskId}.json`, JSON.stringify(log, null, 2))
+```
+
+### 5. 更新任务状态
+
+```typescript
+// 更新 tasks.json 中的任务状态
+task.status = 'completed'
+task.completedAt = new Date().toISOString()
+task.actualHours = calculateActualHours(startedAt, completedAt)
+
+writeFile(tasksPath, JSON.stringify(tasks, null, 2))
+```
+
+## 任务类型处理
+
+### 1. capability-development（能力开发）
+
+```typescript
+// 开发新能力
+// 1. 创建能力目录结构
+// 2. 实现核心功能
+// 3. 编写测试
+// 4. 更新文档
+```
+
+### 2. integration（集成对接）
+
+```typescript
+// 集成现有能力
+// 1. 导入能力模块
+// 2. 配置集成参数
+// 3. 编写适配代码
+// 4. 测试集成
+```
+
+### 3. documentation（文档更新）
+
+```typescript
+// 更新文档
+// 1. 编写能力文档
+// 2. 更新 README
+// 3. 添加示例代码
+// 4. 更新 API 文档
+```
+
+### 4. refactor（重构优化）
+
+```typescript
+// 重构代码
+// 1. 分析现有代码
+// 2. 设计重构方案
+// 3. 逐步重构
+// 4. 确保测试通过
+```
+
+### 5. bugfix（Bug 修复）
+
+```typescript
+// 修复 Bug
+// 1. 复现问题
+// 2. 定位根因
+// 3. 修复代码
+// 4. 添加测试防止回归
+```
+
+## 使用示例
+
+### 示例 1：开发能力任务
+
+```
+Agent 调用 task-execute:
+  输入:
+  - taskId: TASK-001
+  - jobId: 2026-02-10-1520-pricing-system
+  - tasksPath: exports/jobs/2026-02-10-1520-pricing-system/specs/tasks.json
+
+执行:
+  🔧 步骤 1: 读取任务详情
+  ⏳ 任务: TASK-001 - Develop payment-gateway capability
+  ⏳ 类型: capability-development
+  ⏳ 优先级: high
+  ⏳ 预计: 8h
+
+  🔧 步骤 2: 检查依赖
+  ✅ 依赖: auth (已实现)
+  ✅ 依赖: database (已实现)
+  ✅ 无阻塞，可以开始
+
+  🔧 步骤 3: 调用 dev-engineer Agent
+  ⏳ 开发中...
+  
+  📝 子任务进度:
+  ✅ 1. Design payment gateway interface
+  ✅ 2. Implement Stripe integration
+  ✅ 3. Add payment webhook handlers
+  ✅ 4. Write unit tests
+  ✅ 5. Update documentation
+
+  🔧 步骤 4: 运行验证
+  ⏳ 运行: pnpm test:payment-gateway
+  ✅ 测试通过
+  ⏳ 运行: pnpm build
+  ✅ 构建成功
+
+  🔧 步骤 5: 记录日志
+  ✅ 日志已保存: logs/TASK-001.json
+
+显示结果:
+  ✅ 任务完成: TASK-001
+
+  📊 执行统计:
+  - 开始时间: 2026-02-11 03:00:00
+  - 完成时间: 2026-02-11 10:30:00
+  - 实际耗时: 7.5h (预计 8h)
+  
+  📝 代码变更:
+  - 新增文件: 8 个
+  - 修改文件: 3 个
+  - 新增代码: 450 行
+  - 删除代码: 20 行
+  
+  ✅ 验证通过:
+  - pnpm test:payment-gateway ✅
+  - pnpm build ✅
+  
+  💡 下一步:
+  1. 运行 task-verify 进行自动测试
+  2. 更新 OpenSpec tasks.md 状态
+  3. 更新 progress.json
+```
+
+### 示例 2：集成任务
+
+```
+Agent 调用 task-execute:
+  输入:
+  - taskId: TASK-005
+  - jobId: 2026-02-10-1520-pricing-system
+  - tasksPath: exports/jobs/2026-02-10-1520-pricing-system/specs/tasks.json
+
+执行:
+  🔧 步骤 1: 读取任务详情
+  ⏳ 任务: TASK-005 - Integrate pricing with payment-gateway
+  ⏳ 类型: integration
+  ⏳ 优先级: high
+  ⏳ 预计: 4h
+
+  🔧 步骤 2: 检查依赖
+  ✅ 依赖: payment-gateway (已完成 TASK-001)
+  ✅ 依赖: pricing (已实现)
+  ✅ 无阻塞，可以开始
+
+  🔧 步骤 3: 调用 dev-engineer Agent
+  ⏳ 集成中...
+  
+  📝 子任务进度:
+  ✅ 1. Import payment-gateway module
+  ✅ 2. Configure payment settings
+  ✅ 3. Implement payment flow
+  ✅ 4. Add error handling
+  ✅ 5. Write integration tests
+
+  🔧 步骤 4: 运行验证
+  ⏳ 运行: pnpm test:integration
+  ✅ 测试通过
+
+显示结果:
+  ✅ 任务完成: TASK-005
+
+  📊 执行统计:
+  - 实际耗时: 3.5h (预计 4h)
+  
+  📝 代码变更:
+  - 修改文件: 5 个
+  - 新增代码: 180 行
+  
+  💡 下一步:
+  继续执行下一个任务
+```
+
+## 错误处理
+
+### 错误 1：任务被阻塞
+
+```
+❌ 错误: 任务被阻塞
+🔍 原因: TASK-005 依赖 TASK-001，但 TASK-001 未完成
+
+💡 建议:
+1. 先完成 TASK-001
+2. 或选择其他可执行任务
+```
+
+### 错误 2：开发失败
+
+```
+❌ 错误: 开发任务失败
+🔍 原因: 代码编译错误
+
+💡 建议:
+1. 查看错误日志
+2. 修复编译错误
+3. 重新执行任务
+```
+
+### 错误 3：验证失败
+
+```
+❌ 错误: 验证命令失败
+🔍 原因: pnpm test:payment-gateway 失败
+
+💡 建议:
+1. 查看测试失败原因
+2. 修复代码
+3. 重新运行验证
+```
+
+## 注意事项
+
+1. **依赖检查** - 执行前必须检查依赖任务是否完成
+2. **状态管理** - 执行中更新状态为 in-progress
+3. **错误处理** - 失败时回滚状态，记录错误日志
+4. **日志记录** - 详细记录执行过程，便于追溯
+5. **验证确认** - 完成后必须运行验证命令
+
+## 相关文件
+
+- `exports/jobs/<job-id>/specs/tasks.json` - 任务列表
+- `exports/jobs/<job-id>/logs/<task-id>.json` - 执行日志
+- `exports/jobs/<job-id>/specs/progress.json` - 进度跟踪