@waoooo/claude-skills 1.0.0

package/skills/task-verify/SKILL.md

@@ -0,0 +1,407 @@
+# Skill: task-verify
+
+## 功能
+
+自动运行验证命令，测试任务完成质量。
+
+## 何时调用
+
+- 步骤 16：任务执行完成后
+- 需要验证代码质量时
+- 提交代码前的检查
+
+## 输入
+
+- `taskId` - 任务 ID（例如：TASK-001）
+- `jobId` - Job ID（例如：2026-02-10-1520-pricing-system）
+- `verificationPath` - verification.json 文件路径
+
+## 输出
+
+- 测试结果（通过/失败）
+- 测试报告
+- 失败原因（如果失败）
+
+## 执行步骤
+
+### 1. 读取验证规则
+
+```typescript
+const verification = JSON.parse(readFile(verificationPath))
+const tasks = JSON.parse(readFile(tasksPath))
+const task = tasks.tasks.find(t => t.taskId === taskId)
+
+// 获取任务的验证命令
+const taskVerifications = task.verification || []
+
+// 获取全局验证命令
+const globalVerifications = verification.verifications || []
+
+// 合并验证命令
+const allVerifications = [
+  ...taskVerifications.map(cmd => ({
+    id: `TASK-${taskId}-${cmd}`,
+    name: cmd,
+    command: cmd,
+    required: true,
+    runBefore: 'task-complete'
+  })),
+  ...globalVerifications.filter(v => v.runBefore === 'commit' || v.runBefore === 'push')
+]
+```
+
+### 2. 执行验证命令
+
+```typescript
+const results = []
+
+for (const verification of allVerifications) {
+  console.log(`⏳ 运行: ${verification.command}`)
+  
+  try {
+    const result = await executeCommand(verification.command, {
+      cwd: projectPath,
+      timeout: 300000 // 5 分钟超时
+    })
+    
+    results.push({
+      id: verification.id,
+      name: verification.name,
+      command: verification.command,
+      status: 'passed',
+      exitCode: result.exitCode,
+      stdout: result.stdout,
+      stderr: result.stderr,
+      duration: result.duration
+    })
+    
+    console.log(`✅ 通过: ${verification.name}`)
+  } catch (error) {
+    results.push({
+      id: verification.id,
+      name: verification.name,
+      command: verification.command,
+      status: 'failed',
+      exitCode: error.exitCode,
+      stdout: error.stdout,
+      stderr: error.stderr,
+      duration: error.duration,
+      error: error.message
+    })
+    
+    console.log(`❌ 失败: ${verification.name}`)
+    
+    // 如果是必需的验证失败，立即停止
+    if (verification.required) {
+      break
+    }
+  }
+}
+```
+
+### 3. 分析测试结果
+
+```typescript
+const summary = {
+  total: results.length,
+  passed: results.filter(r => r.status === 'passed').length,
+  failed: results.filter(r => r.status === 'failed').length,
+  skipped: results.filter(r => r.status === 'skipped').length
+}
+
+const allPassed = summary.failed === 0
+const hasRequiredFailures = results.some(r => 
+  r.status === 'failed' && 
+  allVerifications.find(v => v.id === r.id)?.required
+)
+```
+
+### 4. 生成测试报告
+
+```typescript
+const report = {
+  taskId: taskId,
+  jobId: jobId,
+  verifiedAt: new Date().toISOString(),
+  status: allPassed ? 'passed' : 'failed',
+  
+  summary: summary,
+  
+  results: results,
+  
+  recommendation: allPassed 
+    ? '所有验证通过，可以继续'
+    : hasRequiredFailures
+      ? '必需验证失败，必须修复'
+      : '部分验证失败，建议修复'
+}
+
+// 保存报告
+writeFile(
+  `exports/jobs/${jobId}/logs/${taskId}-verification.json`,
+  JSON.stringify(report, null, 2)
+)
+```
+
+### 5. 返回结果
+
+```typescript
+return {
+  passed: allPassed,
+  summary: summary,
+  report: report,
+  failedVerifications: results.filter(r => r.status === 'failed')
+}
+```
+
+## 验证类型
+
+### 1. 类型检查
+
+```bash
+pnpm type-check
+# 或
+tsc --noEmit
+```
+
+### 2. 单元测试
+
+```bash
+pnpm test
+# 或
+jest --coverage
+```
+
+### 3. 集成测试
+
+```bash
+pnpm test:integration
+```
+
+### 4. E2E 测试
+
+```bash
+pnpm test:e2e
+```
+
+### 5. 代码检查
+
+```bash
+pnpm lint
+# 或
+eslint src/
+```
+
+### 6. 构建测试
+
+```bash
+pnpm build
+```
+
+### 7. 性能测试
+
+```bash
+pnpm test:performance
+```
+
+### 8. 安全测试
+
+```bash
+pnpm audit
+```
+
+## 使用示例
+
+### 示例 1：全部通过
+
+```
+Agent 调用 task-verify:
+  输入:
+  - taskId: TASK-001
+  - jobId: 2026-02-10-1520-pricing-system
+  - verificationPath: exports/jobs/2026-02-10-1520-pricing-system/specs/verification.json
+
+执行:
+  🔧 步骤 1: 读取验证规则
+  ⏳ 任务验证: 2 个
+  ⏳ 全局验证: 4 个
+  ⏳ 总计: 6 个验证命令
+
+  🔧 步骤 2: 执行验证命令
+  
+  ⏳ 运行: pnpm test:payment-gateway
+  ✅ 通过: Payment Gateway Tests (2.3s)
+  
+  ⏳ 运行: pnpm build
+  ✅ 通过: Build (15.7s)
+  
+  ⏳ 运行: pnpm type-check
+  ✅ 通过: Type Check (3.1s)
+  
+  ⏳ 运行: pnpm test
+  ✅ 通过: Unit Tests (8.5s)
+  
+  ⏳ 运行: pnpm lint
+  ✅ 通过: Lint (1.2s)
+  
+  ⏳ 运行: pnpm audit
+  ✅ 通过: Security Audit (0.8s)
+
+  🔧 步骤 3: 分析结果
+  ✅ 全部通过: 6/6
+
+显示结果:
+  ✅ 验证通过
+
+  📊 测试结果:
+  - 总计: 6 个验证
+  - 通过: 6 个 ✅
+  - 失败: 0 个
+  - 总耗时: 31.6s
+
+  📄 详细报告:
+  - logs/TASK-001-verification.json
+
+  💡 下一步:
+  可以更新 OpenSpec 状态，标记任务完成
+```
+
+### 示例 2：部分失败
+
+```
+Agent 调用 task-verify:
+  输入:
+  - taskId: TASK-002
+  - jobId: 2026-02-10-1520-pricing-system
+  - verificationPath: exports/jobs/2026-02-10-1520-pricing-system/specs/verification.json
+
+执行:
+  🔧 步骤 1-2: 读取规则并执行
+
+  ⏳ 运行: pnpm test:invoice
+  ❌ 失败: Invoice Tests (3.2s)
+  
+  错误信息:
+  FAIL src/invoice/invoice.test.ts
+    ● Invoice › should calculate tax correctly
+      Expected: 120
+      Received: 100
+
+  ⏳ 运行: pnpm build
+  ✅ 通过: Build (14.5s)
+
+  🔧 步骤 3: 分析结果
+  ❌ 部分失败: 1/2
+
+显示结果:
+  ❌ 验证失败
+
+  📊 测试结果:
+  - 总计: 2 个验证
+  - 通过: 1 个 ✅
+  - 失败: 1 个 ❌
+  
+  ❌ 失败的验证:
+  1. Invoice Tests
+     命令: pnpm test:invoice
+     错误: Expected: 120, Received: 100
+     位置: src/invoice/invoice.test.ts
+  
+  📄 详细报告:
+  - logs/TASK-002-verification.json
+
+  💡 下一步:
+  1. 修复测试失败的问题
+  2. 重新运行验证
+  3. 确认通过后再继续
+```
+
+### 示例 3：必需验证失败
+
+```
+Agent 调用 task-verify:
+  输入:
+  - taskId: TASK-003
+  - jobId: 2026-02-10-1520-pricing-system
+  - verificationPath: exports/jobs/2026-02-10-1520-pricing-system/specs/verification.json
+
+执行:
+  🔧 步骤 1-2: 读取规则并执行
+
+  ⏳ 运行: pnpm type-check (必需)
+  ❌ 失败: Type Check (2.1s)
+  
+  错误信息:
+  src/pricing/pricing.ts:42:15 - error TS2345: 
+  Argument of type 'string' is not assignable to parameter of type 'number'.
+
+  ⏹️  停止执行（必需验证失败）
+
+显示结果:
+  ❌ 验证失败（必需）
+
+  📊 测试结果:
+  - 总计: 1 个验证（已停止）
+  - 通过: 0 个
+  - 失败: 1 个 ❌ (必需)
+  
+  ❌ 必需验证失败:
+  1. Type Check (必需)
+     命令: pnpm type-check
+     错误: Type error in src/pricing/pricing.ts:42:15
+     类型: string 不能赋值给 number
+  
+  💡 下一步:
+  必须修复类型错误后才能继续
+```
+
+## 错误处理
+
+### 错误 1：验证命令不存在
+
+```
+❌ 错误: 验证命令不存在
+🔍 原因: package.json 中没有 test:payment-gateway 脚本
+
+💡 建议:
+1. 检查 package.json 的 scripts
+2. 添加缺失的脚本
+3. 或修改 verification.json
+```
+
+### 错误 2：验证超时
+
+```
+❌ 错误: 验证超时
+🔍 原因: pnpm test:e2e 运行超过 5 分钟
+
+💡 建议:
+1. 检查测试是否卡住
+2. 优化测试性能
+3. 或增加超时时间
+```
+
+### 错误 3：环境问题
+
+```
+❌ 错误: 验证环境错误
+🔍 原因: 数据库连接失败
+
+💡 建议:
+1. 检查数据库是否启动
+2. 检查环境变量配置
+3. 确认测试环境正常
+```
+
+## 注意事项
+
+1. **必需验证** - 必需验证失败时立即停止
+2. **超时设置** - 每个验证命令设置合理超时
+3. **并行执行** - 可以并行执行独立的验证命令
+4. **结果缓存** - 缓存验证结果，避免重复执行
+5. **详细日志** - 记录完整的输出，便于调试
+
+## 相关文件
+
+- `exports/jobs/<job-id>/specs/verification.json` - 验证规则
+- `exports/jobs/<job-id>/logs/<task-id>-verification.json` - 验证报告