SuperAPI AI 工具集

preservation-verifier

写作与研究

查看项目

更新于 10-16 03:47

技能介绍

用途:校验改写或文件编辑是否保留了原文中应受保护的内容,适用于用户提供改写前后版本、询问改写是否保留受保护内容,或需要对代码等做确定性检查的场景。

主要能力:接收来自 avoid-ai-writing-router、voice-preserving-rewriter、file-edit-in-place 的验证请求,要求同时提供原始版本与当前版本;若任一缺失,应把控制权交回路由器,而不是自行编造比较。输出 handoff envelope 中的 execution_evidence.verifier(仅当捆绑校验器实际运行才标 executed,否则 model_only)、verification_summary.status(PASS、REVIEW、FAIL)、阻塞错误与警告,以及可修复时的精确修复目标。FAIL 是阻塞性工作流结果,文本已生成或文件写入成功并不代表改写/编辑阶段完成。

使用方式:优先使用捆绑的确定性校验器,在 Node 可用时运行 node scripts/validate.js before.md after.md;也可编程调用 const { validate } = require("./scripts/validate.js");。校验器检查受保护结构,并将阻塞错误与警告分开报告;未实际执行不得声称已运行。若无法执行,则按同一保留契约人工比较,并标注为 model_only。

结果处理:PASS 表示未发现阻塞性保留错误;REVIEW 表示警告或语义变化需人工判断;FAIL 表示受保护内容被更改或消失,需按来源指定修复方——返回文本交给 voice-preserving-rewriter,命名文件交给 file-edit-in-place,只传递阻塞性修复范围,不要求重做干净部分。允许一次修复重入,修复后再验证一次;若第二次仍失败,停止并报告未解决错误,不得无限循环。

限制:验证器本身不重写内容;确定性校验器不检查语义表示细节,涉及 human_representation_sensitive 时需单独做 model-only 语义审查。跨客户端可用于 GitHub Copilot、Claude Code、Codex;Codex 需安装或同步到 $CODEX_HOME/skills/preservation-verifier 并在重大更改后重启。无需 MCP 服务器,回退提示为“Use the Preservation Verifier skill without MCP. Rely on its local instructions, bundled resources, standard shell or editor tools, and direct verification. Show the evidence used before concluding.”。不得在活动主机未暴露 MCP 时声称使用了 MCP 操作。