SuperAPI AI 工具集

cursor-principle-type-system-discipline

通用与其它

查看项目

更新于 10-16 05:52

技能介绍

用途:在涉及类型设计、函数签名审阅或编写静态类型语言代码时应用,把类型检查器当作证明助手,在编译期消除不可能状态、原始类型混用和未处理分支。

主要能力与做法: 一、让非法状态不可表示。把变体建模为和类型(TypeScript 判别联合、Rust/Swift/Kotlin 带载荷枚举、Scala sealed class、Haskell/OCaml ADT),不要用一堆可选字段建模状态。反例:{ completed: boolean; completedAt?: Date } 允许 completed: true 而 completedAt 为 undefined;应改为 { kind: 'open' } | { kind: 'done'; at: Date },或从单一来源派生布尔值。 二、类型是构造而非限制。从期望的值出发搭建类型,而非用检查从宽松类型中切出来:非空列表是头加其余,而非加长度检查的列表;合法时间范围是起点加时长,而非两个需保持有序的时间戳。 三、品牌化语义原语。UserId 与 OrderId 底层都是字符串但不应互换,可用 newtype、opaque type、value class、phantom type、branded intersection,创建时校验一次,下游信任类型。 四、外部数据在解析前是无类型的。RPC、JSON、IPC、CLI 参数、配置文件、环境变量、数据库行都要在边界处有解析函数。 五、不要欺骗类型系统。类型转换、不安全强制与断言函数绕过编译器,是潜在运行时崩溃;编译器无法证明就去做校验、收窄或改模型。 六、穷尽匹配交给编译器。新增变体未处理时应编译失败(TypeScript 的 never 绑定、Rust 的未标注 match、Haskell 的 -Wincomplete-patterns、Kotlin sealed class 穷尽性)。 七、从权威模式派生类型,如 protobuf、OpenAPI、GraphQL、数据库迁移或设计令牌文件。 八、只在出现部分性时加强类型;优先全函数:空列表求和为 0 用普通列表,取头无答案则要求非空列表。

自检:写注释解释字段组合何时有效则类型太松;两个参数同原语但含义不同则品牌化;追查 any、as、assertNotNull 的来源并在边界校验;新增变体时编译器是否会提示;类型是否重复了别处的形状;加强类型是为保持全函数还是仅为更精确。

限制:资料适用范围为任何类型化语言,具体语法可参考 typescript-best-practices 等技能;未提供安装命令、价格、平台或具体产品集成信息。