TypeScript 权威编码规范指南，涵盖命名、类型、函数、类、模块等 18 个维度的最佳实践，生成严格模式合规的标准代码。
说明：
## 核心用法
该 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 的客观参照标准。
会员专属
