SuperAPI AI 工具集

thermo-nuclear-code-quality-review

编程与开发

查看项目

更新于 10-15 18:31

技能介绍

用途

Thermo-Nuclear Code Quality Review 是一个聚焦实现质量、可维护性、抽象质量和代码库健康的极严格审查技能。它不是常规的格式检查或命名建议,而是要求审查者对代码结构保持雄心,主动寻找“代码柔道”动作:在保持行为不变的前提下,让实现显著更简单、更小、更直接、更优雅的重构。

主要能力

资料给出的核心提示要求对当前分支的改动执行深度代码质量审计,重新思考如何结构化或实现这些改动,以在不影响行为的情况下实质提升代码质量;改进抽象、模块化,减少面条式代码,提升简洁性与可读性。如果存在清晰路径,鼓励对代码库进行重构。要求极其彻底和严谨,量两次、切一次。

技能附带多项硬性审查标准:

  • 对结构化简化保持雄心,不要止步于“这里可以更干净”,要寻找让整段分支、辅助函数、模式、条件或层级彻底消失的机会。
  • 不要让一个 PR 在缺乏充分理由的情况下把文件从 1k 行以下推到 1k 行以上。默认视为强代码质量异味,优先抽取辅助函数、子组件、模块或局部抽象。如果 diff 跨过该阈值,应明确询问是否应先分解;只有在有强结构理由且结果文件仍然组织清晰时才豁免。
  • 不允许既有代码中随意增长面条式逻辑。对新增的临时条件、零散特殊分支或插入无关流程的一次性分支保持高度怀疑,将其视为设计问题而非风格小问题。
  • 偏好直接、朴素、可维护的代码,而非取巧或魔法式代码。对薄抽象、恒等包装器、不增加清晰度的直通辅助函数要标记。
  • 在影响可维护性时强推类型与边界清洁:质疑不必要的 optional、unknown、any 或依赖大量 cast 的代码;偏好显式类型模型或共享契约。
  • 将逻辑保持在规范层,复用既有辅助函数;指出特性逻辑泄漏到共享路径或实现细节透出 API 的情况。
  • 将不必要的串行编排和非原子更新视为设计异味,如果独立工作被无理由串行化,应询问是否应并行。

使用方式

该技能以审查提示词的形式工作,对当前分支的改动进行审计,并按照资料中给出的优先级输出发现:先列结构性代码质量回退,其次是错失的显著简化或代码柔道重构机会,然后是面条式或分支复杂度增加、边界与抽象与类型契约问题、文件体积与分解问题、模块化与抽象问题、可读性与可维护性问题。它要求不要用低价值小问题淹没审查,宁可给出少量高置信度评论,而不是一长串表面笔记。

资料还给出批准门槛:不能仅因为行为看似正确就批准。批准的条件包括:没有明确的结构性回退、当可见路径存在时没有明显错失让实现显著更简单的机会、没有无理由的文件体积爆炸、没有因特殊分支导致的面条式增长、没有让代码更难推理的取巧或魔法抽象、没有不必要的包装器或 cast 或 optional 变更掩盖真实设计、没有明显的架构边界泄漏或对规范辅助函数的重复、没有明显错失实质性提升可维护性的分解机会。

适用场景

适用于分支级或 PR 级代码审查,尤其是希望推动架构级简化而不是接受“能跑就行”的实现;适合在代码库健康、抽象质量、文件体积控制和分支复杂度治理方面有较高要求的团队。

限制

资料未提供收费、价格、支持平台、安装命令或具体运行方式等信息。技能本身不改变代码行为,强调在保持行为不变的前提下改进结构。资料中的批准门槛和否决项是该技能自定的审查标准,实际执行效果取决于使用者。