用途:在阅读或编写 TypeScript 与 JavaScript 文件(.ts、.tsx、.js、tsconfig.json)时应用,遵循类型优先、函数式与错误处理模式,仅覆盖语言层面的惯用法。处理 React 组件(.tsx、.jsx 或 @react 导入)时应同时加载 react-best-practices,本技能覆盖 TypeScript 基础,React 相关模式在专门的 React 技能中。
主要能力:一是让非法状态不可表示,用类型系统在编译期阻止无效状态,包括用可辨识联合表达互斥状态、用品牌类型区分领域原始值(如 type UserId = string & { readonly __brand: 'UserId' })、用 const 断言生成字面量联合(const ROLES = ['admin','user','guest'] as const),以及用 never 检查实现穷尽 switch。二是运行时校验使用 Zod:将 schema 作为唯一事实来源,用 z.infer<> 推断类型,避免类型与 schema 重复;用户输入预期会失败时用 safeParse,信任边界处无效数据属 bug 时用 parse;用 .extend()、.pick()、.omit()、.merge() 组合 schema,用 .transform() 在解析时规范化数据(如去空格、转日期)。可选使用 type-fest 获得更高级类型工具,如 Opaque、PartialDeep、ReadonlyDeep、SetRequired/SetOptional、Simplify。
限制:仅覆盖语言惯用法,不含 React 专用模式;文档未提供安装命令、收费方式与版本要求。