@dommaker/harness 0.13.0 → 0.13.2

package/src/tools/definitions/std/development/execute-batch.yml

@@ -0,0 +1,152 @@
+# execute-batch.yml - 批次执行
+# ============================================================================
+# 类型: 动态执行
+# 用途: 执行一批任务，返回执行结果
+# Superpowers: Phase 4 Execute - 分批执行
+# ============================================================================
+
+name: execute-batch
+stage: develop
+description: |
+  执行一批任务，每个任务调用 develop-task 步骤。
+  
+  支持两种执行模式：
+  - sequential: 串行执行，每个任务完成后执行下一个
+  - parallel: 并行执行，所有任务同时执行
+  
+  返回每个任务的执行结果，用于后续 review。
+category: development
+version: 1.0.0
+
+# 输入定义
+inputs:
+  - name: batch
+    type: array
+    required: true
+    description: 本批次任务列表
+    items:
+      type: object
+      properties:
+        id:
+          type: string
+        name:
+          type: string
+        description:
+          type: string
+        acceptance:
+          type: array
+        dependencies:
+          type: array
+  
+  - name: batch_index
+    type: number
+    required: true
+    description: 批次索引（从 0 开始）
+  
+  - name: project
+    type: object
+    required: true
+    properties:
+      path:
+        type: string
+      tech_stack:
+        type: object
+    description: 项目上下文
+  
+  - name: execution_mode
+    type: string
+    enum: [sequential, parallel]
+    default: sequential
+    description: 执行模式（默认串行）
+  
+  - name: previous_outputs
+    type: array
+    description: 前序批次的输出结果
+
+# 输出定义
+outputs:
+  - name: results
+    type: array
+    description: 每个任务的执行结果
+    items:
+      type: object
+      properties:
+        task_id:
+          type: string
+        status:
+          type: string
+          enum: [success, failed, skipped]
+        files_changed:
+          type: array
+        tests_passed:
+          type: boolean
+        commit_hash:
+          type: string
+        error:
+          type: string
+  
+  - name: all_passed
+    type: boolean
+    description: 所有任务是否都成功
+  
+  - name: success_count
+    type: number
+    description: 成功任务数
+  
+  - name: failed_count
+    type: number
+    description: 失败任务数
+  
+  - name: failed_tasks
+    type: array
+    description: 失败的任务列表
+    items:
+      type: object
+
+# 执行配置
+execute:
+  type: dynamic
+  step_template:
+    step: development/develop-task
+    inputs:
+      task: "${task}"
+      project: "${inputs.project}"
+      previous_outputs: "${inputs.previous_outputs}"
+  
+  # 执行模式
+  mode: "${inputs.execution_mode}"  # sequential | parallel
+  
+  # 并发控制（parallel 模式）
+  max_concurrent: 3
+  
+  # 失败处理
+  on_failure: continue  # continue | stop
+  
+  # 进度回调
+  on_progress:
+    - event: task.completed
+      action: report
+      message: "任务 ${task.id} 完成"
+
+# 前置条件
+preconditions:
+  - condition: "${inputs.batch.length > 0}"
+    message: "批次不能为空"
+  
+  - condition: "${inputs.project.path != null}"
+    message: "项目路径不能为空"
+
+# 后置处理
+postprocess:
+  - name: aggregate_results
+    description: 汇总执行结果
+    
+  - name: generate_summary
+    description: 生成执行摘要
+    
+  - name: notify_completion
+    condition: "${outputs.all_passed || outputs.failed_count > 0}"
+    message: |
+      批次 {{inputs.batch_index}} 执行完成
+      ✅ 成功: {{outputs.success_count}}
+      ❌ 失败: {{outputs.failed_count}}

package/src/tools/definitions/std/development/fix-issues.yml

@@ -0,0 +1,100 @@
+# fix-issues.yml - 修复 review 发现的问题
+# ============================================================================
+# 类型: Agent 执行
+# 用途: 根据 review 结果修复代码问题
+# ============================================================================
+
+name: fix-issues
+stage: develop
+description: 修复 review 发现的问题
+category: development
+version: 1.0.0
+
+# Agent 配置
+agent: codex
+temperature: 0.3
+
+# 可用工具
+tools:
+  - file-read
+  - file-write
+  - bash
+  - npm-test
+
+# Prompt
+prompt: |
+  你是开发者。请根据代码审查结果修复问题。
+  
+  ## 任务信息
+  
+  **任务 ID**: {{task.id}}
+  **任务名称**: {{task.name}}
+  
+  ## 审核结果
+  
+  **评分**: {{review.score}}/10
+  **是否通过**: {{review.passed}}
+  
+  ## 发现的问题
+  
+  {{review.issues}}
+  
+  ## 验收标准未通过项
+  
+  {{review.criteria_results}}
+  
+  ## 项目路径
+  
+  {{project.path}}
+  
+  ## 修复要求
+  
+  1. **逐个修复问题**：
+     - 按 severity 排序，先修 critical
+     - 每修一个，说明修复方法
+  
+  2. **确保测试通过**：
+     - 修复后运行测试
+     - 如果测试失败，继续修复
+  
+  3. **不要提交代码**：
+     - 本次只修复，不 commit
+     - 等待 re-review 通过后再提交
+  
+  ## 输出
+  
+  修复完成后请报告：
+  1. 修复了哪些问题
+  2. 测试是否通过
+  3. 准备好 re-review
+
+# 输入参数
+inputs:
+  - name: task
+    type: object
+    required: true
+    description: 任务对象
+  
+  - name: review
+    type: object
+    required: true
+    description: review 结果（来自 review-spec）
+  
+  - name: project
+    type: object
+    required: true
+    description: 项目上下文
+
+# 输出
+outputs:
+  - name: fixes_applied
+    type: array
+    description: 应用的修复列表
+  
+  - name: tests_passed
+    type: boolean
+    description: 修复后测试是否通过
+  
+  - name: ready_for_review
+    type: boolean
+    description: 是否准备好 re-review

