TypeScript 开发规范

何时使用

当你编写或审查 TypeScript 代码（*.ts、*.tsx、*.d.ts 文件）时使用此 skill。

代码规范

• 在 tsconfig.json 中启用严格模式（strict mode），以获得更全面的类型检查
• 对对象结构使用 interface，对联合类型（union）或交叉类型（intersection）使用 type
• 在可能的情况下利用类型推断（type inference），减少显式类型注解
• 使用泛型（generics）构建可复用的组件与函数
• 启用 strictNullChecks，防止 null 和 undefined 引发错误
• 使用泛型提升类型推断能力，增强组件的可复用性
• 优先使用类型守卫（type guards）进行运行时检查，尽量避免强制类型断言（as）
• 避免使用 any 类型，不确定类型时优先使用 unknown 或泛型
• 熟练使用 TypeScript 工具类型（Utility Types，如 Pick, Omit, Partial）来转换类型
• 在终端运行命令时，默认使用 pnpm 作为包管理器