SuperAPI AI 工具集

thermo-nuclear-code-quality-review

编程与开发

查看项目

更新于 10-15 21:10

技能介绍

用途:对当前分支的变更做一次极其严格的、以可维护性为核心的代码质量审计,聚焦结构简化、抽象质量与代码库健康度。仅在用户明确要求该审查模式时使用。

主要能力:默认只读审查,先确定比较范围并查阅仓库说明,再按优先级给出带文件和行号证据的发现。审查鼓励寻找“code judo”式重构——在保持行为不变的前提下让实现明显更简单、更小、更直接、更优雅;主动识别可整层删除的分支、助手、模式、条件或层级。

关注点:文件从不足 1000 行被推到超过 1000 行;在无关流程中新增一次性条件、零散特例或标志位;功能逻辑泄漏到共享路径;薄包装、恒等抽象、无谓的 cast/any/optional;重复逻辑未抽取助手;逻辑放错包或层;无谓的串行编排与非原子更新。

建议做法:删除整层间接而非打磨;重构状态模型让条件消失;调整归属边界;抽取助手或纯函数;拆分大文件;用类型模型或显式分发替代条件链;复用既有规范工具而非近似重复实现。

审查基调:直接、严肃、对质量要求高,但不对人失礼;不要把重大可维护性问题淡化为轻微建议。输出顺序优先结构回归、被错过的显著简化机会、分支复杂度增加、边界与类型契约问题,其次才是文件体积、模块化与可读性,避免用大量低价值琐碎意见淹没结构问题。

批准门槛:不因行为看似正确就批准;无明确结构回归、无可见的重大简化机会被遗漏、无无理由的文件膨胀、无明显特例分支蔓延、无难以推理的魔法抽象、无无谓包装与 cast 变更、无架构边界泄漏或规范工具重复、无被遗漏的明显分解。上述情况视为推定阻塞项,除非作者能清楚说明理由。

限制:默认不修改代码,只有在用户另行要求实现时才编辑;该技能改编自 Cursor 以 MIT 许可发布的原始技能,原始仓库为 https://github.com/cursor/plugins。