SuperAPI AI 工具集

thermo-nuclear-code-quality-review

编程与开发

查看项目

更新于 10-28 16:14

技能介绍

用途

Thermo-Nuclear Code Quality Review 是一个聚焦实现质量、可维护性、抽象质量和代码库健康的严格审查技能。它针对当前分支的改动进行深度代码质量审计,目标是识别结构性问题,并提出能在不改变行为的前提下显著改善代码质量的重构方案。

主要能力

该技能要求审查者保持结构性野心:不只指出“这里可以更干净一点”,而是寻找“代码柔道”式动作——利用现有架构更有效地重组变更,使整类分支、辅助函数、模式或层级直接消失,让代码在事后看来显得顺理成章。

审查规则包括:

  • 反对随意增长的文件:默认不允许补丁把文件从 1000 行以下推过 1000 行,除非有充分的结构性理由;优先提取辅助函数、子组件、模块或局部抽象。
  • 反对意大利面式条件增长:对插入无关流程的临时条件、零散特殊分支保持高度怀疑,视为设计问题而非风格问题。
  • 偏好删除复杂度而非搬运复杂度:相比只把同样的复杂度分散到多处的重构,更支持直接删除活动部件的简化。
  • 偏好直接、朴素、可维护的代码,警惕脆弱、临时或“魔法”行为,以及隐藏简单数据形状假设的通用机制。
  • 关注类型与边界整洁:质疑不必要的可选性、unknown、any 或大量强制转换;偏好显式类型模型或共享契约。
  • 要求逻辑位于规范层并复用已有辅助函数,指出功能逻辑泄漏到共享路径或实现细节透过 API 泄漏的问题。
  • 将不必要的串行编排和非原子更新视为设计气味:独立工作不应无故串行,相关更新不应留下半应用状态。

使用方式

技能以内置的基线提示词为起点,要求对当前分支改动做深度质量审计,重新思考如何组织结构以实现质量提升,改进抽象与模块化、减少意大利面代码、提升简洁性和可读性。在此基础上叠加不可协商的附加标准,并围绕一组主要审查问题逐项评估,例如:是否存在让实现大幅简化的“代码柔道”动作;变更是否改善了局部架构;是否在应有更好抽象处增加了分支复杂度;逻辑是否在正确的文件与层级;抽象是否真正物有所值;编排是否比必要更串行或更不原子等。

审查时按优先级输出发现:结构性质量回退、错过的重大简化机会、分支复杂度增加、边界/抽象/类型契约问题、文件大小与拆分问题、模块化与抽象问题、可读性与可维护性问题。若存在更大的结构性问题,不应用低价值的小问题淹没审查;偏好少量高置信度评论。

技能明确仅做审查:只返回发现与建议的整改方案;只有当用户另行请求时才应用修改或发布评论。报告由限定差异引入的问题,并用周边代码核实影响。被委派审查时直接完成,不再派生下级代理。

适用场景

适用于对代码改动进行极严格的可维护性审查,尤其是需要防止文件越过 1000 行、阻止零散特殊分支蔓延、清理薄包装与无效抽象、纠正类型边界模糊、发现功能逻辑放错层级或重复实现已有辅助函数的代码评审。也适合在合并前判断是否存在明显的结构性回退或错过的重大简化机会。

限制

该技能不直接修改代码、不自动应用修复、不发布评审评论,除非用户单独提出请求。审查对象为当前分支的改动及其周边上下文,不负责执行测试或验证运行时行为。技能资料未提供其在具体平台上的安装命令、调用接口细节或收费信息,这些事实暂未提供。