SuperAPI AI 工具集

thermo-nuclear-code-quality-review

编程与开发

查看项目

更新于 11-15 17:06

技能介绍

用途

本技能用于对当前分支的代码变更进行深度代码质量审计,核心目标是评估并提升实现质量、可维护性、抽象质量和代码库健康度。它强调审查者应具有结构上的雄心,不应只关注局部清理,而应主动寻找“代码柔道”式重构:在保持行为不变的前提下,使实现显著更简单、更小、更直接、更优雅的重组。

主要能力

  • 结构性简化审查:不满足于“可以更干净一点”的建议,寻找能让整个分支、辅助函数、模式、条件或层消失的重新表述方案。
  • 文件大小控制:默认将 PR 导致文件从 1000 行以下推过 1000 行视为强烈代码异味,除非有充分的结构理由且文件组织清晰,否则要求先分解。
  • 意大利面条式增长防控:高度怀疑新增的临时条件、分散特例或插入无关流程的一次性分支,要求将逻辑推入专用抽象、辅助函数、状态机、策略对象或独立模块。
  • 抽象与边界清洁:标记薄抽象、身份包装、直通辅助函数;对不必要的可选性、unknown、any 或大量类型转换代码提出质疑;偏好显式类型模型或共享契约。
  • 分层与复用:要求逻辑位于规范层,复用现有规范工具/辅助函数,避免功能逻辑泄漏到共享路径或实现细节通过 API 泄漏。
  • 编排与原子性:将无理由的串行编排和非原子更新视为设计异味,在更清晰的结构显而易见时提出并行化或原子化改进。

使用方式

该技能以审查提示词形式提供。审查者需从基线提示开始:对当前分支变更执行深度代码质量审计,重新思考如何在不影响行为的前提下结构化/实现变更以显著提升代码质量,改进抽象、模块化,减少意大利面条代码,提升简洁性和可读性;要雄心勃勃,如果有清晰路径改进实现且涉及重构部分代码库,就去做;要极其彻底和严谨,“量两次,剪一次”。在此基础上应用技能中列出的不可协商附加标准、主要审查问题、积极标记项、首选补救措施、审查语气和输出期望。

适用场景

  • 对代码变更(PR/提交)进行严格的可维护性审查。
  • 需要评估抽象质量、文件大小、条件分支复杂度、类型边界和分层归属时。
  • 希望推动“代码柔道”式重构,删除复杂性而非重新排列复杂性时。
  • 团队需要明确的高标准批准门槛,防止结构回归被轻易放过时。

限制

  • 该技能是审查指导,不提供自动化代码修改或静态分析工具。
  • 审查效果依赖审查者判断,不保证发现所有问题。
  • 批准门槛为建议性规则,最终决策仍需人工判断。
  • 技能未提供具体安装命令、收费信息或平台支持细节,暂未提供。