@dommaker/harness 0.13.0 → 0.13.2

package/src/tools/definitions/std/quality/review-spec.yml

@@ -0,0 +1,140 @@
+# review-spec.yml - 审核代码是否符合任务 spec
+# ============================================================================
+# 类型: Agent 执行
+# 用途: 验证实现是否符合任务的验收标准
+# 不是通用代码审查，而是针对 spec 的符合性检查
+# ============================================================================
+
+name: review-spec
+stage: verify
+description: 审核代码是否符合任务 spec
+category: quality
+version: 1.0.0
+
+# Agent 配置
+agent: codex
+temperature: 0.2  # 更低的温度，更严格的审核
+
+# 可用工具
+tools:
+  - file-read
+  - bash
+  - npm-test
+
+# Prompt
+prompt: |
+  你是代码审查专家。请审核实现是否符合任务的验收标准。
+  
+  ## 任务信息
+  
+  **任务 ID**: {{task.id}}
+  **任务名称**: {{task.name}}
+  **任务描述**: {{task.description}}
+  
+  ## 验收标准
+  
+  {{task.acceptance_criteria}}
+  
+  ## 实现信息
+  
+  **修改的文件**: {{implementation.files_changed}}
+  **测试状态**: {{implementation.tests_passed}}
+  **实现说明**: {{implementation.implementation_notes}}
+  
+  **项目路径**: {{project.path}}
+  
+  ## 审核流程
+  
+  **Step 1: 阅读代码**
+  ```bash
+  # 阅读修改的文件
+  cat <file_path>
+  ```
+  
+  **Step 2: 逐条检查验收标准**
+  
+  对于每条验收标准：
+  - 检查代码是否实现
+  - 检查测试是否覆盖
+  - 标记通过/不通过
+  
+  **Step 3: 运行测试**
+  ```bash
+  cd {{project.path}}
+  npm test -- --grep "{{task.name}}"
+  ```
+  
+  **Step 4: 生成审核报告**
+  
+  ## 输出格式
+  
+  请输出以下 JSON 格式：
+  
+  ```json
+  {
+    "passed": true/false,
+    "score": 8,
+    "criteria_results": [
+      {
+        "criterion": "验收标准1",
+        "passed": true,
+        "evidence": "代码位置 + 测试用例"
+      },
+      {
+        "criterion": "验收标准2",
+        "passed": false,
+        "issue": "缺少 xxx 处理",
+        "suggestion": "在 xxx 添加 xxx"
+      }
+    ],
+    "issues": [
+      {
+        "severity": "critical|major|minor",
+        "file": "path/to/file.ts",
+        "line": 42,
+        "description": "问题描述",
+        "suggestion": "修复建议"
+      }
+    ],
+    "summary": "总体评价"
+  }
+  ```
+
+# 输入参数
+inputs:
+  - name: task
+    type: object
+    required: true
+    description: 任务对象（包含验收标准）
+  
+  - name: implementation
+    type: object
+    required: true
+    description: 实现结果（来自 implement-task）
+  
+  - name: project
+    type: object
+    required: true
+    description: 项目上下文
+
+# 输出
+outputs:
+  - name: passed
+    type: boolean
+    description: 是否通过审核
+  
+  - name: score
+    type: integer
+    description: 评分 (0-10)
+  
+  - name: issues
+    type: array
+    description: 发现的问题列表
+  
+  - name: criteria_results
+    type: array
+    description: 每条验收标准的审核结果
+  
+  - name: summary
+    type: string
+    description: 审核总结

package/src/tools/definitions/std/quality/review-task.yml

