@dommaker/harness 0.13.0 → 0.13.2

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

@@ -0,0 +1,125 @@
+# implement.yml - 实现进化建议
+# ============================================================================
+# 类型: 进化类步骤
+# 执行方式: Agent 执行
+# 用途: 实现已批准的进化建议
+# 核心理念: 审计 → 实现 → 验证 → 归档
+# ============================================================================
+
+name: implement
+stage: govern
+description: 实现已批准的进化建议
+category: evolution
+version: 1.0.0
+
+# Agent 配置
+agent: codex
+temperature: 0.3
+
+# 可用工具
+tools:
+  - file-read
+  - file-write
+  - bash
+  - git
+
+# 输入定义
+inputs:
+  - name: project_path
+    type: string
+    required: true
+    description: 项目路径
+  
+  - name: evolution_item_id
+    type: string
+    required: true
+    description: 进化建议 ID (EVOL-NNN 或 GAP-YYYYMMDD-NNN)
+  
+  - name: auto_verify
+    type: boolean
+    default: true
+    description: 实现后是否自动验证
+
+# 输出定义
+outputs:
+  - name: status
+    type: string
+    enum: [implemented, failed, needs_review]
+    description: 实现状态
+  
+  - name: changes
+    type: array
+    description: 变更列表
+    items:
+      type: object
+      properties:
+        file:
+          type: string
+        action:
+          type: string
+          enum: [created, modified, deleted]
+        description:
+          type: string
+  
+  - name: verification_result
+    type: object
+    description: 验证结果（如果 auto_verify=true）
+    properties:
+      passed:
+        type: boolean
+      errors:
+        type: array
+  
+  - name: commit_hash
+    type: string
+    description: Git commit hash（如果有提交）
+
+# Prompt 模板
+prompt: |
+  你需要实现一个已批准的进化建议。
+  
+  ## 项目路径
+  {{project_path}}
+  
+  ## 进化建议 ID
+  {{evolution_item_id}}
+  
+  ## 执行步骤
+  
+  1. **加载进化建议**
+     读取 `.agent/evolution-backlog.yml`，找到 ID 对应的建议项
+  
+  2. **分析实现方案**
+     - 查看建议的解决方案
+     - 确认实现范围
+     - 评估影响
+  
+  3. **实施变更**
+     根据建议类型执行相应操作：
+     - add_capability: 创建新的工具/步骤文件
+     - adjust_constraint: 修改约束配置
+     - enhance_context: 更新上下文提供逻辑
+     - fix_workflow: 修复工作流步骤
+     - upgrade_agent: 更新 Agent 配置
+  
+  4. **验证实现**
+     {{#if auto_verify}}
+     - 运行相关测试
+     - 验证功能正常
+     {{/if}}
+  
+  5. **更新状态**
+     - 更新 evolution-backlog.yml 中的状态为 implemented
+     - 记录实现时间和变更内容
+  
+  6. **Git 提交**
+     - 提交变更
+     - commit message 格式: `evolution: 实现进化建议 {evolution_item_id}`
+
+# 元数据
+metadata:
+  author: Agent Studio
+  tags:
+    - evolution
+    - implementation
+    - capability

package/src/tools/definitions/std/evolution/prioritize.yml

@@ -0,0 +1,112 @@
+# prioritize.yml - 进化建议优先级排序
+# ============================================================================
+# 类型: 进化类步骤
+# 执行方式: 内置处理器
+# 用途: 对待处理的进化建议进行优先级排序
+# 核心理念: 严重性 + 影响范围 + 频率 → 优先级
+# ============================================================================
+
+name: prioritize
+stage: govern
+description: 对待处理的进化建议进行优先级排序
+category: evolution
+version: 1.0.0
+
+# 执行配置
+execute:
+  type: builtin
+  handler: evolution/prioritize
+
+# 输入定义
+inputs:
+  project_path:
+    type: string
+    description: 项目路径
+    required: true
+  
+  max_items:
+    type: number
+    description: 最大返回数量
+    default: 10
+  
+  min_severity:
+    type: string
+    description: 最低严重性过滤
+    enum: [low, medium, high, critical]
+    default: medium
+  
+  status_filter:
+    type: array
+    description: 状态过滤
+    default: [open]
+    items:
+      type: string
+      enum: [open, in_review, accepted, rejected, implemented]
+
+# 排序规则
+priority_scoring:
+  severity_weights:
+    critical: 40
+    high: 30
+    medium: 20
+    low: 10
+  
+  frequency_weights:
+    ">0.5": 30      # 高频问题
+    "0.3-0.5": 20   # 中频问题
+    "0.1-0.3": 10   # 低频问题
+    "<0.1": 5       # 偶发问题
+  
+  impact_weights:
+    multiple_workflows: 20
+    single_workflow: 10
+    single_role: 5
+  
+  effort_bonus:
+    low: 10         # 低工作量优先
+    medium: 0
+    high: -10       # 高工作量降权
+
+# 输出定义
+outputs:
+  - name: prioritized_items
+    type: array
+    description: 排序后的进化建议列表
+    items:
+      type: object
+      properties:
+        id:
+          type: string
+        score:
+          type: number
+        rank:
+          type: number
+        gap_report_id:
+          type: string
+        root_cause:
+          type: string
+        title:
+          type: string
+        suggested_solution:
+          type: string
+        estimated_effort:
+          type: string
+  
+  - name: statistics
+    type: object
+    description: 统计信息
+    properties:
+      total_items:
+        type: number
+      by_severity:
+        type: object
+      by_root_cause:
+        type: object
+
+# 元数据
+metadata:
+  author: Agent Studio
+  tags:
+    - evolution
+    - prioritization
+    - backlog

package/src/tools/definitions/std/evolution/report-gap.yml

@@ -0,0 +1,166 @@
+# report-gap.yml - 生成能力缺口报告
+# ============================================================================
+# 类型: 进化类步骤
+# 执行方式: 内置处理器
+# 用途: 分析失败原因，生成结构化的能力缺口报告
+# 核心理念: 失败归因 → 缺口识别 → 进化建议
+# ============================================================================
+
+name: report-gap
+stage: govern
+description: 分析失败原因并生成能力缺口报告
+category: evolution
+version: 1.0.0
+
+# 执行配置
+execute:
+  type: builtin
+  handler: evolution/report-gap
+
+# 输入定义
+inputs:
+  project_path:
+    type: string
+    description: 项目路径
+    required: true
+  
+  execution_id:
+    type: string
+    description: 执行 ID
+    required: true
+  
+  workflow_id:
+    type: string
+    description: 工作流 ID
+    required: true
+  
+  step_id:
+    type: string
+    description: 失败的步骤 ID
+    required: true
+  
+  error_message:
+    type: string
+    description: 错误信息
+    required: true
+  
+  error_type:
+    type: string
+    description: 错误类型（可选）
+    required: false
+    enum:
+      - NETWORK
+      - RATE_LIMIT
+      - API_ERROR
+      - TIMEOUT
+      - CODE_ERROR
+      - VALIDATION_ERROR
+      - UNKNOWN
+  
+  role_id:
+    type: string
+    description: 执行该步骤的角色 ID
+    required: false
+  
+  context:
+    type: object
+    description: 执行上下文
+    required: false
+    properties:
+      constraint_level:
+        type: string
+        enum: [L1, L2, L3, L4]
+      retry_count:
+        type: number
+      test_passed:
+        type: boolean
+      skipped_required_step:
+        type: boolean
+
+# 输出定义
+outputs:
+  - name: gap_report
+    type: object
+    description: 能力缺口报告
+    properties:
+      id:
+        type: string
+        description: GAP-YYYYMMDD-NNN 格式的 ID
+      root_cause:
+        type: string
+        description: 根本原因
+      confidence:
+        type: number
+        description: 置信度 (0-1)
+      gap:
+        type: object
+        properties:
+          type:
+            type: string
+            enum: [tool, step, workflow, context, constraint, knowledge]
+          name:
+            type: string
+          description:
+            type: string
+          severity:
+            type: string
+            enum: [low, medium, high, critical]
+      suggestions:
+        type: array
+        items:
+          type: object
+          properties:
+            type:
+              type: string
+              enum: [add_capability, adjust_constraint, enhance_context, fix_workflow, upgrade_agent]
+            description:
+              type: string
+            effort:
+              type: string
+              enum: [low, medium, high]
+            impact:
+              type: string
+              enum: [low, medium, high]
+            recommended:
+              type: boolean
+  
+  - name: backlog_item
+    type: object
+    description: 创建的进化待办项
+  
+  - name: report_path
+    type: string
+    description: Gap Report 保存路径
+
+# 示例用法
+examples:
+  - name: 分析能力缺失
+    input:
+      project_path: /path/to/project
+      execution_id: exec-20260404-001
+      workflow_id: wf-iterate
+      step_id: implement-task
+      error_message: "我不知道如何重构这个模块"
+      role_id: developer
+  
+  - name: 分析约束过严
+    input:
+      project_path: /path/to/project
+      execution_id: exec-20260404-002
+      workflow_id: wf-verify-loop
+      step_id: browser-test
+      error_message: "测试未通过"
+      error_type: VALIDATION_ERROR
+      context:
+        constraint_level: L4
+        retry_count: 5
+        test_passed: false
+
+# 元数据
+metadata:
+  author: Agent Studio
+  tags:
+    - evolution
+    - gap-analysis
+    - root-cause
+    - self-improvement

package/src/tools/definitions/std/file/read.yml

@@ -0,0 +1,21 @@
+# read.yml - 读取文件
+# =============================================================================
+# 步骤类型: 文件操作
+# 用途: 读取文件内容
+# ============================================================================
+
+id: file/read
+stage: develop
+name: 读取文件
+description: 读取指定路径的文件内容
+
+inputs:
+  - name: path
+    type: string
+    required: true
+    description: 文件路径
+
+outputs:
+  - name: content
+    type: string
+    description: 文件内容

package/src/tools/definitions/std/governance/aggregate-opinions.sh

@@ -0,0 +1,201 @@
+#!/bin/bash
+# aggregate-opinions.sh - 汇聚意见工具
+# ============================================================================
+# 功能：汇聚多个立场的审核意见，统计结果
+# 用途：wf-review 多立场审核，为决策者提供参考
+# ============================================================================
+
+set -e
+
+# 参数
+ARTIFACT_TYPE="${1:-}"
+OPINIONS_FILE="${2:-}"
+AGGREGATION_METHOD="${3:-weighted}"
+
+# 颜色输出
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+log_info() { echo -e "${GREEN}[INFO]${NC} $1"; }
+log_error() { echo -e "${RED}[ERROR]${NC} $1"; }
+
+# 显示帮助
+show_help() {
+  cat << EOF
+汇聚意见工具
+
+用法:
+  $0 <artifact_type> <opinions_file> [aggregation_method]
+
+参数:
+  artifact_type       审核对象类型 (proposal/architecture/code/decision)
+  opinions_file       意见文件路径（JSON 格式）
+  aggregation_method  汇聚方法 (weighted/majority/unanimous，默认 weighted)
+
+汇聚方法:
+  weighted   加权汇聚（根据立场权重计算）
+  majority   多数决（超过半数即为通过）
+  unanimous  全票通过（所有人都同意才通过）
+
+输入格式 (opinions.json):
+  [
+    {
+      "stance_id": "critic",
+      "verdict": "reject",
+      "opinion": "存在安全风险",
+      "issues": [...]
+    },
+    {
+      "stance_id": "supporter",
+      "verdict": "approve",
+      "opinion": "方案可行",
+      "issues": []
+    }
+  ]
+
+输出:
+  JSON 格式的汇聚结果和统计信息
+
+示例:
+  $0 proposal opinions.json weighted
+  $0 architecture opinions.json majority
+EOF
+  exit 0
+}
+
+# 检查参数
+if [[ "$1" == "-h" || "$1" == "--help" || -z "$ARTIFACT_TYPE" || -z "$OPINIONS_FILE" ]]; then
+  show_help
+fi
+
+# 检查文件是否存在
+if [[ ! -f "$OPINIONS_FILE" ]]; then
+  log_error "意见文件不存在: $OPINIONS_FILE"
+  echo '{"success": false, "error": "Opinions file not found"}'
+  exit 1
+fi
+
+# 读取意见
+OPINIONS=$(cat "$OPINIONS_FILE")
+
+# 立场权重
+declare -A WEIGHTS
+WEIGHTS["critic"]=1.5      # 挑刺者权重高
+WEIGHTS["supporter"]=1.0   # 支持者权重正常
+WEIGHTS["decider"]=2.0     # 决策者权重最高
+WEIGHTS["architect"]=1.3   # 架构师权重较高
+WEIGHTS["security"]=1.5    # 安全专家权重高
+WEIGHTS["performance"]=1.2 # 性能专家权重较高
+
+# 统计结果
+TOTAL_COUNT=$(echo "$OPINIONS" | jq 'length')
+APPROVE_COUNT=$(echo "$OPINIONS" | jq '[.[] | select(.verdict == "approve")] | length')
+REJECT_COUNT=$(echo "$OPINIONS" | jq '[.[] | select(.verdict == "reject")] | length')
+REQUEST_CHANGES_COUNT=$(echo "$OPINIONS" | jq '[.[] | select(.verdict == "request_changes")] | length')
+
+# 提取所有问题
+ALL_ISSUES=$(echo "$OPINIONS" | jq '[.[] | .issues // []] | flatten')
+
+# 计算加权分数
+WEIGHTED_SCORE=0
+TOTAL_WEIGHT=0
+
+while IFS= read -r opinion; do
+  STANCE_ID=$(echo "$opinion" | jq -r '.stance_id')
+  VERDICT=$(echo "$opinion" | jq -r '.verdict')
+  WEIGHT="${WEIGHTS[$STANCE_ID]:-1.0}"
+  
+  case "$VERDICT" in
+    approve)          SCORE=1 ;;
+    request_changes)  SCORE=0.5 ;;
+    reject)           SCORE=0 ;;
+    *)                SCORE=0.5 ;;
+  esac
+  
+  WEIGHTED_SCORE=$(echo "$WEIGHTED_SCORE + $SCORE * $WEIGHT" | bc)
+  TOTAL_WEIGHT=$(echo "$TOTAL_WEIGHT + $WEIGHT" | bc)
+done < <(echo "$OPINIONS" | jq -c '.[]')
+
+# 计算加权平均
+WEIGHTED_AVERAGE=$(echo "scale=2; $WEIGHTED_SCORE / $TOTAL_WEIGHT" | bc)
+
+# 根据汇聚方法确定最终结果
+case "$AGGREGATION_METHOD" in
+  weighted)
+    # 加权平均 >= 0.6 为通过
+    if (( $(echo "$WEIGHTED_AVERAGE >= 0.6" | bc -l) )); then
+      FINAL_VERDICT="approve"
+      CONFIDENCE=$WEIGHTED_AVERAGE
+    elif (( $(echo "$WEIGHTED_AVERAGE >= 0.3" | bc -l) )); then
+      FINAL_VERDICT="request_changes"
+      CONFIDENCE=$WEIGHTED_AVERAGE
+    else
+      FINAL_VERDICT="reject"
+      CONFIDENCE=$(echo "1 - $WEIGHTED_AVERAGE" | bc)
+    fi
+    ;;
+  
+  majority)
+    # 多数决
+    if (( APPROVE_COUNT > TOTAL_COUNT / 2 )); then
+      FINAL_VERDICT="approve"
+      CONFIDENCE=$(echo "scale=2; $APPROVE_COUNT / $TOTAL_COUNT" | bc)
+    elif (( REJECT_COUNT > TOTAL_COUNT / 2 )); then
+      FINAL_VERDICT="reject"
+      CONFIDENCE=$(echo "scale=2; $REJECT_COUNT / $TOTAL_COUNT" | bc)
+    else
+      FINAL_VERDICT="request_changes"
+      CONFIDENCE=0.5
+    fi
+    ;;
+  
+  unanimous)
+    # 全票通过
+    if (( APPROVE_COUNT == TOTAL_COUNT )); then
+      FINAL_VERDICT="approve"
+      CONFIDENCE=1.0
+    elif (( REJECT_COUNT > 0 )); then
+      FINAL_VERDICT="reject"
+      CONFIDENCE=$(echo "scale=2; $REJECT_COUNT / $TOTAL_COUNT" | bc)
+    else
+      FINAL_VERDICT="request_changes"
+      CONFIDENCE=0.5
+    fi
+    ;;
+  
+  *)
+    FINAL_VERDICT="request_changes"
+    CONFIDENCE=0.5
+    ;;
+esac
+
+# 生成摘要
+SUMMARY="共 $TOTAL_COUNT 个立场审核："
+SUMMARY="$SUMMARY $APPROVE_COUNT 通过，$REJECT_COUNT 拒绝，$REQUEST_CHANGES_COUNT 要求修改。"
+SUMMARY="$SUMMARY 最终结果：$FINAL_VERDICT（置信度：$CONFIDENCE）"
+
+# 输出结果
+cat << EOF
+{
+  "success": true,
+  "aggregated_result": {
+    "verdict": "$FINAL_VERDICT",
+    "confidence": $CONFIDENCE,
+    "summary": "$SUMMARY",
+    "method": "$AGGREGATION_METHOD"
+  },
+  "statistics": {
+    "total_count": $TOTAL_COUNT,
+    "approve_count": $APPROVE_COUNT,
+    "reject_count": $REJECT_COUNT,
+    "request_changes_count": $REQUEST_CHANGES_COUNT,
+    "weighted_average": $WEIGHTED_AVERAGE,
+    "issues_count": $(echo "$ALL_ISSUES" | jq 'length')
+  },
+  "issues": $ALL_ISSUES,
+  "by_stance": $(echo "$OPINIONS" | jq '[.[] | {stance_id, verdict}]')
+}
+EOF