package/src/tools/definitions/std/development/implement-task.yml

@@ -0,0 +1,124 @@
+# implement-task.yml - 实现单个任务（不 commit）
+# ============================================================================
+# 类型: Agent 执行
+# 用途: 根据任务描述实现功能，但不提交代码
+# 输出: 实现结果，供后续 review
+# ============================================================================
+
+name: implement-task
+stage: develop
+description: 实现单个任务（不提交）
+category: development
+version: 1.0.0
+
+# Agent 配置
+agent: codex
+temperature: 0.3
+
+# 可用工具
+tools:
+  - file-read
+  - file-write
+  - bash
+  - npm-test
+
+# Prompt
+prompt: |
+  你是一个资深开发者。请完成以下开发任务。
+  
+  ## 任务信息
+  
+  **任务 ID**: {{task.id}}
+  **任务名称**: {{task.name}}
+  **任务描述**: {{task.description}}
+  
+  ## 验收标准
+  
+  {{task.acceptance_criteria}}
+  
+  ## 项目上下文
+  
+  **项目**: {{project.name}}
+  **技术栈**: {{project.tech_stack}}
+  **项目路径**: {{project.path}}
+  
+  ## 前置依赖
+  
+  {{previous_outputs}}
+  
+  ## 要求
+  
+  1. **TDD 流程**：
+     - 先写测试，确认测试失败
+     - 实现功能，确认测试通过
+     - 重构（如需要）
+  
+  2. **代码质量**：
+     - 遵循项目现有代码风格
+     - 添加必要的注释
+     - 处理边界情况和错误
+  
+  3. **不要提交代码**：
+     - 本次只实现，不 commit
+     - 等待 review 通过后再提交
+  
+  ## 输出
+  
+  完成后请报告：
+  1. 创建/修改了哪些文件
+  2. 测试是否通过
+  3. 实现的关键逻辑
+
+# 输入参数
+inputs:
+  - name: task
+    type: object
+    required: true
+    properties:
+      id:
+        type: string
+        description: 任务 ID
+      name:
+        type: string
+        description: 任务名称
+      description:
+        type: string
+        description: 任务描述
+      acceptance_criteria:
+        type: array
+        description: 验收标准
+    description: 任务对象
+  
+  - name: project
+    type: object
+    required: true
+    properties:
+      name:
+        type: string
+      tech_stack:
+        type: array
+      path:
+        type: string
+    description: 项目上下文
+  
+  - name: previous_outputs
+    type: array
+    description: 前序任务的输出
+
+# 输出
+outputs:
+  - name: files_changed
+    type: array
+    description: 修改的文件列表
+  
+  - name: tests_passed
+    type: boolean
+    description: 测试是否通过
+  
+  - name: implementation_notes
+    type: string
+    description: 实现说明
+  
+  - name: ready_for_review
+    type: boolean
+    description: 是否准备好 review

package/src/tools/definitions/std/development/review-fix-cycle.yml

