用途
Better Harness 用于审查编码智能体(coding-agent)的外层 Harness,关注上下文、执行、控制、反馈与学习,并保持 Session、项目与 Agent 资产相互独立。它支持审查、评估、报告,以及混合的审查与修复流程。
主要能力
- 解析作用域并收集证据包:确定目标、决策、验收边界、风险、语言环境、输出模式、提供方与深度。快速模式使用三项与 7 天窗口;普通模式使用五项与 30 天窗口。
- 运行三路独立证据分析:并行启动三个全新的只读智能体,分别处理 Session 证据、项目 Harness 证据与 Agent 定制证据。
- 主控复核与重新评分:合并候选发现,验证后果、因果链、最小所有者、证据边界、置信度与验证器,分配最终严重程度与一个主要 Agent Work Loop 检查项,并独立推导维度分数。
- 渲染授权报告:根据提供方选择 Canvas 或 HTML 模式,渲染并验证 findings.json。
- 后续跟进:支持绑定发现的修复、修复后状态更新、循环有效性评估、使用情况摘要与重复工作发现。
使用方式
技能通过命令行接口调用,核心命令为 <cli> harness evidence-bundle 与 <cli> harness render。其中 <cli> 为 <node> <better-harness-root>/scripts/better-harness.mjs。
证据包命令示例:
<cli> harness evidence-bundle --platform <provider> --workspace <target> --cwd <effective-cwd> --language <locale> --depth <quick|normal> --since <window-start> --until <window-end> --format json [--include-memories] [--include-user-home] [--canvas-out <run-dir>/canvas.json]
渲染命令示例:
<cli> harness render --findings <run-dir>/findings.json --mode <mode> --out <host-root> --run-dir <run-dir> --target <target> --validate --json
Qoder/Cursor 使用 <mode>=<provider>-canvas,<host-root>=<target>/.<provider>/better-harness;其他提供方使用 <mode>=html,<host-root>=<target>/.<provider>/better-harness。
适用场景
- 对编码智能体系统进行生命周期控制审查。
- 识别重复工作与项目反馈问题。
- 评估 Agent 资产(Rules、Skills、MCP、Memory、Agents、Hooks、Commands、Workflows、Plugins)的配置与完整性。
- 分析会话结果与修复进展。
- 在 Qoder/Cursor 中生成持久化 Canvas 报告,或在其他提供方生成 HTML 报告。
限制
- 不支持 REPORT_RENDERING 的提供方只能以内联或无文件方式运行,不得创建 HTML、Markdown 或 Canvas 输出。
- Memory 正文、Codex Memory、Qoder 全局 Memory、用户主目录、原始 Session、已安装插件、市场与历史洞察的访问需要明确授权。
- 证据分析阶段最多委派三个智能体,不得启动第四个审查智能体。
- 快速模式下部分证据包会降低置信度;普通模式下任何不可用或部分可用的专家通道都会阻止报告生成。
- 不得手写 Canvas、Markdown 或 HTML。
- 若所有者或值未解析,应停止并说明恢复条件,不得虚构替代产物或检查内部验证器。
- 关于收费、价格、平台支持范围等具体信息,资料中暂未提供。