package/src/tools/definitions/std/governance/aggregate-opinions.yml

@@ -0,0 +1,79 @@
+# aggregate-opinions.yml - 意见汇聚工具
+# ============================================================================
+# 类型: 治理类工具
+# 执行方式: 内置处理器
+# 用途: 汇聚多立场审核意见，做出最终决策
+# 核心理念: 多角色意见汇聚决策
+# ============================================================================
+
+name: aggregate-opinions
+stage: govern
+description: 汇聚多立场审核意见
+category: governance
+version: 1.0.0
+
+# 输入定义
+inputs:
+  - name: opinions
+    type: array
+    required: true
+    description: |
+      各立场审核意见列表
+      items:
+        stanceId: 立场 ID
+        roleId: 角色 ID
+        verdict: 审核结论 (approve | reject | request_changes)
+        opinion: 详细意见
+        issues: 问题列表（可选）
+  
+  - name: aggregation_method
+    type: string
+    description: |
+      汇聚方式：
+      - consensus: 一致同意（所有立场都同意才通过）
+      - majority: 多数同意（超过半数同意即通过）
+      - weighted: 加权投票（critic 权重 2.0，decider 权重 1.5）
+      - decider: 决策者决定（以 decider 立场的意见为准）
+    default: "decider"
+
+# 输出定义
+outputs:
+  - name: final_decision
+    type: string
+    description: |
+      最终决策：
+      - approved: 通过
+      - rejected: 拒绝
+      - changes_requested: 要求修改
+  
+  - name: reason
+    type: string
+    description: 决策理由
+  
+  - name: statistics
+    type: object
+    description: 审核统计
+    properties:
+      approve:
+        type: number
+      reject:
+        type: number
+      request_changes:
+        type: number
+      total:
+        type: number
+
+# 执行配置
+execute:
+  type: script
+  script: ./aggregate-opinions.sh
+
+# 元数据
+metadata:
+  author: Agent Studio
+  tags:
+    - governance
+    - aggregation
+    - decision
+    - multi-stakeholder
+    - stance-isolation