关于 lang-typescript
lang-typescript 是面向 TypeScript 编码任务的技能,适用于明确涉及 TypeScript 的请求。它强调严格类型约束,并通过工作流生成和检查可执行的结果。
主要功能
- 01启用严格模式与空值检查
- 02优先使用判别联合类型
- 03用 unknown 和类型守卫收窄
- 04按任务范围触发技能
- 05按约束检查输出
适用场景
- 01替换不安全的 any 用法
- 02为模块应用 TypeScript 指引
- 03判断任务是否适用该技能
- 04按明确约束完善输出
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ ravnhq/ ai-toolkit --skill lang-typescript安装后在 Claude Code 中输入/lang-typescript确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
rules/_sections.mdexport-named-only.mdprefer-async-await.mdtype-discriminated-unions.mdtype-no-any.mdtype-no-assertions.md详细介绍
原则
- 启用严格模式——不使用隐式 any,启用严格空值检查
- 优先使用判别联合类型,而非类型断言
- 使用
unknown而非any——通过类型守卫缩小类型范围
规则
有关详细模式,请参阅规则索引。
示例
正向触发
用户:“在此模块中用判别联合类型替换不安全的 any 用法。”
预期行为:使用 lang-typescript 指南,遵循其工作流,并返回可执行的结果。
不触发
用户:“为新后端设计 REST 路由命名规范。”
预期行为:不要优先选择 lang-typescript;选择更相关的技能,或不使用技能直接处理。
故障排查
技能未触发
- 错误:预期会选择该技能,但实际没有。
- 原因:请求措辞与描述中的触发条件不够明确。
- 解决方案:使用描述中的明确领域或任务关键词重新表述,然后重试。
指南与其他技能冲突
- 错误:同一任务中的多项技能指令相互冲突。
- 原因:已加载技能的适用范围重叠。
- 解决方案:说明当前步骤以哪项技能为准,并优先应用其工作流。
输出过于笼统
- 错误:结果缺少具体、可执行的细节。
- 原因:任务输入缺少上下文、约束或目标格式。
- 解决方案:添加具体约束(环境、范围、格式、成功标准),然后重新运行。
工作流
- 判断请求是否明确符合
lang-typescript的范围和触发条件。 - 应用技能规则和引用的指南,生成具体结果。
- 根据约束检查输出质量;如果仍有不足,基于明确假设再优化一次。
评论
支持 Markdown