mcpField
L
lang-typescript

lang-typescript

github.com/ravnhq开发1670 次安装21 周前更新
代码仓库

关于 lang-typescript

lang-typescript 是面向 TypeScript 编码任务的技能,适用于明确涉及 TypeScript 的请求。它强调严格类型约束,并通过工作流生成和检查可执行的结果。

主要功能

  1. 01启用严格模式与空值检查
  2. 02优先使用判别联合类型
  3. 03用 unknown 和类型守卫收窄
  4. 04按任务范围触发技能
  5. 05按约束检查输出

适用场景

  1. 01替换不安全的 any 用法
  2. 02为模块应用 TypeScript 指引
  3. 03判断任务是否适用该技能
  4. 04按明确约束完善输出

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/ravnhq/ai-toolkit --skill lang-typescript

安装后在 Claude Code 中输入/lang-typescript确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

rules/
_sections.md
export-named-only.md
prefer-async-await.md
type-discriminated-unions.md
type-no-any.md
type-no-assertions.md

详细介绍

原则

  • 启用严格模式——不使用隐式 any,启用严格空值检查
  • 优先使用判别联合类型,而非类型断言
  • 使用 unknown 而非 any——通过类型守卫缩小类型范围

规则

有关详细模式,请参阅规则索引。

示例

正向触发

用户:“在此模块中用判别联合类型替换不安全的 any 用法。”

预期行为:使用 lang-typescript 指南,遵循其工作流,并返回可执行的结果。

不触发

用户:“为新后端设计 REST 路由命名规范。”

预期行为:不要优先选择 lang-typescript;选择更相关的技能,或不使用技能直接处理。

故障排查

技能未触发
  • 错误:预期会选择该技能,但实际没有。
  • 原因:请求措辞与描述中的触发条件不够明确。
  • 解决方案:使用描述中的明确领域或任务关键词重新表述,然后重试。
指南与其他技能冲突
  • 错误:同一任务中的多项技能指令相互冲突。
  • 原因:已加载技能的适用范围重叠。
  • 解决方案:说明当前步骤以哪项技能为准,并优先应用其工作流。
输出过于笼统
  • 错误:结果缺少具体、可执行的细节。
  • 原因:任务输入缺少上下文、约束或目标格式。
  • 解决方案:添加具体约束(环境、范围、格式、成功标准),然后重新运行。

工作流

  1. 判断请求是否明确符合 lang-typescript 的范围和触发条件。
  2. 应用技能规则和引用的指南,生成具体结果。
  3. 根据约束检查输出质量;如果仍有不足,基于明确假设再优化一次。

评论

支持 Markdown