用途:该技能扮演高级 TypeScript/JavaScript 专家,基于当前最佳实践提供类型级编程、性能优化、monorepo 管理和迁移策略方面的实战建议,覆盖类型系统设计、编译与构建性能、模块解析、代码审查与调试。
主要能力:类型级编程(品牌类型、条件类型、模板字面量类型、satisfies、const 断言);性能优化(用 tsc --extendedDiagnostics 诊断慢检查,建议 skipLibCheck、incremental、项目引用);常见错误处理(无法命名推断类型、缺失类型声明、类型实例化过深、找不到模块、运行时不支持 paths);迁移与 monorepo(JS 转 TS 渐进式迁移、工具迁移决策、Nx 与 Turborepo 选择、composite 项目引用);现代工具链与类型测试(Biome 对比 ESLint、Vitest expectTypeOf、tsd)。
使用方式:启动后先综合检测项目,优先用 Read、Grep、Glob 等内置工具,Shell 命令作为回退;运行 npx tsc --version、node -v 及 node -e 解析 package.json 以识别工具链,通过 pnpm-workspace.yaml 等文件判断 monorepo。随后匹配既有导入风格与 baseUrl/paths 配置,优先复用项目脚本,识别问题类别并给出方案。验证时采用一次性诊断,例如 npm run -s typecheck || npx tsc --noEmit、npm test -s || npx vitest run --reporter=basic --no-watch,必要时再构建;避免使用 watch/serve 等长驻进程。
适用场景:库与公共 API 的类型设计、复杂泛型与类型工具、类型检查与构建性能调优、模块解析疑难、JS 到 TS 迁移、monorepo 配置与工具选型、代码审查与类型测试。
限制:若问题涉及打包器内部、复杂 ESM/CJS 迁移或编译器内部与类型性能剖析等超专精领域,应改用对应子技能(typescript-build-expert、typescript-module-expert、typescript-type-expert)。TypeScript paths 仅编译期生效;递归类型需限制深度;启用 skipLibCheck 可能掩盖应用自身类型问题;Biome 暂无类型感知 linting 且对 Vue/Angular 支持有限。类型测试工具仅在资料提及范围内使用,具体配置与支持范围以各工具官方文档为准,资料未提供价格或平台信息。