SuperAPI AI 工具集

typescript-engineer

编程与开发

查看项目

更新于 11-13 16:18

技能介绍

TypeScript Engineer 是一个面向 TypeScript 类型层工作的技能。它聚焦类型设计、模块边界上的类型归属、编译器错误诊断与严格安全重构,适合处理泛型、条件类型、映射类型、模板字面量类型、品牌类型以及从 schema 派生的类型等任务。

用途 用于梳理 TypeScript 编译器错误、移除 any 与不安全的 unknown 处理或未检查的 as 断言、设计共享契约/DTO/领域模型/公共类型 API、在保持运行时行为不变的前提下把文件或模块重构得更严格,以及用具体的前后示例解释类型系统概念。它明确不处理仅需运行时校验的场景(如 Zod、io-ts、Valibot)、会改变运行时行为的行为重构、构建工具故障,以及 React、Node、Next、Nest、Vue 等框架或平台运行时模式。

主要能力 技能内容按主题组织为规则文件,包括严格模式编译选项、as const 与 satisfies、数组元素类型、工具类型、泛型基础、构建器模式、深推断、条件类型、infer、模板字面量类型、映射类型、品牌/不透明类型、类型收窄、断言函数、函数重载和错误诊断等,并配有可复制的气味测试示例与共享/本地命令差异说明。设计上主张每个文件只承担一项职责,优先小而单一用途的类型模块,私有辅助类型与实现就近放置,只有多个模块需要同一契约时才提升为共享类型,并区分 API、存储、校验与领域形状的所有者。它要求零未检查类型断言:as 仅允许出现在品牌构造函数、类型守卫返回或已记录的边界适配器中,不得作为修复编译错误的手段。

使用方式 在启动任何非平凡仓库工作前,先阅读目标仓库的 AGENTS.md 与 CLAUDE.md 覆盖说明,并查看仓库本地的 docs/TYPESCRIPT_STYLE.md 或同类 TypeScript 指说明。工作流上先判断项目形态:全新项目或新模块先开启严格标志并先写类型契约再实现;已有代码则检查严格程度与类型断言,记录 tsc --noEmit 基线,然后逐个错误或模块修复并证明诊断减少。修复前优先运行仓库的聚焦 TypeScript 检查(通常是 tsc --noEmit),记录准确的诊断文本与 ts(...) 代码;无法运行时需明确说明并基于可见代码推理。命令入口优先使用仓库的 shell 脚本,如 ./check_codebase.sh、./build_github_pages.sh、./run_web_server.sh、./run_playwright_tests.sh,很多仓库也以 npm run check、build、serve、test:playwright 镜像,但 shell 脚本仍是接口;当目标仓库使用共享 Python 环境时,通过 source source_me.sh && python3 ... 运行仓库 Python 辅助工具。导出类型前需确认该类型有明确所有者、契约足够稳定、在存在事实来源时从 schema 或常量派生、使用窄的 export type 再导出而非深层 barrel 链,且边界上没有未检查的 as 泄漏。

适用场景与限制 适用于类型层设计、编译器错误排查、严格化重构、类型级测试与审查。审查任务要求把发现只归入类型安全、模块边界、编译期错误、类型级测试四个固定标题,不得新增性能、安全或运行时标题。每次委派调用需返回可直接粘贴的代码块、实际运行的验证命令及其确切成功输出(默认 npx tsc --noEmit,成功状态为退出码 0 且无诊断输出)、受影响文件清单及各项失败或跳过检查的范围评估;没有命令与输出的“全部通过”不算完成。对于单域项目(浏览器游戏、CLI、简单库)可按功能区域划分边界,游戏形状还可参考专门的游戏类型模式规则文件。