@@ -0,0 +1,232 @@
+# review-fix-cycle.yml - Review → Fix 循环
+# ============================================================================
+# 类型: 复合步骤
+# 用途: 对任务执行 review → fix → re-review 循环直到通过
+# Superpowers: per-task review - Review 循环封装
+# ============================================================================
+#
+# 使用场景：
+# - 在工作流中需要重复执行 review → fix 循环
+# - 避免在每个工作流中重复写循环逻辑
+#
+# 输入：任务 + 最大迭代次数
+# 输出：是否通过 + 迭代次数 + 最终分数
+# ============================================================================
+
+name: review-fix-cycle
+stage: develop
+description: |
+  对任务执行 review → fix → re-review 循环，直到通过或达到最大迭代次数。
+  
+  流程：
+  1. Review 任务代码
+  2. 如果通过 → 结束
+  3. 如果未通过 → Fix 问题
+  4. Re-review
+  5. 循环直到通过或达到最大迭代
+  
+  这是 Superpowers per-task review 的循环封装。
+category: development
+version: 1.0.0
+
+# 输入定义
+inputs:
+  - name: task
+    type: object
+    required: true
+    description: 任务对象
+    properties:
+      id:
+        type: string
+      name:
+        type: string
+      description:
+        type: string
+      acceptance:
+        type: array
+  
+  - name: project
+    type: object
+    required: true
+    description: 项目上下文
+    properties:
+      path:
+        type: string
+      tech_stack:
+        type: object
+  
+  - name: max_iterations
+    type: number
+    default: 3
+    description: 最大迭代次数（默认 3 次）
+  
+  - name: pass_threshold
+    type: number
+    default: 70
+    description: 通过阈值（默认 70 分）
+
+# 输出定义
+outputs:
+  - name: passed
+    type: boolean
+    description: 是否最终通过
+  
+  - name: iterations
+    type: number
+    description: 实际迭代次数
+  
+  - name: final_score
+    type: number
+    description: 最终 Review 分数
+  
+  - name: issues_fixed
+    type: array
+    description: 修复的问题列表
+  
+  - name: remaining_issues
+    type: array
+    description: 剩余未解决的问题
+  
+  - name: history
+    type: array
+    description: 每次迭代的记录
+    items:
+      type: object
+      properties:
+        iteration:
+          type: number
+        score:
+          type: number
+        issues_found:
+          type: number
+        issues_fixed:
+          type: number
+
+# 执行配置
+execute:
+  type: composite
+  
+  # 初始状态
+  initial_state:
+    iteration: 0
+    passed: false
+    score: 0
+    history: []
+  
+  # 循环步骤
+  steps:
+    # Step 1: Review
+    - id: review
+      step: quality/review-task
+      inputs:
+        task: "${inputs.task}"
+        files_changed: "${state.current_files || initial_files}"
+        project: "${inputs.project}"
+      outputs:
+        passed: review_passed
+        score: review_score
+        issues: review_issues
+    
+    # Step 2: 检查是否通过
+    - id: check-passed
+      condition: "${steps.review.review_passed == true || steps.review.review_score >= inputs.pass_threshold}"
+      action: set_state
+      state:
+        passed: true
+        final_score: "${steps.review.review_score}"
+      then: break  # 跳出循环
+    
+    # Step 3: 检查是否达到最大迭代
+    - id: check-max-iterations
+      condition: "${state.iteration >= inputs.max_iterations}"
+      action: set_state
+      state:
+        passed: false
+        final_score: "${steps.review.review_score}"
+        remaining_issues: "${steps.review.review_issues}"
+      then: break  # 跳出循环
+    
+    # Step 4: Fix 问题
+    - id: fix-issues
+      step: development/fix-issues
+      inputs:
+        issues: "${steps.review.review_issues}"
+        project: "${inputs.project}"
+        task: "${inputs.task}"
+      outputs:
+        fixes_applied: fixes
+        files_changed: fixed_files
+    
+    # Step 5: 更新状态
+    - id: update-state
+      action: set_state
+      state:
+        iteration: "${state.iteration + 1}"
+        current_files: "${steps.fix-issues.fixed_files}"
+        history: |
+          ${state.history + [{
+            iteration: state.iteration + 1,
+            score: steps.review.review_score,
+            issues_found: steps.review.review_issues.length,
+            issues_fixed: steps.fix-issues.fixes.length
+          }]}
+  
+  # 循环条件
+  loop_condition: "${state.passed == false && state.iteration < inputs.max_iterations}"
+
+# 前置条件
+preconditions:
+  - condition: "${inputs.task.id != null}"
+    message: "任务 ID 不能为空"
+  
+  - condition: "${inputs.max_iterations > 0}"
+    message: "最大迭代次数必须大于 0"
+
+# 后置处理
+postprocess:
+  - name: generate_summary
+    description: 生成执行摘要
+    
+  - name: log_result
+    message: |
+      Review-Fix 循环完成
+      任务: ${inputs.task.id}
+      迭代次数: ${outputs.iterations}/${inputs.max_iterations}
+      最终分数: ${outputs.final_score}
+      结果: ${outputs.passed ? '✅ 通过' : '❌ 未通过'}
+
+# 示例
+example: |
+  ## 在工作流中使用
+  
+  ```yaml
+  - id: develop-with-review
+    step: development/review-fix-cycle
+    inputs:
+      task: "${current_task}"
+      project: "${project}"
+      max_iterations: 3
+      pass_threshold: 70
+    outputs:
+      passed: task_passed
+      final_score: task_score
+  ```
+  
+  ## 输出示例
+  
+  ```json
+  {
+    "passed": true,
+    "iterations": 2,
+    "final_score": 85,
+    "issues_fixed": [
+      {"severity": "warning", "message": "缺少错误处理"},
+      {"severity": "warning", "message": "命名不规范"}
+    ],
+    "remaining_issues": [],
+    "history": [
+      {"iteration": 1, "score": 65, "issues_found": 3, "issues_fixed": 2},
+      {"iteration": 2, "score": 85, "issues_found": 1, "issues_fixed": 1}
+    ]
+  }
+  ```