核心用法
该技能在检测到 TypeScript 关键词时自动激活，可执行以下操作：
- 代码生成：按照 18 章完整规范输出类型安全、风格一致的 TypeScript/React 代码
- 代码审查：对照命名约定、类型使用、错误处理等规则进行风格检查与优化建议
- 语言转换：将 JavaScript 迁移至 TypeScript，补全类型注解与接口定义
- 项目初始化：提供推荐的
tsconfig.json、ESLint 与 Prettier 配置
显著优点
1. 全面性与权威性：覆盖从基础变量声明到 React 组件、测试规范、工具链配置的完整开发链路，规则源自社区最佳实践（Google TS Style、Airbnb、TypeScript 官方严格模式）
2. 严格类型安全：强制启用 "strict": true，优先使用 interface 描述对象形状、type 处理联合/交叉类型，最小化 any 使用，推广 unknown 与类型守卫
3. 现代化语法支持：涵盖 TS 5.0+ 特性如 satisfies 运算符、ES 私有字段 #，以及 const 断言、可选链、空值合并等
4. 工程化导向：提供可落地的工具链配置，包括模块解析策略、导入排序、tree-shaking 友好的 import type 用法
5. React/JSX 专项：针对函数组件、Hooks、受控组件等场景制定专门规范，明确反对 React.FC
潜在缺点与局限性
- 配置较重：推荐的
tsconfig.json包含noUncheckedIndexedAccess、exactOptionalPropertyTypes等严格标志，对遗留代码迁移可能产生较多类型错误 - 主观风格选择：如强制分号、单引号、2 空格缩进等属于团队偏好，可能与现有项目冲突
- 无运行时验证：规范仅约束编译期类型，不保证运行时数据合法性（需配合 Zod/io-ts 等库）
- React 场景局限：主要针对函数组件 + Hooks，对 Class 组件、高阶组件等模式覆盖较少
适合人群
- 中大型团队协作开发，需要统一代码风格与类型标准
- 从 JavaScript 迁移至 TypeScript 的项目团队
- 对类型安全有严格要求的技术栈（金融、医疗健康、企业级 SaaS）
- 希望建立可维护、可测试架构的 React + TypeScript 开发者
常规风险
- 过度设计风险：初学者可能在简单场景下滥用泛型、条件类型，导致代码可读性下降
- 严格模式迁移成本：开启
strictNullChecks后需大规模重构可选值处理逻辑 - 工具链版本锁定：部分配置依赖较新 TypeScript/ESLint 版本，老旧项目需先升级依赖