@@ -0,0 +1,190 @@
+# review-task.yml - 独立任务审查
+# ============================================================================
+# 类型: Agent 执行
+# 用途: 对单个任务进行独立代码审查，不自动修复，只输出审查报告
+# Superpowers: per-task review - 独立外部审查
+# ============================================================================
+
+name: review-task
+stage: verify
+description: |
+  独立审查单个任务的代码变更，不自动修复，只输出审查报告。
+  
+  与 review-code.yml 的区别：
+  - review-code.yml: 自动修复模式，发现问题直接改代码
+  - review-task.yml: 独立审查模式，只输出报告，修复由其他步骤负责
+  
+  这是 Superpowers per-task review 的核心步骤。
+category: quality
+version: 1.0.0
+
+# Agent 配置
+agent: claude-code
+temperature: 0.2  # 低温度，更严谨
+
+# 可用工具（只读）
+tools:
+  - file-read
+  - bash
+  - git-diff
+
+# Prompt
+prompt: |
+  你是资深代码审查专家。请对以下任务的代码变更进行独立审查。
+  
+  ⚠️ **重要：你只需要审查和报告，不需要修复代码。**
+  
+  ## 任务信息
+  
+  **任务 ID**: {{task.id}}
+  **任务名称**: {{task.name}}
+  **任务描述**: {{task.description}}
+  
+  ## 验收标准
+  
+  {{task.acceptance}}
+  
+  ## 代码变更
+  
+  ```diff
+  {{files_diff}}
+  ```
+  
+  ## 修改的文件列表
+  
+  {{files_changed}}
+  
+  ## 审查清单
+  
+  请按以下维度审查，每项给出 0-10 分：
+  
+  ### 1. 功能完整性 (Functionality)
+  - [ ] 是否满足所有验收标准？
+  - [ ] 边界情况是否处理？
+  - [ ] 错误处理是否完善？
+  
+  ### 2. 代码质量 (Code Quality)
+  - [ ] 代码是否清晰易读？
+  - [ ] 命名是否规范？
+  - [ ] 是否有重复代码？
+  
+  ### 3. 测试覆盖 (Testing)
+  - [ ] 是否有对应的测试？
+  - [ ] 测试覆盖率是否足够？
+  - [ ] 测试用例是否有效？
+  
+  ### 4. 安全性 (Security)
+  - [ ] 是否有安全漏洞？
+  - [ ] 敏感数据是否保护？
+  - [ ] 输入是否验证？
+  
+  ### 5. 性能 (Performance)
+  - [ ] 是否有性能问题？
+  - [ ] 资源是否合理使用？
+  - [ ] 是否有潜在瓶颈？
+  
+  ## 输出格式
+  
+  请以 JSON 格式输出审查报告：
+  
+  ```json
+  {
+    "passed": true/false,
+    "score": 85,
+    "summary": "简要评价",
+    "dimensions": {
+      "functionality": {"score": 90, "issues": []},
+      "code_quality": {"score": 85, "issues": [...]},
+      "testing": {"score": 80, "issues": [...]},
+      "security": {"score": 95, "issues": []},
+      "performance": {"score": 90, "issues": []}
+    },
+    "critical_issues": [...],
+    "warnings": [...],
+    "suggestions": [...]
+  }
+  ```
+  
+  ## 评分标准
+  
+  - 90-100: 优秀 (Excellent) - 可以通过
+  - 80-89: 良好 (Good) - 可以通过，有小问题
+  - 70-79: 一般 (Fair) - 建议修复后通过
+  - 60-69: 较差 (Poor) - 必须修复
+  - <60: 不合格 (Failed) - 需要重新开发
+
+# 输入参数
+inputs:
+  - name: task
+    type: object
+    required: true
+    properties:
+      id:
+        type: string
+      name:
+        type: string
+      description:
+        type: string
+      acceptance:
+        type: array
+    description: 任务对象
+  
+  - name: files_changed
+    type: array
+    required: true
+    items:
+      type: string
+    description: 修改的文件列表
+  
+  - name: files_diff
+    type: string
+    description: 代码差异（git diff 输出）
+  
+  - name: project
+    type: object
+    properties:
+      path:
+        type: string
+      tech_stack:
+        type: object
+    description: 项目上下文
+
+# 输出
+outputs:
+  - name: passed
+    type: boolean
+    description: 是否通过审查（score >= 70）
+  
+  - name: score
+    type: number
+    description: 总分 (0-100)
+  
+  - name: summary
+    type: string
+    description: 审查摘要
+  
+  - name: dimensions
+    type: object
+    description: 各维度评分
+  
+  - name: issues
+    type: array
+    description: 发现的问题列表
+    items:
+      type: object
+      properties:
+        severity:
+          type: string
+          enum: [critical, warning, suggestion]
+        file:
+          type: string
+        line:
+          type: number
+        message:
+          type: string
+        suggestion:
+          type: string
+  
+  - name: report
+    type: object
+    description: 完整审查报告

package/src/tools/definitions/std/quality/run-tests.yml

