SuperAPI AI 工具集

code-review-typescript

编程与开发

查看项目

更新于 10-16 06:19

技能介绍

用途:这是一组 TypeScript 代码审查模式,作为 dh:code-reviewer 的栈专用规则,在检测到 tsconfig.json、*.ts 或 *.tsx 文件时加载。应用前需先阅读审查原则(定义权限、适用性、证据与阻断标准),Node.js 执行和浏览器渲染(含 TSX)仍需分别套用 Node 与 Web 检查,语言检查不能替代运行时检查。

主要能力与写法要点:严格模式方面,沿用项目现有编译门控,新项目优先严格检查,不因默认值要求迁移配置;检查可选属性与索引访问对 undefined 的处理,先确定受影响契约再建议 exactOptionalPropertyTypes、noUncheckedIndexedAccess 等更强标志;审查 @ts-ignore 需弄清被隐藏的诊断及不变量是否在别处成立,@ts-expect-error 优于 @ts-ignore。类型安全方面,追踪 any 与未检查断言至动态边界及其消费者;区分对外部未验证输入的断言与有构造或既定不变量支撑的内部细化;外部来源值应先用 unknown 验证再收窄;按真实契约选择类型;非空断言需证明相关路径上 null 不可能,注释本身只是待核验的主张。当多个标志编码互斥状态且调用方可能构造无效组合时,用可辨识联合,并检查状态转换。语义不同的原始类型(如 UserId 与 OrderId)在调用点可能互换时,建议使用品牌类型。ESM 方面,检查 require() 与 import 是否符合运行时、包/模块配置与输出代码,保持一致的 CommonJS 或 ESM 设计,优先具名导出,动态 import() 需标注预期模块形状。异步方面,确认结果被 await、返回给负责的调用方,或有意分离并处理拒绝,在真实消费者处报告丢失的完成或失败信号;建议并发前检查顺序、限流、资源边界与失败/取消语义。运行时安全方面,在信任边界用 schema 或等价守卫验证用户输入,追踪外部数据在受信使用前完成验证,执行所需环境变量须先验证再由依赖工作使用。satisfies 用于配置对象与记录字面量,可保留字面量类型并校验兼容性。

限制:资料未提供具体安装或调用命令、支持的运行环境与版本、收费与价格、许可与效果信息,暂未提供。