核心用法
该 Skill 作为 TypeScript 编码规范的完整知识库，通过自然语言自动激活。用户提及 TypeScript 相关需求时，系统自动响应并生成符合规范的代码。涵盖从基础命名约定到高级泛型、React 组件、测试规范等 18 个完整章节，提供可直接复制的代码模板和配置方案。
主要功能模块：
- 代码生成：按规范自动生成函数、类、接口、React 组件等
- 代码审查：分析现有代码并指出风格违规项
- JS 转 TS：转换代码并添加严格类型注解
- 项目初始化：提供完整的 tsconfig.json、ESLint、Prettier 配置
- 规范查询：解释任意章节的最佳实践原理
显著优点
1. 权威性来源：整合 Google TypeScript Style Guide、mkosir、Platypi 等业界权威规范，经社区长期验证
2. 严格模式优先：强制启用 "strict": true，从源头杜绝隐式 any 和空值错误
3. 实战导向：提供 50+ 可直接运行的代码示例，涵盖自定义错误类、Result 模式、类型守卫等进阶模式
4. 工具链完整：配套 Prettier/ESLint 配置、推荐 tsconfig.json 基线、测试命名规范
5. 现代特性覆盖：包含 TS 5.0+ 的 satisfies 操作符、const 类型参数等新特性用法
潜在局限性
1. 无自动修复能力：作为纯文档型 Skill，无法直接操作文件系统执行格式化或重构
2. 团队适配成本：严格的命名约定（如无 I 前缀接口）可能与既有代码库冲突，需要团队协商
3. 版本锁定风险：推荐的 ES2022/NodeNext 模块配置对旧 Node 版本有兼容性要求
4. 领域特化不足：对特定框架（如 NestJS、Next.js）的深层模式未专门覆盖
适合人群
- 前端/全栈开发者：建立个人或团队的 TypeScript 编码标准
- 代码审查者：获取客观、可引用的评审依据
- 技术负责人：制定项目技术规范和技术选型决策
- 学习者：系统掌握 TypeScript 类型系统的高级用法
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 规范僵化 | 过度追求统一可能抑制合理例外 | 文档明确标注"必要时可协商调整" |
| 配置误用 | 严格规则可能导致第三方库类型报错 | 配合 `skipLibCheck` 和 `@ts-ignore` 注释规范使用 |
| 迁移成本 | 存量 JS 项目全面 TS 化工作量大 | 建议渐进式迁移，优先核心模块 |
该 Skill 安全等级 S+，纯文档零代码执行，适合作为团队 Code Review 的客观参照标准。