教程2026-11-09 · 智涌AI

形式化验证 Skill 怎么用:TLA+ 查状态机再画成图

形式化验证 Skill 教程头图:流程图展示 statechart 报告的最短违规路径,点付款、扣款成功、支付回调重发后违反只扣一次规则;标注 500 个状态出图上限、20 条箭头、100,000 状态上限

测试只覆盖写测试的人想到的情况。重复扣款、重试撞上超时、两个请求抢同一把锁,这类 bug 往往藏在「步骤换个顺序」里。Cursor 官方插件仓库里的 pstack 带了两个 Skill 专门对付它:/create-formal-verification-skill 挑出代码里最怕出错的地方做形式化验证,/statechart 用 TLA+ 模型检查器跑一遍,再把状态流转画成 Mermaid 图。这篇按两份 SKILL.md 讲清怎么装、怎么下指令、产出该长什么样。

两个 Skill 各管什么

前置条件:Cursor,或 Claude Code;仓库里有状态机、重试、并发、解析器这类「测试很难覆盖全」的代码。pstack 是 cursor/plugins 仓库下的一个插件目录,MIT 许可,作者在 React 核心团队维护 React Compiler。

/create-formal-verification-skill/statechart
输入整个仓库,或你点名的模块、bug一份 TLA+ 规格和配置
做什么挑最值得验证的一条性质,选工具验证,再生成一个项目内 Skill 给下一个 Agent 复用用 TLC 检查每条规则,画出状态图,给每个违规状态一条最短路径
工具按问题选:步骤顺序类默认 TLA+;内存安全、溢出这类用跑在代码上的验证器;没有验证器就用生成输入测真实代码;要对任意规模成立才上证明TLC + Java,首次运行用 mise 安装,需要联网
产出项目内验证 Skill:覆盖哪些文件和函数、一条运行命令、上次核对的 commitchart.mmd、报告、tlc.out

两份 SKILL.md 的 frontmatter 都写了 disable-model-invocation: true:模型不会自己决定调用,必须你用斜杠命令点名。

第一步:安装

# Cursor
/add-plugin pstack

# Claude Code
/plugin marketplace add cursor/plugins
/plugin install pstack@cursor-plugins

Claude Code 会给插件命令加前缀,/statechart 要写成 /pstack:statechart。README 还提到,Claude Code 对第三方市场默认关自动更新,想跟最新版就在 /plugin 的 marketplaces 页给 cursor-plugins 打开 auto-update。插件整体介绍见站内 pstack 是什么。

第二步:写提示让 Agent 建模

在 Cursor 里先从 / 菜单选中 Skill 再输入任务,这样 Skill 才会附到这条消息上。可以这样写:

/create-formal-verification-skill 给结账和订阅续费这两个状态机建模,
每个子系统生成一个验证 skill。重点查:同一笔订单会不会被扣两次款。
然后用 /statechart 把下单到付款成功这条用户流程画出来。

按 SKILL.md 的要求,Agent 会先从代码里找目标,只问它看不到的东西;选「出错伤用户、测试又很少碰到」的那条性质,而不是最容易验证的那条。当前代码如果违反了性质,它要把反例用代码里的说法报给你,不许为了通过去放宽性质或模型,也不改业务代码,除非你要求。

哪些地方值得做?SKILL.md 点名了几类:并发和竞态、重试、状态机、解析器、unsafe 代码。换成业务语言就是:钱只能扣一次、库存不能卖成负数、权限撤销后旧会话不能再写、断线重连后消息不丢也不重。挑一条你线上真出过事故、或者最怕出事故的,比挑一条最好验证的更有用。

一个从没见它失败过的检查,什么也证明不了。

这是 SKILL.md 里的原意,验收就看这一条:每条性质都要在一个故意改坏的版本上(删掉一个检查、调换两步顺序)跑出失败。交付前 Agent 还得照着生成的 Skill 走一遍,确认它能抓住故意引入的破坏,再撤掉改动。

第三步:读懂 statechart 的规格和报告

/statechart 在仓库外的临时目录里写规格,然后运行 <skill 目录>/scripts/statechart SPEC.tla [--config FILE] [--view FILE] [--out DIR]。规格有三条写法要求:每条你认可的规则写成 INVARIANT;Next 写成各动作的析取,否则每一步都叫 Next;合法的终止状态要加一个只在终点成立、什么都不改的动作,不然会被当成死锁。一个结账流程大致是这样:

---- MODULE Checkout ----
EXTENDS Naturals
VARIABLES phase, charged
vars == <<phase, charged>>

Init == phase = "cart" /\ charged = 0
YouPressPay    == phase = "cart"   /\ phase' = "paying" /\ UNCHANGED charged
ChargeSucceeds == phase = "paying" /\ phase' = "paid"   /\ charged' = charged + 1
ChargeFails    == phase = "paying" /\ phase' = "failed" /\ UNCHANGED charged
YouRetry       == phase = "failed" /\ phase' = "paying" /\ UNCHANGED charged
WebhookReplay  == phase = "paid"   /\ charged' = charged + 1 /\ UNCHANGED phase
Done           == phase = "paid"   /\ UNCHANGED vars

Next == YouPressPay \/ ChargeSucceeds \/ ChargeFails \/ YouRetry
        \/ WebhookReplay \/ Done
ChargedOnce == charged <= 1
Bound == charged <= 2
====

配置里写 INVARIANT ChargedOnce 和 CONSTRAINT Bound。这里的 WebhookReplay 模拟支付回调重发又扣一次,TLC 会报出违反 ChargedOnce 的最短路径:点付款 → 扣款成功 → 回调重发。Bound 用来封顶:TLC 遇到违规会继续往下探,没有上限的模型可能跑不完。

图上的字由 view 模块决定。state(vars) 返回读者能看懂的状态名,step(action, from, to) 返回箭头上的话,比如「你点付款」「回调重发」,别出现变量名和动作名。还有两条规则要记住:停在同一个标签里的步骤不画,所以要把「已付款」和「已付款(扣了两次)」分成两个标签;图最好控制在 20 条箭头以内。

常见坑

现象原因和处理
输入任务后 Skill 没生效两个 Skill 都禁止模型自动调用,要从 / 菜单显式选;Claude Code 记得加 pstack: 前缀
第一次跑 statechart 卡住首次要用 mise 装 TLC 和 Java,离线环境会失败
正确的结束状态被报 NoDeadlock给终点加一个 UNCHANGED 的 Done 动作
报告里有「Rules not checked」第一次违规之后每轮最多探 100,000 个状态,到顶或出错的规则没查;缩小模型或先去掉已违规的规则
没有生成 chart.mmd状态超过 500 个且没有规则违规;把常量调小
模型报了 bug,代码里复现不出来SKILL.md 要求逐步重放到真实代码;复现不了先怀疑模型写错了

代码改了、验证没跟上,就会出现「检查还在通过,描述的却是已经不存在的代码」。这时用同插件里的 /maintain-formal-verification-skill:它从记录的同步 commit 起读每个改动,给每条检查一个结论:同步、已更新、bug、受阻。

完成标准

最后

先挑仓库里最怕出错的一个流程(扣款、发货、权限变更),跑一次 /create-formal-verification-skill,看它能不能在改坏的版本上报错。

关注公众号「智涌AI速递」

每天的 AI 快讯、实用教程和 AI项目实测,也会同步发到微信公众号。在微信里搜索「智涌AI速递」就能关注;不用微信的话,可以用 RSS 订阅本站。