--- name: create-formal-verification-skill description: "生成项目本地技能,在缺陷代价最高、测试最少覆盖的位置用最合适的验证工具,对任意语言代码进行形式化验证。用于 /create-formal-verification-skill、‘模型检查这个竞态’、‘证明这个不变量’,或并发、重试、状态机、解析器、unsafe 代码需要超出测试的验证时。” disable-model-invocation: true --- # 创建形式化验证技能 测试检查某人想到的用例。形式化验证检查所述范围内的所有情况:模型中的每种步骤顺序、到界限为止的每个输入,或每个输入。本技能寻找仓库中最需要此验证之处,验证一个性质,并留下项目本地技能,让下一位代理对照该性质检查改动。为一位冷启动阅读、正在改动且从未见过你工作的代理编写该技能。用户必须能信任结果,并在不懂验证语言的情况下采取行动。 ## 从代码选择目标 根据代码库回答,只询问无法观察的事。若用户指定区域或缺陷,从那里开始。 好目标是代码作出的承诺,破坏会伤害用户,而测试很少触及破坏情形。选择仓库中最强有力的此类目标,而不是最易验证的目标。 ## 让问题选择工具 选择以最低成本回答问题的工具:模型检查器、证明助手、SMT 支持的验证器或其他工具。事件是否可能以坏顺序发生,通常适合在设计小模型上的模型检查器,任意语言下 TLA+ 是默认选择。代码本身是否对每个输入都正确,例如内存安全、溢出或数据结构不变量,通常适合在代码上运行的验证器。若没有验证器支持该语言,说明这一点,并用生成输入测试真实代码,而不是函数手写模型。必须在任意规模成立且界限不足的性质,可能需要证明。优先选择仓库开发者可安装运行的工具,并告诉用户选择原因。 ## 何谓优秀 - **忠于代码。**模型或证明每部分都指向审查者可打开的代码。验证视为不可分割的步骤,在代码中也是不可分割步骤。名称来自本仓库。 - **能够失败。**从未见过失败的检查不能证明任何事。让每项性质在受保护代码的损坏变体上失败,例如移除检查或重排步骤。 - **发现仍是发现。**当前代码破坏性质时,用代码术语和反例报告。不要削弱性质或模型直到通过,也不要未经用户要求修改产品代码。 - **范围诚实。**说明验证了什么、在哪些界限和假设下、遗漏了什么。通过只覆盖模型或界限,不覆盖整个系统。 - **无需工具也能读懂。**用各一句平实语言说明性质与危害。用代码词汇的短步骤序列描述反例。 - **低成本重跑。**一条命令、可复现工具版本,运行足够短,让下一位代理在每次相关改动时使用。 - **与代码同步。**记录每项检查覆盖的文件和函数,以及最后确认验证对它们描述准确的提交。覆盖代码在该提交后改变时,下一位代理能看出验证需重新检查。 ## 生成 verify 技能 编写带 frontmatter 的项目本地技能,命名区域并说明何时使用。没有 frontmatter,技能不会注册。仅凭技能,下一位代理必须能判断改动是否触及已验证代码、运行检查、区分真实缺陷与建模错误,并在改动为有意时更新验证。把覆盖记录和同步提交写入技能,告诉下一位代理只有确认验证准确描述新提交代码后才推进同步提交。使用本仓库真实命令、路径和名词,不留占位符。 若检查是 TLA+ 模型,告诉下一位代理用 pstack [`/statechart`](../statechart/SKILL.md) 技能读取每个结果。它把检查器发现的每个不变量违规显示为平实语言的最短路径。检查通过时,`/statechart` 绘制系统状态间移动图。按名称引用 `/statechart`。其命令、选项和文件路径随版本与机器变化,因此不要把它们复制到生成技能或脚本中。 ## 交付前证明 像下一位代理那样,对在真实代码中破坏该性质的一次临时改动遵循生成技能。它必须捕获破坏。然后丢弃临时改动,确认检查回到起点:通过,或仅在将报告的发现上失败。从未运行过的验证技能只是草稿。若技能漏掉破坏或步骤不运行,修复技能或验证,而非临时改动。 ## 交接 告诉用户验证了什么、用了哪个工具及原因、界限、检查用平实语言发现了什么、如何运行以及不覆盖什么。只有发现接近的第二目标时才建议。指向 `/maintain-formal-verification-skill`,用于在未重新检查的改动后让验证重新对齐。