typescript-advanced-types skill 是什么、怎么安装使用：让 AI 写对泛型、条件类型和映射类型

本文根据 wshobson/agents 仓库里该技能的 SKILL.md 与仓库 README 整理，资料核对于 2026-10-11。skills.sh 榜单当日显示该技能累计安装约 8.6 万次；所在仓库 wshobson/agents 在 GitHub 约 4.0 万 Star（同日数据）。技能内容会随仓库更新，以仓库为准。

这个 Skill 做什么

让模型写 TypeScript，业务逻辑通常没问题，类型部分却容易偷懒：遇到复杂一点的地方就写 any，或者用类型断言硬压过去。这个技能是一份 TypeScript 高级类型的速查与规范。description：掌握 TypeScript 的高级类型系统，包括泛型、条件类型、映射类型、模板字面量类型和工具类型，用于构建类型安全的应用；在实现复杂的类型逻辑、创建可复用的类型工具，或确保编译期类型安全时使用。

适用场景列得很具体：写类型安全的库或框架、可复用的泛型组件、复杂的类型推断、类型安全的接口客户端、表单校验、强类型的配置对象、状态管理，以及把 JavaScript 代码库迁移到 TypeScript。

核心概念五节，每节先说用途再给代码示例：

1. 泛型——基础写法、约束、多个类型参数；
2. 条件类型——基础、提取返回类型、分布式条件类型、嵌套条件；
3. 映射类型；
4. 模板字面量类型；
5. 工具类型。

更长的示例和模式放在同目录的 references/details.md，需要时才读。

后面三节是规范性的内容。最佳实践十条，例如：用 unknown 代替 any；对象形状优先用 interface，联合与复杂类型用 type；能推断就让编译器推断；用类型守卫而不是类型断言；开启严格模式；给类型写测试。常见陷阱七条，包括滥用 any、忽略严格空值检查、类型过于复杂拖慢编译、没用可辨识联合、循环类型引用。性能方面提醒避免深层嵌套的条件类型。

怎么安装

仓库 README 给了两种装法。只要这一个技能，用 skills CLI：

bash
npx skills add wshobson/agents --skill typescript-advanced-types

在 Claude Code 里则是装它所在的插件 javascript-typescript，同插件的其他技能、子智能体和命令会一起装上：

text
/plugin marketplace add wshobson/agents
/plugin install javascript-typescript@claude-code-workflows

仓库整体介绍和其他安装方式，详见本站《wshobson/agents 是什么、怎么安装：94 个插件、184 个 Skills 的多工具插件市场》。

怎么用

• 「给这个事件总线加上类型，让事件名和回调参数对应起来，不许用 any」。
• 「把这个接口的返回值类型根据请求参数自动推断出来」。
• 「评审这个文件里的类型定义，哪些断言可以换成类型守卫」。

适合谁 / 局限

适合写组件库、SDK 和中大型 TypeScript 项目的开发者，也适合想顺便学一学高级类型的人——让它解释自己写出的类型是不错的学习方式。局限：内容是通用知识的整理，不涉及具体框架的类型技巧；类型体操写过头会让代码难以维护，技能自己也提醒了这一点，业务代码里够用就好。

注意事项

• 许可：MIT。
• 不带脚本：SKILL.md 加一份参考文件，纯说明文字。
• 整库有一百八十多个技能，用 --skill 只装需要的，避免技能列表过长。