SuperAPI AI 工具集

ts-language-patterns

编程与开发

查看项目

更新于 10-26 16:22

技能介绍

用途:ts-language-patterns 面向编写或审查现代 TypeScript 语法的场景,帮助开发者或代理采用较新的语言特性,并修复 AI/LLM 生成的典型反模式。

主要能力:

  • const 类型参数:<const T> 可推断最窄字面量类型,调用处无需 as const。
  • using / await using:通过 Symbol.dispose / Symbol.asyncDispose 实现确定性资源清理。
  • 标准装饰器:采用 ECMAScript 装饰器,而非 experimentalDecorators。
  • satisfies:在按类型校验值的同时保留窄推断类型。
  • 6.0 推断:方法语法回调不再上下文敏感,推断与顺序无关。
  • 7.0 模板字面量:推断按 Unicode 码点切分,而非 UTF-16 代理对。
  • LLM 反模式修正:legacy enum(Node 类型剥离器无法擦除,建议改为 as const 常量对象)、用 namespace 包裹运行时代码、verbatimModuleSyntax 下缺失 import type。

使用方式:资料规定了一套强制代理工作流。在编写非平凡 TypeScript 前,并行启动 3 个代理(每个一次 Agent 调用并命名):fuse-ai-pilot:explore-codebase 检测既有惯用法、verbatimModuleSyntax 与 tsconfig;fuse-ai-pilot:research-expert 在 typescriptlang.org 核验当前语法;mcp__context7__query-docs 查询 /microsoft/typescript 获取精确 API 形状。编写完成后运行 fuse-ai-pilot:sniper 进行校验。技能附带参考指南与模板:resource-management.md 用于 using/await using/disposables;generics-and-inference.md 用于 const 类型参数、satisfies 与推断调试;decorators.md 用于添加装饰器;llm-pitfalls.md 用于审查或迁移旧式/AI 生成 TS;modern-patterns.md 与 resource-management.md 提供可复制示例。

关键规则:verbatimModuleSyntax 下类型导入必须写 import type,否则 emit/剥离会出问题;不使用 legacy enum,优先 const 对象 as const;不用 namespace 包裹运行时代码,改用 ESM 模块(仅类型 namespace 可接受);使用标准装饰器,新代码不启用 experimentalDecorators;不要依赖隐式 any,自 6.0 起 strict 为默认(7.0 延续),需显式标注或推断。

适用场景:编写或审查现代 TS 语法、迁移旧式或 AI 生成代码、引入装饰器与资源管理、调试类型推断。

限制:tsconfig/编译器标志属于 ts-config,SOLID 结构与文件大小规则属于 solid-generic,框架特定 API 不在覆盖范围内。资料未说明收费、价格或平台支持情况。