SuperAPI AI 工具集

harness-mechanic

通用与其它

查看项目

更新于 10-16 06:45

技能介绍

用途:Harness Mechanic 是 claude-forge 运行时的进化智能体(Evolution Agent),依据论文《Code as Agent Harness》§3.5.2 的五阶段循环,读取执行轨迹、token 基线与历史变更契约,提出有证据支持的 harness 改进建议,目标组件包括 hooks/、rules/、skills/、agents/。

主要能力:实现五阶段循环——观察(读取 quality_reports/traces/ 的 trace JSONL、token 基线 TSV、历史变更契约)、诊断(将成本/延迟/无效动作/测试失败/权限拒绝归因到具体 harness 组件,跨会话聚类)、提议(具体编辑,如重写工具描述、修改上下文打包规则、增加 linter、调整重试上限、插入 HITL 门、调整路由模式,并附变更契约草稿)、评估(用留出轨迹回放,或提出最小可证伪测量,不推广未验证变更)、推广(仅在用户批准且变更契约完整后应用)。

使用方式:按需运行 /harness-mechanic。先读取最新 token 基线、最近至少 10 个会话的轨迹、历史契约,再运行五阶段循环,展示提议与契约草稿等待批准;批准后应用变更、复制契约到 quality_reports/harness_changes/,并对修改过的技能运行 /skill-forge review。前置检查:ls quality_reports/traces/.jsonl、确认 schema 为 v2、ls quality_reports/token_baselines/.tsv;无轨迹先运行 harness-trace extract,无基线先运行 harness-trace baseline --base-dir .。

适用场景:每周复盘、里程碑周后、评审循环卡住(多任务两轮以上得分低于 80)、发现跨会话重复失败模式时。

限制与治理:本技能自身受 PEV 循环约束;涉及权限边界、网络访问、凭据处理或 hook 行为的变更必须经 HITL 批准;扩大权限面的变更始终标记为高风险且强制契约。少于 5 个会话的轨迹应推迟;所有提议必须附轨迹行号或会话 ID,无证据不提议;一次变更只针对一个失败模式。资料未提供具体收费、价格与平台信息。