用途:该技能在 javascript-author 模式之上扩展,指导编写严格类型的 TypeScript,适用于给 JavaScript 项目补充类型、构建类型安全 API、编写泛型,以及 Web Components 与 Node.js 场景。
主要能力与原则:始终启用严格 TypeScript 配置;边界处优先显式类型而非推断;使用联合类型、可辨识联合与类型守卫进行类型收窄;延续函数式核心(纯函数、无副作用);使用具名导出,不用默认导出。
配置:提供严格 tsconfig.json,包含 strict、noUncheckedIndexedAccess、noImplicitOverride、exactOptionalPropertyTypes,以及 declaration、declarationMap、sourceMap、outDir、rootDir 等选项。
类型模式:接口用于可扩展对象形状,type 用于联合、原始类型与计算类型;可辨识联合以 type 或 kind 为判别字段;提供用户自定义类型守卫 isUser 与断言函数 assertUser;泛型含基础、约束(K extends keyof T)与默认值(T = Record<string, unknown>)。
Web Components:给出带类型自定义元素示例,含 observedAttributes、私有字段、带类型 getter/setter、attributeChangedCallback 与类型化事件分发,并通过声明合并扩展 HTMLElementTagNameMap。
API 类型:展示请求/响应类型、ApiResult 判别联合、类型化 apiFetch 包装,以及用 Zod 做运行时校验并由 schema 推断类型。
其他内容:常用内置工具类型(Partial、Required、Pick、Omit、Record、ReturnType、Parameters、Awaited)、自定义工具类型(PartialBy、RequiredBy、DeepPartial、NonNullableProps、KeysOfType)、文件组织建议、最佳实践(公共函数显式返回类型、as const、用 unknown 代替 any、satisfies)与检查清单。
限制:资料未提供安装命令、版本要求、收费或价格信息,这些暂未提供。