sickn33 TypeScript Expert：TypeScript 项目质量提升技能

技能简介

sickn33-typescript-expert 是由独立开发者 sickn33 制作的 Claude Code / Codex / Claude 专用 Skill，专注于帮助开发团队解决 TypeScript 项目中最常见的四类难题：类型安全不足、编译速度慢、复杂迁移风险高、代码风格混乱。该技能以 MIT 协议开源，托管于 GitHub（sickn33/antigravity-awesome-skills），Quality Score 80 分（Silver 档），已在 Skillstore 完成安全审计（2026-07-09），确认无实质性风险。

TypeScript 虽然已经成为中大型前端与 Node.js 项目的首选语言，但在实际工程中，许多团队面临的问题是：项目从 JavaScript 渐进迁移而来，tsconfig.json 配置混乱，strict 模式一开就报数百个错误；类型体操写得很漂亮但导致 tsc 编译时间爆炸；多人协作时代码风格不一致，类型定义散落在各处无人维护。sickn33-typescript-expert 正是针对这些真实痛点设计的工作流助手，它不只是一个提示词模板，而是一套包含配置审查清单、诊断脚本、迁移规划模板和代码审查标准的综合工具包。

核心能力

1. TypeScript 配置审查：自动检查 tsconfig.json 的 strict、module、moduleResolution、path aliases、incremental 等核心配置项，给出安全性与性能权衡建议。
2. 高级类型模式诊断：识别 branded types、conditional types、mapped types、template literal types 的误用与过度设计，提供更简单的等价实现。
3. 编译错误根因定位：分析 tsc 报错信息，区分真正的类型错误与模块解析路径问题、声明文件冲突等配置类错误。
4. JavaScript 至 TypeScript 迁移规划：生成渐进式迁移路线图，包含阶段性目标、验证步骤和回滚节点，避免一次性全量迁移带来的风险。
5. 类型安全代码审查：提供针对类型安全、模块结构、错误处理的专项审查标准，适用于 Code Review 流程。
6. 编译性能诊断：分析 monorepo 结构、typeRoots、paths 别名路径解析对 tsc 速度的影响，给出加缓存、增量编译、投影项目等具体优化方向。
7. 诊断辅助脚本：提供本地 TypeScript 项目一键检查脚本，自动输出配置现状与改进建议。

安装配置

方式一：Skillstore 一键安装（推荐）

npx skillstore add sickn33/typescript-expert

安装后 Skill 会自动注册到 Claude Code / Claude / Codex 的 Skill 目录，调用时无需额外配置。

方式二：手动克隆安装

git clone https://github.com/sickn33/antigravity-awesome-skills.git
cd antigravity-awesome-skills/skills/typescript-expert
# 将 SKILL.md 内容注册到 Claude Code 的 skills 目录

方式三：通过 Claude Code 命令行安装

claude skill install sickn33/typescript-expert

安装完成后，直接在对话中以自然语言描述需求即可触发对应能力，例如"Review 我的 tsconfig.json"或"帮我规划 JS 项目迁移"。

使用步骤

1. 安装技能：选择上述任一安装方式完成安装，确认 Skill 已注册（claude skills list 可看到 typescript-expert）。
2. 诊断现状：向 Claude 说明项目背景（使用的框架、是否有 tsconfig.json、是否已有部分 .ts 文件），请求诊断报告。
3. 获取建议：根据诊断结果，Claude 会输出配置优化清单、类型模式改进建议和编译速度分析报告。
4. 执行迁移或优化：按报告中的优先级逐步实施，每完成一项后用 npx tsc --noEmit 验证无新错误引入。
5. 代码审查：将待审查的代码片段或文件路径发给 Claude，使用 Skill 内置的代码审查标准进行逐项检查。

适用场景

1. 新项目初始化：新启动 TypeScript 项目时，让 Claude 帮忙设计合理的 tsconfig.json 配置，避免后期 strict 模式开不动的问题。
2. 遗留 JavaScript 项目迁移：已有大量 JS 代码的团队希望逐步迁移到 TypeScript，Skill 提供分阶段迁移路径和风险控制方案。
3. 大型 Monorepo 编译加速：项目中的 tsc 耗时超过 30 秒时，Skill 能诊断出 typeRoots、paths、project references 等配置问题并给出优化方案。
4. 代码审查流程嵌入：在 Code Review 环节使用 Skill 的类型安全审查标准，对 PR 中的 TypeScript 代码进行结构化检查。
5. 团队类型规范建立：为团队制定 TypeScript 编码规范时，参考 Skill 提供的 Best Practices 和 Anti-Patterns 制定内部标准。
6. 第三方库类型问题排查：当 @types 包缺失或版本冲突导致 tsc 大量报错时，Skill 能帮助定位类型定义问题的根源。

适用人群

• 前端 / Node.js 开发团队：正在使用或计划全面迁移到 TypeScript 的开发团队，尤其是已有大量历史 JS 代码需要维护的场景。
• Tech Lead / 架构师：需要为团队建立 TypeScript 编码规范、设计迁移路径、评估项目配置合理性的技术负责人。
• 独立开发者：对 TypeScript 高级类型系统感兴趣，希望系统化提升类型安全水平、减少运行时错误的个人开发者。
• DevOps / 构建工程师：关注 tsc 编译性能，希望通过配置优化和 monorepo 结构改进来缩短 CI 构建时间的工程人员。

工作原理

sickn33-typescript-expert 的核心是一套结构化的提示词模板（Prompt Templates），每套模板对应一个具体场景（配置审查、错误诊断、迁移规划、性能优化、代码审查）。当用户向 Claude 描述需求时，Skill 根据意图匹配最合适的模板，并以该模板的逻辑框架引导 Claude 的分析过程。

Skill 内置的诊断辅助脚本是一个 Python/Shell 混合脚本，可在本地项目中自动执行以下检查：读取并解析 tsconfig.json 文件、检查 node_modules/@types 目录、扫描 .ts/.tsx 文件的编译器报错数量、识别 paths 别名解析路径深度。该脚本的输出结果作为上下文补充给 Claude，使其能够基于真实数据而非主观猜测给出建议。

在代码审查场景中，Skill 提供的是一种结构化的审查框架：先判断代码语言和上下文，再按 Bug（空指针、越界、竞态条件）、Style（命名、可读性）、Performance（算法复杂度、内存分配、N+1 查询）、Security（注入漏洞、硬编码密钥、危险操作）四个维度逐项分析，最终输出带严重级别、行号引用、修复建议、摘要和质量评分的结构化报告。

官方链接

• 技能主页：https://skillstore.io/skills/sickn33-typescript-expert
• GitHub 仓库：https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/typescript-expert
• 安装命令：npx skillstore add sickn33/typescript-expert
• 安全审计报告：Skillstore 安全审计完成（2026-07-09），confirmedFindingCount=0，审计结论为误报，无实质风险