@@ -0,0 +1,80 @@
+# run-tests.yml
+# ============================================================================
+# 类型: Agent 执行
+# 用途: 运行测试并验证结果
+# ============================================================================
+
+name: run-tests
+stage: verify
+description: 运行测试
+category: quality
+version: 2.0.0
+
+# Agent 配置
+agent: codex
+temperature: 0.2
+
+# 可用工具
+tools:
+  - file-read
+  - bash
+
+# Prompt
+prompt: |
+  你是测试工程师。请运行项目的测试套件并报告结果。
+  
+  ## 项目路径
+  
+  {{project_path}}
+  
+  ## 执行步骤
+  
+  **Step 1: 检测测试框架**
+  ```bash
+  cd {{project_path}}
+  cat package.json | grep -E '"jest"|"vitest"|"mocha"|"pytest"' || echo "No test framework found"
+  ```
+  
+  **Step 2: 运行测试**
+  ```bash
+  # 优先使用 npm test
+  npm test -- --passWithNoTests 2>/dev/null || npm run test 2>/dev/null || echo "Tests skipped"
+  ```
+  
+  **Step 3: 检查覆盖率（可选）**
+  ```bash
+  npm run test:coverage 2>/dev/null || echo "No coverage script"
+  ```
+  
+  **Step 4: 输出结果**
+  
+  根据测试结果，输出以下 JSON 格式：
+  ```json
+  {
+    "passed": true/false,
+    "total": 数字,
+    "passed_count": 数字,
+    "failed_count": 数字,
+    "coverage": 百分比或null,
+    "errors": ["错误信息数组"]
+  }
+  ```
+  
+  ## 要求
+  
+  1. 如果测试失败，分析失败原因
+  2. 如果是简单问题（如快照更新），自动修复
+  3. 如果是复杂问题，记录到 errors 数组
+
+# 输入参数
+inputs:
+  - name: project_path
+    type: string
+    required: true
+    description: 项目路径
+
+# 输出
+outputs:
+  - name: results
+    type: object
+    description: 测试结果

package/src/tools/definitions/std/quick/analyze.yml

@@ -0,0 +1,56 @@
+# quick/analyze - 分析快速功能需求
+#
+# 输入：
+#   - project_path: 项目路径
+#   - feature_description: 功能描述
+#
+# 输出：
+#   - analysis: 分析结果
+
+id: quick/analyze
+stage: develop
+name: 分析需求
+description: 快速分析功能需求，确定实现方案
+category: quick
+agent: codex
+
+inputs:
+  project_path:
+    type: string
+    description: 项目路径
+    required: true
+  feature_description:
+    type: string
+    description: 功能描述
+    required: true
+
+outputs:
+  - name: analysis
+    type: object
+    description: 分析结果
+
+prompt: |
+  你是一个快速原型开发专家。请分析以下功能需求。
+  
+  **功能描述**: {{feature_description}}
+  
+  **项目路径**: {{project_path}}
+  
+  **任务**：
+  1. 理解现有项目结构
+  2. 确定需要修改/创建的文件
+  3. 设计简洁的实现方案
+  
+  **输出格式**（JSON）：
+  ```json
+  {
+    "affected_files": ["file1.ts", "file2.ts"],
+    "new_files": ["new-file.ts"],
+    "implementation_plan": "实现计划描述",
+    "estimated_complexity": "low/medium",
+    "dependencies_needed": []
+  }
+  ```
+
+temperature: 0.2
+timeout: 120  # 2 分钟

package/src/tools/definitions/std/quick/implement.yml

@@ -0,0 +1,67 @@
+# quick/implement - 实现快速功能
+#
+# 输入：
+#   - project_path: 项目路径
+#   - analysis: 分析结果
+#   - feature_description: 功能描述
+#
+# 输出：
+#   - implementation: 实现结果
+
+id: quick/implement
+stage: develop
+name: 实现功能
+description: 快速实现功能
+category: quick
+agent: codex
+
+inputs:
+  project_path:
+    type: string
+    description: 项目路径
+    required: true
+  analysis:
+    type: object
+    description: 分析结果
+    required: true
+  feature_description:
+    type: string
+    description: 功能描述
+    required: true
+
+outputs:
+  - name: implementation
+    type: object
+    description: 实现结果
+
+prompt: |
+  你是一个快速原型开发工程师。请根据分析结果实现功能。
+  
+  **功能描述**: {{feature_description}}
+  
+  **分析结果**:
+  ```json
+  {{analysis}}
+  ```
+  
+  **项目路径**: {{project_path}}
+  
+  **要求**：
+  1. 按照分析计划实现
+  2. 保持代码简洁清晰
+  3. 添加必要的错误处理
+  4. 保持与现有代码风格一致
+  
+  **输出格式**（JSON）：
+  ```json
+  {
+    "files_created": ["new-file.ts"],
+    "files_modified": ["existing-file.ts"],
+    "implementation_notes": "实现说明",
+    "api_endpoints": ["/api/health"],
+    "key_functions": ["healthCheck()"]
+  }
+  ```
+
+temperature: 0.1
+timeout: 180  # 3 分钟

package/src/tools/definitions/std/quick/verify.yml

