用途:在写实现之前,先从需求定义状态机规范,用规范说明系统必须做什么;优先把可编译期表达的属性编码进类型,再用状态机建模类型无法表达的部分。
主要能力:给出状态机分类与选择指引——typestate(编译期,泛型参数/幻影数据,使非法转移不可表示)、statecharts(层级状态、并行区域)、扁平 FSM(运行时枚举+匹配)、actor 模型(独立实体、消息传递、并发状态)。默认选择语言支持的最强机制,如 Rust typestate、Kotlin sealed class、TypeScript 可辨识联合。验证强度排序:类型系统 > 状态机 > 契约 > 运行时检查。
使用方式:工作流为 PLAN(从需求识别状态、变量、动作、不变量并画状态图)→ CREATE(用伪代码模板写规范,选择机制层级)→ VERIFY(类型检查、确认对所有状态穷尽匹配、验证每条转移上不变量成立)→ IMPLEMENT(目标代码镜像规范结构)。伪代码模板含 STATES、VARIABLES、INIT、ACTION(PRE/POST)、INVARIANT。与事件溯源集成时,命令先对照当前聚合状态机校验,合法才发出不可变事件,非法转移在事件产生前被拒绝。
适用场景:协议实现(网络、API、认证流)、工作流引擎(审批链、CI/CD 流水线)、并发/分布式系统协调状态、订单生命周期(电商、支付、物流)、连接/会话管理、消息驱动的 actor 系统、事件溯源聚合。
限制与不适用:无状态 REST 端点、纯数据变换(map/filter/reduce)、无生命周期的简单 CRUD、配置解析、无状态批处理均不适用。反模式包括布尔汤、字符串化状态、转移覆盖不全、状态与行为分离、只在边界检查不变量、隐式转移、无层级的 50+ 状态爆炸。验证门含类型检查、不变量、测试;退出码 0 表示规范已验证,11 检查器不可用,12 语法/类型错误,13 不变量违规,14 规范测试失败,15 实现不完整。具体语言机制与工具细节暂未提供。