用途:为 TypeScript 项目提供编码规范与最佳实践指导,适用于新建项目配置、interface 与 type alias 取舍、编写 async/await 代码、审查代码质量以及规避常见陷阱。
主要能力:给出类型推断与显式标注的取舍原则(简单类型交给推断,公开 API 显式标注);建议用 unknown 配合类型守卫替代 any;推荐 import type 做仅类型导入以利于 tree-shaking;介绍 as const 常量断言、可选链 ?. 与空值合并 ?? 的空值安全写法,以及用守卫子句减少嵌套。还列出常见错误与对策,如过度使用 any、未开启 strict 模式、冗余标注、忽略联合类型、未处理 null、独立异步操作串行 await(应改用 Promise.all)、cause 未用 Error 实例、与 Zod 重复定义类型(可用 z.infer<typeof schema> 推断)等。
使用方式:作为技能加载后,在配置 TypeScript 项目或审查代码时参考其快速参考与原则;更细的主题按渐进式披露分为代码模式、项目组织、测试与性能三份上下文文件,按需查阅。
适用场景:TypeScript 项目初始化与配置、代码评审、异步与类型安全重构。
限制:资料未提供具体安装命令、运行环境要求、收费方式或效果数据;示例代码仅为片段,完整细节需查阅其引用的 TypeScript 官方手册等外部资料。