SuperAPI AI 工具集

typescript-tooling

编程与开发

查看项目

更新于 10-15 22:13

技能介绍

用途:为 TypeScript 项目提供开发工具链、代码检查与构建配置的规范指引,适用于配置 ESLint、Prettier、Jest、Vitest、tsconfig 或任何 TS 构建工具时使用。优先级为 P1(高)。

主要能力与建议:编译器方面,CI 构建使用 tsc,开发阶段使用 esbuild 或 ts-node。检查使用 ESLint 并启用 @typescript-eslint/recommended,开启严格类型检查;格式化通过 lint-staged 与 .prettierrc 强制使用 Prettier。测试使用 Vitest(或 Jest)进行单元与集成测试,目标行覆盖率大于 80%。构建方面,库打包使用 tsup,Web 应用使用 Vite。tsconfig 长期目标为 strict: true;存量项目应增量迁移,先 strictNullChecks,再 noImplicitAny、strictFunctionTypes,禁止一步开启 strict: true。CI/CD 始终在构建流水线运行 tsc --noEmit 捕获类型错误。错误抑制优先使用 @ts-expect-error 而非 @ts-ignore,并附文档说明边界情况。

验证流程(强制):编辑任何 .ts / .tsx 文件后依次执行——调用 getDiagnostics(typescript-lsp MCP 工具)实时暴露类型错误;在 CI 中运行 tsc --noEmit 捕获 LSP 可能遗漏的项目级错误;运行 eslint --fix 自动修复格式与 lint 问题。未配置 typescript-lsp MCP 时的回退方案为直接运行 tsc --noEmit。getDiagnostics 反馈最快,每次提交前对修改文件使用;用 getHover 查看推断类型,重命名符号前用 getReferences。

反模式:不用 @ts-ignore,改用 @ts-expect-error;请求对象不用 any,从 src/common/interfaces/ 导入集中式接口;不使用全局 eslint-disable,按行抑制并修复根因;存量仓库不做原子式 strict: true 切换,应从 strictNullChecks 开始增量迁移。

限制:资料未提供具体版本要求、依赖安装命令、完整配置示例及价格信息。