SuperAPI AI 工具集

principle-type-system-discipline

编程与开发

查看项目

更新于 11-06 21:01

技能介绍

类型系统纪律

每次会话在使用本技能前,先阅读一次宿主适配器。它会把上游 Cursor 专用的工具、模型、路径与权限指令映射到你的宿主环境,并设定权限边界。

让编译器拒绝不可能状态、不匹配的原始类型以及未处理的变体。对于错误与特殊情况,优先通过定义将其消除,而不是不断增殖处理器。TypeScript 语法方面,参见 typescript-best-practices 技能。

品牌化语义原始类型。UserId 与 OrderId 底层都是字符串,但不应互换。给每个类型独立类型,例如 TypeScript 中的品牌交叉类型,或其他语言中的 newtype。在创建时校验一次,下游信任类型。如果两个参数共享原始类型但含义不同,就对它们做品牌化。

外部数据在被解析之前都是无类型的。RPC 负载、JSON、IPC 消息、CLI 参数、配置文件、环境变量、数据库行,以及浏览器中的 URL 与导航状态、存储与 IndexedDB、导入文件、postMessage 和第三方 SDK 对象。在每个边界都要有 parse 函数,把非结构化输入转换成类型化模型。boundary-discipline 原则技能说明了把校验放在哪里。

从权威 schema 派生类型。当协议缓冲、OpenAPI 规范、GraphQL schema、数据库迁移、设计令牌文件或其他文件拥有某个形状时,应从它派生类型,而不是手写一份并行的类型。参见 encode-lessons-in-structure 原则技能。