关于 typescript-advanced
typescript-advanced 是面向 TypeScript 开发的技能,适用于泛型、条件类型、映射类型、类型推断或可复用类型工具相关工作。它提供针对性参考,并指导可维护的类型设计与验证。
主要功能
- 01高级 TypeScript 类型指导
- 02可复用类型工具的模式
- 03类型推断与收窄建议
- 04类型契约测试指导
- 05编译器配置与复杂度建议
适用场景
- 01设计泛型可复用客户端
- 02调查条件类型或映射类型行为
- 03改进不可信边界处的类型推断
- 04检查库的公开类型契约
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ pedronauck/ skills --skill typescript-advanced安装后在 Claude Code 中输入/typescript-advanced确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/advanced-patterns.mdbest-practices.mdcore-concepts.mdtype-inference.md详细介绍
TypeScript 高级类型
当泛型推断、条件类型/映射类型、模板字面量或可复用类型工具本身就是问题时,请使用此技能。普通的类型化 API、表单和状态工作应遵循其领域指南,除非需要关注高级类型行为。
| 要更改的关注点 | 参考资料 |
|---|---|
| 泛型、条件类型/映射类型/模板字面量类型和工具类型 | references/core-concepts.md |
| 可复用的发射器、构建器、客户端、深层工具或可辨识模型 | references/advanced-patterns.md |
infer、类型收窄、断言函数和类型契约测试 | references/type-inference.md |
| 编译器配置、类型复杂度和可维护性 | references/best-practices.md |
优先使用能表达契约的最简单类型。在不可信边界使用 unknown 并进行真正的类型收窄;保留判别字段和 readonly 意图。让类型推断处理局部值,并遵循仓库对公共注解、interface 和 type 的约定。
使用现有的 tsconfig;参考配置仅为示例,并非要求修改配置的指示。仅当类型行为属于产品/库契约时,才添加编译时测试,并使用其所属的测试套件。不要为单个普通调用点引入新的类型框架或复杂的泛型抽象。运行仓库中受影响的类型检查关卡。
评论
支持 Markdown