SuperAPI AI 工具集

thermo-nuclear-review-loop

编程与开发

查看项目

更新于 10-16 04:06

技能介绍

用途

Thermo-Nuclear Review Loop 是一个迭代式代码审查与修复技能,运行在宿主会话(Claude Code 或 Codex)中。运行该技能的代理充当“修复者”:它启动一个独立审查者,独立验证审查者的发现,修复有依据的问题,并重复此过程,直到审查者明确批准。没有单独的修复者代理。

修复方案由修复者决定,范围由人类决定。当某个发现需要人类判断某个场景是否重要时,门控会把该问题交给人类,而不是让任一代理自行假设答案。

主要能力

  • 确定范围:读取仓库说明(AGENTS.md、CLAUDE.md、规则、README),从用户处获取审查目标(提交、分支、引用、范围、当前工作区改动或描述的历史功能),解析基线,并在编辑前检查状态。
  • 启动审查者:使用类似 Opus 的模型(默认计划中最高或次高模型),Claude 审查者以最高推理强度运行,Codex 审查者以高或更低强度运行。审查者可读取和运行命令,但不得编辑。
  • 验证后修复:审查者输出是线索而非命令。对每个发现进行复现或证明,检查仓库不变量、预期行为、历史理由和当前调用者,决定其正确、部分正确或不受支持。
  • 运行门控:当发现依赖于属于人类的决策时(如无当前调用者可到达的场景、上游已类型化数据的防御性检查、产品/需求歧义、破坏性或不可逆操作),将其批量提交给用户。
  • 实现与验证:每次迭代作为一个连贯的设计变更处理所有已验证的发现,优先删除概念、分支、重复状态和边界泄漏。采用 poka-yoke 而非防御性检查。运行仓库的构建和测试命令。
  • 重新审查:将迭代提交哈希、已定决策和被拒绝的发现及反证发送给同一审查者,要求其检查实际差异并重新应用完整标准。
  • 报告结果:报告结构性改进、被拒绝的发现及原因、规模变化、验证情况、最终审查者裁决和迭代提交。

使用方式

该技能通过宿主会话运行。用户提供审查目标,修复者代理按上述流程执行。审查者提示模板要求审查者阅读 REVIEW.md 或 Review Standard,并应用于解析后的范围。审查者裁决的开头必须命名所应用的标准并逐字引用其首尾行,否则视为未阅读标准。

适用场景

适用于需要对提交、分支、引用、范围、当前工作区改动或历史功能进行深度代码质量审查与修复的场景。审查标准按优先级涵盖:正确性与安全性、消费者不变量、破坏性或不可逆操作、偏离项目约定与重复判断、结构性回归与遗漏的简化。

限制

  • 审查者不得编辑代码;若审查者做出任何更改,循环停止并报告用户。
  • 循环仅在审查者明确批准时成功结束;通过测试不等于批准。
  • 每次返回阻塞项的通过计为一次不成功迭代;四次后暂停并询问用户是否继续。
  • 除非用户要求,否则不推送或发布。
  • 门控访谈不计入迭代次数。
  • 若引用无法解析或范围模糊,停止并询问。
  • 关于具体模型 ID、价格、平台支持等细节,资料中未提供。