SuperAPI AI 工具集

typescript-advanced-patterns

编程与开发

查看项目

更新于 10-16 03:46

技能介绍

用途:该技能面向超出 TypeScript 表层用法的场景,提供类型级编程、库作者惯用法与特性实现模式,共 40 条规则,分 5 类并按对使用方代码库的影响排序。

适用时机:设计公共库或 DSL 接口(流式构建器、事件发射器、路由解析器、查询构建器、由 schema 派生的客户端);编写类型级算法(递归条件类型、累加器模式、键重映射、可变元组、类型级字符串/数字运算、类型级测试);以复杂方式使用 TS 5.x 特性(Stage 3 装饰器、using 组合、const T 消歧重载、NoInfer 区分锚定与受限参数、变型标注、双变性漏洞);把工作流状态、转换与能力编码到类型层,使非法状态和缺失检查成为编译错误;以及与声明和模块系统集成(模块增强、声明合并、环境资源模块、通过 exports/typesVersions 发布库类型)。

规则分类:1. 库作者/DSL 模式(CRITICAL,dsl-,8 条);2. 类型级编程(HIGH,tlp-,10 条);3. 现代特性深入(HIGH,mod-,8 条);4. 特性实现模式(MEDIUM-HIGH,impl-,8 条);5. 声明与模块系统(MEDIUM,decl-,6 条)。

使用方式:阅读各参考文件获取详细说明、代码示例与“不适用”指引;规则间通过 [[other-rule-slug]] 交叉链接。参考文件包括 references/_sections.md、assets/templates/_template.md 与 metadata.json。

边界:若需编译器性能/tsconfig 调优、通用重构与现代 TS 基础、Google 代码风格、整洁代码原则、Effect 库专属模式,应使用相邻技能。若本技能规则与 typescript-refactor 或 .curated/typescript 重叠,规则的 Scope delta 段会说明本技能额外补充的内容。官方文档与具体规则文本暂未提供。