@@ -0,0 +1,71 @@
+# quick/verify - 验证快速功能
+#
+# 输入：
+#   - project_path: 项目路径
+#   - analysis: 分析结果
+#   - implementation: 实现结果
+#
+# 输出：
+#   - verify_result: 验证结果
+
+id: quick/verify
+stage: develop
+name: 验证功能
+description: 验证快速功能实现是否正确
+category: quick
+agent: codex
+
+inputs:
+  project_path:
+    type: string
+    description: 项目路径
+    required: true
+  analysis:
+    type: object
+    description: 分析结果
+    required: true
+  implementation:
+    type: object
+    description: 实现结果
+    required: true
+
+outputs:
+  - name: verify_result
+    type: object
+    description: 验证结果
+
+prompt: |
+  你是一个质量保证工程师。请验证功能实现是否正确。
+  
+  **分析结果**:
+  ```json
+  {{analysis}}
+  ```
+  
+  **实现结果**:
+  ```json
+  {{implementation}}
+  ```
+  
+  **项目路径**: {{project_path}}
+  
+  **验证任务**：
+  1. 检查代码编译是否通过
+  2. 运行相关测试（如果有）
+  3. 验证功能是否按预期工作
+  4. 检查是否引入明显问题
+  
+  **输出格式**（JSON）：
+  ```json
+  {
+    "build_passed": true/false,
+    "tests_passed": true/false,
+    "test_output": "测试输出摘要",
+    "feature_working": true/false,
+    "issues_found": [],
+    "recommendation": "可以提交/需要修复"
+  }
+  ```
+
+temperature: 0.1
+timeout: 120  # 2 分钟

package/src/tools/definitions/std/verification/verify_completion.yml

@@ -0,0 +1,113 @@
+# verify_completion.yml - 验证完成
+# ============================================================================
+# 能力类型: verification（工具型）
+# 来源: Superpowers - verification-before-completion
+# 版本: 2026-03-28 (需手动同步)
+# 执行方式: 纯脚本，执行验证命令
+# 铁律: NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE
+# ============================================================================
+
+name: verify-completion
+stage: verify
+description: 任务完成前验证，运行验证命令并检查结果
+
+iron_law:
+  rule: "NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE"
+  message: "在声明任务完成之前，必须运行验证命令"
+
+input:
+  claim:
+    type: string
+    required: true
+    description: 完成声明（如 "all tests pass"）
+    
+  command:
+    type: string
+    required: true
+    description: 验证命令（如 "npm test"）
+    
+  repo_path:
+    type: path
+    required: true
+    description: 项目路径
+    
+  expected_output:
+    type: string
+    required: false
+    description: 期望输出（可选，用于验证）
+    default: ""
+
+output:
+  verified:
+    type: boolean
+    description: 是否验证通过
+    
+  evidence:
+    type: string
+    description: 验证证据（命令输出）
+    
+  timestamp:
+    type: string
+    description: 验证时间戳
+
+script: |
+  #!/bin/bash
+  set -euo pipefail
+  
+  REPO_PATH="{{repo_path}}"
+  CLAIM="{{claim}}"
+  COMMAND="{{command}}"
+  EXPECTED="{{expected_output}}"
+  
+  cd "$REPO_PATH"
+  
+  TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+  
+  echo "🔍 验证完成声明"
+  echo "  声明: $CLAIM"
+  echo "  命令: $COMMAND"
+  echo "  时间: $TIMESTAMP"
+  echo ""
+  
+  # 执行验证命令
+  echo "▶ 执行验证命令..."
+  if OUTPUT=$(eval "$COMMAND" 2>&1); then
+    echo ""
+    echo "✅ 验证命令执行成功"
+    
+    # 检查期望输出
+    if [ -n "$EXPECTED" ]; then
+      if echo "$OUTPUT" | grep -q "$EXPECTED"; then
+        echo "✅ 输出匹配期望值"
+        VERIFIED="true"
+      else
+        echo "❌ 输出不匹配期望值"
+        echo "  期望: $EXPECTED"
+        echo "  实际: ${OUTPUT:0:200}..."
+        VERIFIED="false"
+      fi
+    else
+      VERIFIED="true"
+    fi
+  else
+    echo ""
+    echo "❌ 验证命令执行失败"
+    echo "  输出: ${OUTPUT:0:500}"
+    VERIFIED="false"
+  fi
+  
+  echo ""
+  echo "--- 验证结果 ---"
+  echo "VERIFIED=$VERIFIED"
+  echo "TIMESTAMP=$TIMESTAMP"
+  
+  if [ "$VERIFIED" = "true" ]; then
+    echo ""
+    echo "🎉 完成声明已验证通过！"
+    echo "  可以安全地声明: $CLAIM"
+  else
+    echo ""
+    echo "⚠️ 完成声明验证失败！"
+    echo "  不应声明: $CLAIM"
+    exit 1
+  fi