--- name: create-formal-verification-skill description: "为项目生成本地技能,使用适合的验证工具,对任意语言中缺陷代价最高而测试最难触及的代码进行形式化验证。用于 /create-formal-verification-skill、“对这个竞态做模型检查”、“证明这个不变量”,或并发、重试、状态机、解析器、不安全代码需要超越普通测试的验证时。" disable-model-invocation: true --- # 创建形式化验证技能 在 Claude Code 中,每个会话在遵循此技能前,先阅读一次 [Claude Code 适配器](../../docs/harness/claude-code.md)。它将 pstack 技能中的 Cursor 名称映射到 Claude Code。 测试检查人们想到编写的那些用例。形式化验证检查明确范围内的每一种情况:模型中每一种步骤顺序、边界以内的每一个输入,或全部输入。本技能找出仓库中最值得这样做的部分,验证它的一个属性,并留下项目本地技能,让下一个智能体能够对照该属性检查改动。编写时应假定这个智能体在修改途中第一次读到它,从未看过你的工作。用户无需学习验证语言,也必须能够信任结果并据此行动。 ## 从代码中选择目标 从代码库回答问题,只向用户询问无法观察的内容。如果用户指定了区域或缺陷,从那里开始。 好的目标是代码作出的某个承诺:一旦被破坏就会伤害用户,而普通测试很难覆盖到触发破坏的情形。选择仓库中最符合这一条件的目标,而非最容易验证的目标。 ## 由问题决定工具 选择能以最低代价回答问题的工具:模型检查器、证明助手、基于 SMT 的验证器,或其他工具。事件能否以错误顺序发生,通常适合用模型检查器检查一个小型设计模型;对于任意语言,TLA+ 是这类问题的默认选择。代码本身是否对每个输入都表现正确,例如内存安全、溢出或数据结构不变量,通常适合直接对代码运行的验证器。如果没有验证器支持这门语言,就直说,并使用生成的输入测试真实代码,不要手工重写一个函数模型。必须对任意规模都成立、有限边界不够用的属性,可能需要证明。优先选择仓库开发者能够安装并运行的工具,并告诉用户为什么选择它。 ## 优质验证的条件 - **忠于代码。** 模型或证明的每个部分都指向审查者能够打开的代码。验证中视为不可分割的一步,在代码中也必须是不可分割的一步。名称来自本仓库。 - **确实能够失败。** 从未见过失败的检查不能证明什么。针对被保护代码的故障变体,展示每个属性确实失败,例如移除检查或调换步骤顺序。 - **发现仍是发现。** 当前代码破坏属性时,用代码中的术语报告问题与反例。不要削弱属性或模型直到它通过,除非用户要求,否则不要修改产品代码。 - **诚实说明范围。** 说明验证了什么、使用哪些边界与假设、遗漏了什么。通过只覆盖模型或指定边界,不覆盖整个系统。 - **不懂工具也能读懂。** 分别用一句朴素的话说明属性及其被破坏的危害。用代码中的词,把反例讲成一段简短的步骤序列。 - **重新运行成本低。** 一条命令、可复现的工具版本,以及足够短的运行时间,让下一个智能体愿意在每次相关修改时使用它。 - **与代码同步。** 记录每个检查覆盖的文件和函数,以及上次确认验证确实描述这些代码时的提交。覆盖代码在该提交之后变更时,下一个智能体能看出验证需要再次检查。 ## 生成验证技能 编写项目本地技能,在头部元数据中指出所覆盖的区域和使用时机。没有头部元数据,技能不会注册。仅凭这个技能,下一个智能体就必须能够判断某次改动是否触及被验证代码、运行检查、区分真实缺陷与建模错误,并在改动有意发生时更新验证。把覆盖记录和同步提交写进技能,并要求下一个智能体仅在确认验证仍描述新提交中的代码之后,才把同步提交向前更新。使用本仓库的真实命令、路径和名词,不留下占位内容。 如果检查使用 TLA+ 模型,要求下一个智能体用 pstack 的 [`/statechart`](../statechart/SKILL.md) 技能阅读每次结果。它用朴素语言把检查器发现的每个不变量违例展示为最短路径。检查通过时,`/statechart` 会画出系统如何在各状态之间迁移的图。通过名称引用 `/statechart`。它的命令、选项和路径会随着版本与机器变化,所以不要把任何这些内容复制进生成的技能或脚本。 ## 交付前证明它有效 像下一个智能体那样,遵循生成的技能运行一次,使用一份临时改动,在真实代码中破坏该属性。检查必须抓到这次破坏。然后撤掉临时改动,确认检查回到原先状态:通过,或只在你将报告的问题上失败。从未运行过的验证技能仍是草稿。如果技能漏掉破坏,或者某一步无法运行,修复技能或验证,不要修改临时故障来迎合它。 ## 交付 告诉用户验证了什么、用了什么工具以及原因、边界是什么、检查用朴素语言发现了什么、如何运行,以及没有覆盖什么。只有发现了另一个价值接近的目标时,才建议第二个目标。提示用户在未经重新检查的修改之后,使用 `/maintain-formal-verification-skill` 使验证重新与代码一致。