SuperAPI AI 工具集

audit-derivability

智能体与模型

查看项目

更新于 10-16 00:23

技能介绍

用途:审计文档级价值,回答“这份文档是否值得存在”。它只做分类与建议,不执行删除或改写,作者自行处理。

主要能力:以四项因素组成的评分标准给出结论——可推导性(新智能体能否仅靠原生探索代码、配置、元数据与结构重建文档结论)、再推导成本(删除后读者重建的代价)、漂移风险(底层来源变动速度与文档静默腐化程度)、事实归属(文档是否拥有无法推导的事实,如决策理由、约束、外部事实、跨文件不变量)。事实归属具有最高优先级:只要拥有至少一项不可推导事实即为 keep-owns-facts,其余可推导内容转交其他技能裁剪,而非删除。结论分为 delete、convert-to-pointer、keep-as-derivation-cache、keep-owns-facts。缓存类结论必须附带漂移控制条件(再生成路径或复查触发),否则降级为指针或删除。

使用方式:默认无参数时审计未提交的 .md 文件;传入文件路径审计单个文档;传入目录则审计该目录下直接的 .md(不递归);sweep <dir> 为递归的批量审计,按有界并发为每份文档派发全新只读子智能体并汇总成一份账本。每次响应只执行一个动作,动作之间不隐式串联。输出为每份文档的四因素表格、结论理由与受众归类(agent、human 或 both),批量结束时汇总删除/转指针/缓存/保留的数量,并可提议把可执行结论转入用户的工作项跟踪器,但绝不自动建档或自动编辑。

限制:只读,无 Edit、无 Write、无变更型 Bash。删除结论须同时满足可推导、再推导成本低、无归属事实;关键或有争议的删除须由未见过该文档的全新非 fork 子智能体做实证抽查确认,不能用当前上下文自我判断。受众不同,删除门槛不同:面向智能体的文档(如 CLAUDE.md、AGENTS.md)可严格删除,面向人类的文档门槛更高。它不做行级降噪、不做跨文件去重、不做压缩、不是文档漂移检测器,也不是文档生成器。

其他:具体评分细节、Diátaxis 事实归属映射、成本模型、抽查协议与用例收录于 context/rubric.md;上述以外的收费、价格、平台支持等信息暂未提供。