SuperAPI AI 工具集

validation-first

编程与开发

查看项目

更新于 10-16 03:13

技能介绍

用途:在实现之前先定义状态机规范,用规范说明系统必须做什么;优先把编译期属性编码进类型,再用状态机建模表达类型无法覆盖的属性。

主要能力:给出状态机分类与选择指引——编译期 typestate(泛型参数、phantom data,使非法转移不可表示)、分层 statecharts(嵌套状态、并行区域)、运行时扁平 FSM(枚举加 match/switch)、actor 模型(独立实体、消息传递、并发状态)。默认选择语言支持的最强机制,如 Rust typestate、Kotlin sealed class、TypeScript 判别联合。验证强度排序为:类型系统 > 状态机 > 契约 > 运行时检查。

使用方式:按 PLAN(从需求识别状态、变量、动作、不变量并画状态图)、CREATE(用伪代码模板写规范并选机制层级)、VERIFY(类型检查、穷尽匹配、每个转移验证不变量)、IMPLEMENT(目标代码镜像规范结构)四步走。伪代码模板含 STATES、VARIABLES、INIT、ACTION(PRE/POST)、INVARIANT。事件溯源集成中,命令先对当前聚合状态机校验,合法才发出不可变事件,非法转移在事件产生前被拒绝。

适用场景:协议实现(网络、API、认证流)、工作流引擎(审批链、CI/CD)、并发/分布式协调、订单生命周期(电商、支付、物流)、连接/会话管理、消息驱动 actor 系统、事件溯源聚合。

不适用:无状态 REST 端点、纯数据变换、无生命周期的简单 CRUD、配置解析、无状态批处理。

限制与反模式:避免布尔汤(矛盾状态可表示)、字符串状态、转移覆盖不全、状态与行为分离、只在边界检查不变量、隐式转移、无层级的 50+ 状态爆炸。验证门包括类型检查、不变量、测试;退出码 0 表示规范已验证,11 检查器不可用,12 语法/类型错误,13 不变量违规,14 规范测试失败,15 实现不完整。具体语言机制与工具细节暂未提供。