TypeScript Expert 技能:逐步给 JavaScript 模块加类型检查
EnglishClaude Code 安装步骤
- 从 GitHub 固定提交获取完整的 `cli-tool/components/skills/development/typescript-expert` 目录。
- 复制到目标项目的 `.claude/skills/`,确认 `.claude/skills/typescript-expert/SKILL.md`,再从项目根目录启动 Claude Code,输入 `/typescript-expert`。
中文摘要
用 Claude Code 分析编译设置和导入关系,在迁移阶段用 allowJs、checkJs 和 JSDoc 检查已有 JavaScript 模块。
SKILL.md 中文导读
可复现示例
给 price.js 的 formatPrice 标注 amount 参数为 number。让测试调用方传入字符串 '100',运行 tsc --noEmit 定位类型错误;改传数值 100 并重跑检查与原测试。工作步骤
- 启用 allowJs 与 checkJs,先收集编译基线。用 JSDoc 表达参数和返回值。
- 修复调用方的类型错配,再运行 tsc --noEmit 和原测试。按模块扩展覆盖范围。
验收方法
改前编译器指出错误调用。修复后类型检查通过,现有 JavaScript 文件继续按原项目入口运行。
GitHub 原文 · 更新日期
适用环境
准备有本地 TypeScript 编译器的 JavaScript 项目和可运行测试。在独立 tsconfig 中将示例范围限定为一个模块及调用方。
常见问题
给所有 .js 文件启用 checkJs 后报错太多,如何逐步接入?
把第一批迁移限制在独立 tsconfig 的 include 范围,修完一组文件再扩展。