SuperAPI AI 工具集

develop-typescript

编程与开发

查看项目

更新于 10-16 03:36

技能介绍

用途:在编写、审查或重构与框架无关的 TypeScript 时提供严格类型安全、tsconfig 配置和惯用模式指导。触发场景:编写必须严格类型化的新 TS 代码;审查类型安全、反模式或缺失的类型收窄;配置或审计 tsconfig.json 与 lint 规则;JS 迁移到 TS 或升级 TS 版本;诊断类型错误、推断失败或性能问题。不适用:任务主要是 React/Vue/Angular 组件工作、纯 Node.js 运行时 API 或仅构建工具时。含 .tsx 的仓库只要工作对象是 TS 本身(tsconfig、类型安全、导出契约、Result/错误模式、严格性审计)仍在范围内。

模式:Authoring(写、实现、创建、添加、重构、加强类型)会写代码并输出文件;Review(审查、审计、检查)只报告问题、不自动修复,P0 阻断;意图不明时先向用户澄清。

工作流:先分类任务并加载参考文件(type-system、patterns、anti-patterns、error-handling、strict-config、tooling、migration、performance、testing、modern-features,多数任务加载主类加一个相邻类);再加载项目 tsconfig.json 与 ESLint/Biome 配置比对;执行任务时使用 satisfies、公开函数显式返回类型,禁止裸 any、@ts-ignore 和未检查 as,动态数据用 unknown 加收窄;审查按 anti-patterns 清单扫描并分为 P0/P1/P2,对新增代码中的裸 any、@ts-ignore(应改 @ts-expect-error)、未检查 as、缺失错误收窄进行阻断,风格与命名问题仅提示。审计命令示例:grep -rnE --include=".ts" --include=".tsx" ": any\b" . | grep -v node_modules | head -20;grep -rn --include=".ts" --include=".tsx" "@ts-ignore" . | grep -v node_modules。

限制与注意事项:只把 moduleResolution: "node" 视为遗留,node16、nodenext、bundler 均属现代;不要擅自把 node16/nodenext 项目升级为 bundler;不要单方面重新启用 lint 规则;项目 lint 冲突时新代码遵循更严格规则,既有代码尊重项目配置并将冲突标为提示;审查模式不自动修复;始终交付可编译代码或结构化发现列表。若仓库无 ESLint/Biome 配置,记录缺失并跳过冲突处理。其他细节(如具体价格、平台支持等)暂未提供。