--- name: maintain-formal-verification-skill description: "代码变更后让项目的形式化验证重新与代码一致:找出触及已验证代码的提交,更新模型、测试框架或性质以描述当前代码,重新运行,并说明每次失败是验证漂移还是代码缺陷。用于 /maintain-formal-verification-skill、“模型是否仍忠实于代码”,或在合并、重构触及已验证代码却没有重新检查之后。" disable-model-invocation: true --- # 维护形式化验证技能 形式化检查证明的是它所描述对象的某种性质。代码改变而验证没有改变时,检查可能继续通过,但描述的代码已经不存在。这种通过才危险,因为它看似证明。本技能是 `/create-formal-verification-skill` 生成的验证技能,或任何针对具名代码运行模型检查器、证明器、代码级验证器的项目本地技能的维护循环。项目本地技能处理智能体在使用技能期间作出的变更。本技能处理跳过它的变更:合并、未使用技能所作的编辑,以及跨多个提交积累的漂移。 ## 结果 为每项检查给出一种结果,并明确是哪一种: - **in sync(同步)**:自上次同步以来,没有任何变更改变检查所描述的内容,且检查通过。 - **updated(已更新)**:代码已变化,验证现在描述新代码,且检查通过。 - **bug(缺陷)**:验证描述当前代码,而代码违反该性质。这是关于代码的发现,不是漂移。 - **blocked(阻塞)**:无法让检查重新与代码一致,或无法运行。请明确说明原因。 一项检查可以同时是 updated 和 bug:更新让验证重新描述代码,随后该性质在当前代码上失败。 ## 编辑范围 只编辑验证相关内容:模型、测试框架、性质文件和验证技能本身。除非用户要求,否则运行期间绝不编辑产品代码。性质在当前代码上失败时,不要弱化性质或模型来让它通过。报告失败。 ## 一轮维护 1. **找到检查。** 验证技能没有固定名称,因此按行为寻找:针对具名代码运行模型检查器、证明器或其他验证器的项目技能。阅读找到的每一个,或用户指定的那个。为每项检查收集性质、覆盖代码、界限与假设、运行命令,以及上次确认它描述代码时的提交。若不存在验证技能,停止并指向 `/create-formal-verification-skill`。若技能没有记录同步提交,使用最后一次修改验证文件的提交,并说明这样做。 2. **按现状运行。** 改变任何内容前,每项检查运行一次并记录结果。此处通过不说明代码正确,只说明旧描述仍然成立。此处失败可能是漂移,也可能是缺陷。第 5 步前不要下结论。 3. **阅读覆盖代码的每项变更。** 比较覆盖文件从同步提交到当前提交的差异,并阅读每条提交消息。也要寻找移动的代码:被覆盖函数即使重命名、拆分或移到另一个文件,仍是被覆盖代码。还要查找触及检查所保护状态的新代码,例如写入相同字段的新函数。对每项变更判断属于以下哪一种: - **没有影响。** 变更没有改变验证描述的任何内容,例如格式、注释或验证未覆盖的代码路径。对照模型或测试框架检查,而不是对照提交消息。 - **验证不再描述代码。** 原为一个不可分割动作的步骤现在变成两步、增加或删除了分支、检查被移动、新路径到达受保护状态,或某值的范围已经不同。模型或测试框架必须改变。 - **承诺有意改变。** 变更改变了代码承诺的行为,且变更中的证据说明这是有意的:文档注释、测试、变更日志或提交消息。性质必须改变,而且必须引用该证据。 - **承诺可能被破坏。** 代码发生变化,却没有证据说明承诺改变。把其后的失败视为候选缺陷。 4. **依据代码更新,而非依据结果更新。** 修改模型或测试框架,让每个变化部分重新对应审查者可以打开的代码,并让代码中的一个不可分割步骤对应验证中的一个步骤。在重新运行前依据代码完成更新,不要按怎样才能通过检查来塑造它。只有承诺有意改变时才改变性质。写下旧表述、新表述及证据。保持原界限,除非变更使其不再正确。必须降低界限时,在报告中说明。 5. **重新运行并判断每个结果。** - **通过:** 检查现在可能在已失去失败能力的描述上通过。按该性质防范的方式破坏新代码,例如移除新检查或重新排列新步骤,确认检查能够捕获,然后撤销破坏。 - **失败:** 逐步对照真实代码重放反例。若某一步在代码中不可能发生,则验证错误。修复验证并说明哪里错了。若每一步都可能发生,就是缺陷。指出引入它的提交,用代码自身的语言把反例讲成一系列步骤,并用一句话说明危害。低成本测试或针对真实代码的复现能展示缺陷时,将其作为证据加入报告。不要将其提交到产品代码。 6. **更新验证技能。** 更新每项检查覆盖的代码、命令、界限、假设和同步提交。将同步提交设为你检查过的提交。阻塞检查不要移动同步提交,并在报告中说明。然后像下一个智能体那样完整遵循验证技能一次,确认其步骤仍可运行。 ## 报告 针对每项检查告诉用户: - 结果,以及你阅读过的提交; - 验证中改了什么、为什么改;每项变更给出简短理由:代码形态改变,或承诺有意改变(附证据); - 重新运行结果,以及你为证明更新后的检查仍能失败而实施的破坏; - 每个缺陷,用通俗语言说明:以代码术语描述反例步骤、危害,以及引入它的提交; - 验证仍未覆盖的内容,包括应该覆盖却未覆盖的新代码。 明确说明哪些失败是验证漂移,哪些是代码缺陷。对于更新前通过、更新后失败的检查,要说明旧通过基于过时描述。 将验证更新作为单独变更,与任何产品修复分开。