SuperAPI AI 工具集

typescript

编程与开发

查看项目

更新于 10-16 05:53

技能介绍

用途:指导 TypeScript 代码的编写与审查,核心原则是“类型应当让错误的程序无法通过编译”。资料强调三条偏好:让非法状态无法表示,再交给推断;每个 any、as、!、@ts-ignore 都被视为对类型声明的缺陷报告,应修复声明而非绕过;tsconfig.json 决定编译器能捕获什么,pin 住的版本决定能写什么,写代码前需先读两者。

主要能力:按编译器版本组织规则,涵盖 5.5 至 7.0 的版本差异与陷阱;严格性配置(strict 为基础,另建议 noUncheckedIndexedAccess、exactOptionalPropertyTypes、verbatimModuleSyntax 等);模块与解析(module: preserve / nodenext / node18,moduleResolution: bundler 等);可擦除语法(erasableSyntaxOnly 下不用 enum、namespace、参数属性等);注解与 satisfies;逃生舱;类型收窄;枚举;泛型;类型级编程;声明文件;类。

使用方式:引用 references/versions/ts-N.N.md 查看各版本新增、变更与陷阱;选择严格性检查或规划迁移顺序时读 references/conventions/strictness.md;项目配置与解析排错读 modules.md;收窄问题读 narrowing.md;泛型推断问题读 generics.md;类型级编程读 type-level.md;声明生成失败或准备发布读 declarations.md。命令与配置保持原样,如 tsc --init 模板、with { type: "json" }、as const satisfies、NoInfer<T> 等。

适用场景:TypeScript 项目配置、库发布、迁移升级、代码审查。限制:资料为技能说明,未提供具体收费、平台或服务条款信息;版本相关行为以项目 package.json 中 pin 的 TypeScript 版本为准,5.5 以下版本未收录。