（10350期）TypeScript – TypeScript 权威编码规范指南

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