SuperAPI AI 工具集

compare-harnesses

通用与其它

查看项目

更新于 10-16 08:37

技能介绍

用途:对两个 scaffolded harness 做差异比较,适用于 fork 上游模板后确认具体分歧、核对“我的和别人的脚手架结果不同”的支持工单,或在 CI 中对候选脚手架与已知良好基线做字节级一致性检查。

主要能力:输出三个部分——Manifest 元信息(名称、kernel、surface 是否相同)、Hosts(各方携带的主机适配器,如 claude-code、codex、pi-dev、hermes、openclaw、rvm)、Files(按每个文件的 SHA-256 指纹列出新增/删除/修改)。判定与退出码:IDENTICAL 为 0(meta、hosts 与所有文件指纹均一致);DRIFT 为 1(至少一项不同);no-manifest-in-a、no-manifest-in-b、no-manifest-in-either 均为 2。

使用方式:在 Codex 中可用 /compare-harnesses a=./my-fork b=./upstream,加 bundle=true 输出 bundle。等价 CLI:harness compare ./my-fork ./upstream(文本输出);harness compare ./my-fork ./upstream --bundle(ADR-031 schema-1 JSON)。--bundle 输出 schema-1 JSON 信封,字段含 schema、generatedAt、a、b、meta、hosts、files、identical、exitCode,形状与 harness diag --bundle、harness export-config、harness audit --bundle 共享,便于 CI 直接解析。错误也以 bundle 形式给出(如 { "schema": 1, "error": "no-manifest-in-a" })。输出前会按 ADR-031 脱敏正则对 secret|token|key|password|passphrase 之类的对象键做脱敏,可安全粘贴到公开 GitHub issue。

适用场景:向上游提 PR 前找出具体分歧;把 --bundle 结果作为 diff.json 附到问题单;夜间任务比较当日脚手架输出与冻结基线,DRIFT 时失败。

限制与相关:需要两侧存在 .harness/manifest.json,否则退出码为 2。相关技能包括 diag-harness(单 harness kernel 版本偏移)、validate-harness(发布就绪)、verify-witness(Ed25519 见证签名验证);另可参考 ADR-030 Discovery Loop 与 ADR-031 Bundle JSON Pattern。价格、平台与更细使用步骤暂未提供。