SuperAPI AI 工具集

cursor-maintain-formal-verification-skill

编程与开发

查看项目

更新于 10-19 21:57

技能介绍

用途 该技能是形式化验证的“养护循环”。形式化检查只能证明它所描述对象的一个性质;当代码改变而验证没有同步时,检查可能继续通过,却在描述已经不存在的代码——这种通过看起来像证明,实际最危险。项目本地验证技能只处理代理使用该技能期间所做的变更,而本技能处理它漏掉的变更:合并、未经该技能的编辑,以及跨多次提交累积的漂移。

主要能力

  1. 定位检查:验证技能没有固定名称,需按其功能查找——即针对指定代码运行模型检查器、证明器或其他验证器的项目技能。对每个检查收集性质、覆盖代码、界限与假设、运行命令,以及最后一次确认其描述代码的提交。若不存在验证技能,则停止并指向 /cursor-create-formal-verification-skill;若技能未记录同步提交,则改用最后修改验证文件的提交,并说明这一点。
  2. 原样运行:在改动前先运行每个检查一次并记录结果。通过只说明旧描述仍成立,不说明代码正确;失败可能是漂移,也可能是缺陷。
  3. 阅读覆盖代码的每处变更:从同步提交到当前提交做差异对比,阅读每个提交信息,并注意被重命名、拆分或移动到其他文件的被覆盖函数,以及触及被检查状态的新代码。对每处变更判定为:无影响;验证已不再描述代码;承诺被有意改变(需引用文档注释、测试、变更日志或提交信息作为证据);承诺可能被破坏(无证据表明承诺改变,后续失败视为缺陷候选)。
  4. 依据代码更新而非依据结果更新:让模型或测试装置的每个变更部分重新指向评审者可打开的代码,代码中一个不可分割步骤在验证中仍为一个步骤。先依据代码写好更新再重跑,不得为让检查通过而塑造更新。仅在承诺被有意改变时修改性质,并记录旧表述、新表述和证据。除非变更使界限错误,否则保留界限;若必须降低界限,须在报告中说明。
  5. 重跑并逐项判断:通过时,要按性质防范的方式破坏新代码(如移除新检查或重排新步骤),确认检查能捕获,然后撤销破坏。失败时,把反例逐步对照真实代码回放:若某步在代码中不可能发生,说明验证有误,需修正验证并说明错在哪里;若每步都可能发生,则为缺陷,需指出引入提交、用代码自身语言叙述反例步骤、一句话说明危害;若廉价测试或复现能证明该缺陷,可作为证据加入报告,但不得提交到产品代码。
  6. 更新验证技能:更新每个检查覆盖的代码、命令、界限、假设和同步提交,将同步提交设为你检查的提交;被阻塞的检查不移动同步提交并在报告中说明;随后像下一个代理那样执行一次验证技能,确认其步骤仍可运行。

结果分类 每个检查给出唯一结果并说明:in sync(自上次同步以来无变更改变检查所描述内容,且检查通过);updated(代码改变,验证现已描述新代码,且检查通过);bug(验证描述当前代码,而代码违反性质,这是关于代码的发现,不是漂移);blocked(检查无法恢复一致或无法运行,须说明确切原因)。一个检查可同时为 updated 和 bug:更新让验证重新描述代码,随后性质失败。

编辑范围与限制 仅编辑验证相关内容:模型、测试装置、性质文件和验证技能本身。运行期间绝不编辑产品代码,除非用户要求。当性质在当前代码上失败时,不得削弱性质或模型来使其通过,应报告失败。不得修改产品代码或削弱性质以换取通过。模型检查只证明其声明的模型和界限,不证明未检查的产品代码。

报告要求 对每个检查说明:结果及阅读过的提交;验证中改了什么及原因(代码形态改变,或承诺被有意改变并附证据);重跑结果及用于证明更新后检查仍能失败的破坏;每个缺陷的通俗描述(用代码自身语言叙述反例步骤、危害、引入提交);验证仍未覆盖的内容,包括应覆盖而未覆盖的新代码。明确区分哪些失败是验证漂移、哪些是代码缺陷;对更新前通过、更新后失败的检查,说明旧通过基于过时描述。验证更新应放在独立变更中,与任何产品修复分开。

Codex 映射说明 使用所选仓库的项目本地技能位置,Codex 优先使用 .agents/skills/。将生成的验证文件和临时变更保留在该仓库或一次性副本内。工具安装和外部访问遵循原生权限。现有 proof-orchestrator 选择证明路径;model-capability-router 负责任何模型选择。

适用场景 适用于已有形式化验证、且代码会持续变更的项目,用于在合并、手工编辑和长期漂移后重新对齐验证与代码。具体收费、价格、平台与使用步骤资料未提供。