ts-modern 是一个 TypeScript 编码规范与迁移技能,作用范围限定在 TypeScript 5.9.3 的现代语法与编译器配置内,可用于新建代码、代码审查、旧代码迁移和问题调试。
用途与工作方式 该技能先根据 package.json、锁文件、运行时目标、构建工具和现有 tsconfig 文件判断项目原型,再选择与运行时一致的模块策略:Node 运行时使用 node20 或 nodenext;打包器运行时使用 moduleResolution: bundler 配合 module: esnext;对外发布库优先采用 Node 忠实解析以检查兼容性;类型剥离运行时则要求代码属于可擦除的 TypeScript 子集。确定原型后才调整编译选项。
主要能力 它要求启用严格安全基线,包括 strict、noUncheckedIndexedAccess、exactOptionalPropertyTypes;在混合工具链仓库启用 isolatedModules,在声明较多的库工作流启用 isolatedDeclarations,存在副作用导入时使用 noUncheckedSideEffectImports。模块方面保持 verbatimModuleSyntax,类型符号使用 import type 与 export type,副作用导入需显式且可解析,moduleDetection 默认 force。类型写法上优先使用 satisfies 校验形状、const 类型参数保留字面量、内置 NoInfer 约束推断、可辨识联合建模状态,并在信任边界使用 unknown 后再校验收窄。
版本与遗留处理 默认基线为 TypeScript 5.9.3 稳定版,不生成 6.x 或仅测试版语法,除非用户明确要求。新代码不使用旧式实验装饰器、以命名空间为中心的架构、隐式类型导入消除,也不以 as any 或链式断言代替收窄。既有代码中的遗留写法仅可作为有边界的迁移例外保留,并需说明保留内容、原因和后续现代化步骤。
输出与验证 处理代码时会说明检测到的环境与工具链、版本基线及有意偏离、所选模块与编译策略及一个备选方案、两者的简要利弊、移除或保留的遗留模式及理由,以及运行过的检查与结果。修改后应使用目标项目现有的 typecheck、lint、测试和构建命令验证。
适用场景与限制 适用于希望统一现代 TypeScript 写法的应用与库项目、旧项目迁移审查,以及需要按运行时选择配置的场景。该技能本身不提供具体运行环境、价格或平台信息;其参考文档需按需读取。