用途
Thermo-Nuclear Code Quality Review 是一个用于执行极严格代码质量审查的技能。它主要针对当前分支的变更,旨在深度审计实现质量、可维护性、抽象质量和代码库健康度。审查者被要求对代码结构抱有雄心,不满足于局部清理,而是主动寻找“代码柔道”式的重构,使实现显著更简单、更小、更直接、更优雅,同时不改变行为。
主要能力
该技能定义了基线提示和一系列不可协商的附加标准。核心要求包括:对结构简化保持雄心,寻找能删除整个分支、辅助函数、模式、条件或层的重构机会;反对PR将文件从1000行以下推至1000行以上,除非有强有力的结构理由;高度怀疑在已有代码中随机增加临时条件、特殊分支或一次性布尔值;偏好将逻辑推入专用抽象、辅助函数、状态机、策略对象或独立模块;反对薄包装、身份抽象或仅添加间接层的辅助函数;强调类型和边界清晰,质疑不必要的可选性、unknown、any或大量类型转换;要求逻辑位于规范层并复用现有辅助函数;将不必要的顺序编排和非原子更新视为设计坏味道。
使用方式
该技能以提示词形式提供,用户可将其用于代码审查流程。审查从基线提示开始,然后应用附加标准。审查者需回答一系列主要审查问题,并积极标记特定模式(如复杂实现、未减少概念的移动重构、文件超1000行、特殊分支、特性逻辑泄漏到通用模块等)。审查还要求遵守可达性、行为固定和证据标准:每个要求删除、移动或合并接缝的发现都必须引用解析后的基础版本和头部提交,枚举接缝的实际消费者,指明必须保留的可观察行为及其证据,并描述移除的维护义务。发现需按可观察影响排序,包括正确性、数据或安全影响、生命周期和消费者破坏,然后才是结构。若变更可能导致部分状态,不得报告为成功。
适用场景
该技能适用于需要对代码变更进行深度质量审查的场景,尤其是关注可维护性、抽象设计和代码库长期健康时。它适合用于Pull Request审查,帮助识别结构性回归、错过的简化机会、意大利面条式分支增长、边界/抽象/类型契约问题、文件大小和分解问题、模块化和抽象问题以及可读性和可维护性顾虑。审查语气直接、严肃、对质量要求严格,但不粗鲁。
限制
该技能的批准门槛很高,存在以下情况时视为阻碍:PR保留了大量附带复杂性且有合理的代码柔道移动可以删除它;PR将文件从1000行以下推至1000行以上;PR添加了临时分支使现有流程更纠缠;PR通过在共享代码中散布特性检查来解决局部问题;PR添加了不必要的抽象、包装或类型转换严重的契约;PR重复了现有辅助函数或将逻辑放在错误的层。技能输出为分层报告,摘要约200行可一次读完,包含结论、每个发现的简短叙述段落、建议的修复顺序和指向详细文件的指针。详细文件包含测量、产生测量的命令、验证状态和详细的代码柔道提案。