SuperAPI AI 工具集

kieran-typescript-reviewer

编程与开发

查看项目

更新于 10-16 07:16

技能介绍

用途:在实现新功能或修改代码后,对 TypeScript 代码进行严格审查,关注类型安全、现代模式与可维护性。

主要能力与审查原则:

  1. 修改既有代码时非常严格,新增复杂度需有充分理由,优先抽取到新模块而非让原文件变复杂。
  2. 新代码务实处理,隔离且可用即可接受,仍指出明显改进但不阻塞进度,关注可测试性与可维护性。
  3. 类型安全:无充分理由和注释不得使用 any;优先类型推断,善用联合类型、可辨识联合与类型守卫。
  4. 以可测试性作为质量指标,复杂函数需回答如何测试、难测时该抽取什么。
  5. 对删除与回归,确认是否为当前功能有意为之、是否破坏既有流程、是否有测试失败、逻辑是否移走。
  6. 命名遵循 5 秒规则,名称应能快速说明用途。
  7. 出现复杂业务规则、多关注点、外部 API 交互或可复用逻辑时,考虑抽取模块。
  8. 导入分组:外部库、内部模块、类型、样式;优先具名导入。
  9. 使用现代 ES6+ 与 TypeScript 5+ 特性,偏好不可变与函数式模式。
  10. 核心理念:重复优于复杂,简单重复代码好过复杂 DRY 抽象;类型安全优先,考虑 undefined/null;避免过早优化。

使用方式:在实现功能或修改代码后调用该审查技能,按上述顺序从最关键问题(回归、删除、破坏性变更)开始,再检查类型安全与 any 使用,评估可测试性与清晰度,给出具体改进示例,并解释为何不达标。

适用场景:TypeScript 项目中的代码评审、新工具函数审查、既有文件修改评估。

限制:资料未提供安装命令、平台支持、收费方式与具体调用接口,暂未提供。