SuperAPI AI 工具集

evidence

通用与其它

查看项目

更新于 10-15 19:56

技能介绍

Evidence 是一套声明校准规则,核心观点是:一个声明的价值取决于为核实它做了什么。它为“做了多少核实”固定了词汇,并给出把看似合理的句子变成已验证句子的若干检查。其他技能在做出声明时按 id 引用这些规则,id 稳定并存放在 rules/registry.json。该规则集中提到的 decider 是批准和放行的角色,而非具体的人。

用途与适用时机:当一句话陈述关于代码、数据、系统或他人工作的事实时用 EVID-1;事实涉及运行行为时用 EVID-2;事实来自智能体、检索系统或审查机器人时用 EVID-3;提供摘要、摘录而非原文时用 EVID-4;数字即将成为消息或文档标题时用 EVID-5;刚发现一个缺陷时用 EVID-6;准备对他人的代码提交发现时用 EVID-7;准备断言或编辑文件时用 EVID-8;准备编写自定义代码时用 EVID-9;研究任务读到有教益的来源时用 EVID-10。

四个标签:Verified 表示本会话中打开了来源,即在引用位置读取了文件、日志、记录或页面;Measured 表示数字附带产生它的查询,命令或查询可重复;Inferred 表示从证据推理而来,需列出前提;Planned 表示意图而非已完成,是计划中的一步。不得升级级别:合并不等于部署,部署不等于数据已验证;“live”“100%”“PASS”“confirmed”“resolved”“on track”都需要匹配证据,“green”永远不是状态。需给出 sha、日期和通道或门禁。

主要规则:EVID-1 为每个事实子句打标签,未打标签的子句读者按 Inferred 处理;校准要诚实标注“unverified”,不能留空。EVID-2 在生产 sha 上验证,用来自线上产物或部署记录的 sha 定位 file:line,而非分支头或最新标签;行为来自生产数据,日期来自部署记录;仅代码只是假设,缺失性声明需要数据。EVID-3 智能体输出只是线索,子智能体引用、检索命中或机器人发现都指向某行,作者须先打开该行再使用,引用只有在作者比对后才算逐字。EVID-4 完整阅读来源,摘要是指向来源的指针,大来源应切片而非跳过,并说明哪些来源完整读过、哪些没有。EVID-5 标题数字要算两次,用第二种方法、不同路径;不同身份模型的两个系统计数不得直接相除,需先做 join;相同运行间会变动的数字是测试框架产物。EVID-6 发现一个缺陷后要清扫,命名模式、列出所有表面,每项报告为已确认、未受影响或未检查,“未检查”是有效且诚实的行。EVID-7 提交前先反驳,第二遍为对方辩护,若发现仍成立则连同两遍一起提交。EVID-8 断言前重读,尤其在 checkout、stash 或 rebase 之后,以及更新状态可能已变动的变更请求之前。EVID-9 构建前先调研,记录工具、数据源、维护、适配性并指明选择,自定义代码只覆盖缺口,供应商或伙伴对机制的定义优先于新模式。EVID-10 记录来源教了什么,在主题文件夹写带日期的文档,包含问题、来源(完整或部分)、方法、带证据的发现、开放问题和确切命令,不得覆盖更早的文档。

证据加权:按产生成本加权,已发布代码、书面设计、有记录的观察、观点依次递减;依赖最廉价种类的声明在打开更昂贵种类前视为 Inferred。

会话中应用:回答某主题前先打开已确立内容(主题记忆或带日期文档),先呈现这些再补充新内容;工作时边写边打标签;展示交付物前运行 review-change 中的自审(REVIEW-7);研究任务后先写带日期文档(EVID-10)再继续。

示例段落展示四个子句、四个标签、一个数字算两次、推断被标为推断而非升级为发现。配套技能包括 review-change(展示工作前的对抗性阅读)、plain-voice(需要证据的措辞与结论优先的消息形式)、decision-records(决策记录与术语表所在)、plan-project(假设与测试绑定的计划)。