SuperAPI AI 工具集

code-quality-review

编程与开发

查看项目

更新于 10-16 04:32

技能介绍

用途:评估某次改动引入的结构是否造成实质性的维护或正确性负担。全程只读,保留已接受的行为、范围、契约、输出形态、产物路径、验证边界与证明;未经单独授权不修复、不提交、不发布。

主要能力:阅读完整选定 diff 及建立约定与消费者所需的邻近代码;仅在有用时参考相关指引与可用的专家技能。审查重点为有后果的重复、所有权冲突、可避免的耦合,或使当前行为更难维护与验证的抽象。更短的等价实现本身不构成问题。需指出具体受影响的消费者、不一致规则或可支撑的维护成本,不得以臆想的未来复用、规模或风险来支撑偏好。当原语的契约、所有权或生命周期变化时,核实其事实来源、当前消费者与依赖方向。优先一致复用或扩展,而非新增机制,但不要求重做已接受的充分方案。

发现与结论:每条发现须对已接受任务有具体后果。省略吹毛求疵、等价命名/风格选择、表面简化、推测性抽象、无关清理与既有债务。合并重复原因,无发现配额。must_fix 仅用于实质不变量违反或已验证的正确性、契约、测试可靠性风险,并说明为何未解决即不安全;风格约定与纯粹优雅不能阻塞。有后果但非阻塞的结构观察可作为 advisory。无发现属正常。跟进时保留已接受决定;新证据表明实质缺陷仍有效,需说明为何改变决定。仅对实质未决主张运行窄范围非破坏性检查,规范门禁由验证阶段负责。每条发现含标题、严重度(Critical、High、Medium、Low)、位置、问题、建议、理由与 must_fix;严重度是影响而非门禁,不得夸大。最终以 pass、needs_changes 或 blocked 结束。结构化调用只返回调用方的 JSON 契约。不得编辑被审查文件。

限制:不执行第二次通用正确性审查;不修复、不提交、不发布;不扩大权限;不编辑被审查文件。