SuperAPI AI 工具集

reality-check

通用与其它

查看项目

更新于 10-15 17:29

技能介绍

用途:核对关于“已完成、已交付、已修复、所有条目完成”等声明是否与 diff 或仓库中的可观察证据一致,也可用于测量既定目标或报告原生状态。

主要能力:把声明拆成独立条目,逐条给出处置——confirmed(引用证据)、gap(引用缺失或矛盾之处)、unverifiable(说明何种证据才能定论)。只认可证据显示的内容:没有输出的运行、依赖默认值或其他组件的行为、只执行代码却未断言目标结果的测试,都算 unverifiable。报告会区分已检查与未检查范围,并保持原生跟踪器、Git、运行时、确定性检查与语义判断等事实相互独立。

使用方式:快速回答可内联给出;需要持久化缺口报告时使用 reality-check-report.v1,将 reality-check-report.json 写到调用方指定位置(默认 .agents/scratch/reality-check/<run-id>/),并用本技能的 scripts/validate-output.sh <report.json> 校验。报告格式不含 verdict、readiness 或 PASS 字段。

适用场景:被问及某事是否真的完成时,即使看起来显而易见;核对计划范围与原目标是否一致,识别缺乏授权的范围扩张。

限制:本技能不改变原生状态,不签发语义 PASS,不修复记录、不调度或重试工作。声明审计不等于验收,不能替代 Validate 的独立判断;若需要验收,应移交并报告缺少新的独立评审者为 gap。无声明且目的未定的就绪问题属于歧义,需先询问一次是要建议性发现还是验收判断。目标测量与原生状态读取的细节见 goals 与 status 文档。