SuperAPI AI 工具集

code-review-multi-angle

编程与开发

查看项目

更新于 11-11 22:14

技能介绍

code-review-multi-angle

对指定的代码差异、PR、选中代码范围、文件或当前 Git 变更,以只读方式审查。

何时使用

适合以下场景:

  • 在合并前、提交前或创建 PR 前审查代码变更;
  • 同时查看类似 /review 的缺陷审查和类似 /security-review 的安全审查;
  • 收到“多角度审查”“严格审查”“检查是否有重大遗漏”等请求;
  • 明确要求“审查并修复”“fix”“改一下”,并包含审查后的修复。

不适合以下场景:

  • 文体、文档、文章、工作流定制的结构审查,应使用专用提示词、智能体或技能;
  • 发布前完整 QA、产品级反复改进、release/publish/version sync,应使用 refine-product-100。

模式

默认是 review-only:不编辑代码,只给出发现项(finding)和修复方案。

只有明确出现 fix、“修正一下”“改一下”等指令时,才进入 review-and-fix 模式:执行审查、批评者复核、修复和聚焦验证。

在 fix 模式下,破坏性操作、对外发布、改写历史、push、大规模重构,执行前也必须确认。

fix 模式的分类与范围

一次审查中,将发现的问题分为:

  • Fix now:只处理请求范围内、非破坏性、可在本地验证,并且能说明正确性的问题,采用最小差异修复。
  • Guard now:修复本身较难,但可通过测试、静态检查、文档或确认步骤中的至少一项降低风险,则产出相应成果。
  • Block:涉及破坏性操作、外部公开、规格判断、secret、生产数据或权限不足的问题,不执行,只报告。

无法安全编辑的 Fix now 不得只留在审查结果里,应转为 Guard now 或 Block。

Sweep 只横向检索与已修问题相同根因的问题,例如用字符串、函数名、类型、错误信息、配置键搜索;仅在概念上接近的其他改进,或不同维度的质量改进,放入 Next Steps。

验证失败时,应分析原因;对同一原因最多进行 2 轮修复和重新验证,之后保留为 Block。

学习点只以 Learnings Candidate 的形式提出;只有用户明确要求时,才写入 instruction 或 review-learnings 文件。

范围识别

按以下优先顺序确定审查对象:

  1. 用户指定的 PR URL、比较分支、文件、选中范围、粘贴的 diff;
  2. 暂存变更:git --no-pager diff --staged;
  3. 未暂存变更:git --no-pager diff;
  4. 工作区干净时:git --no-pager diff main...HEAD。

若仓库自然以非 main 分支为基线,应先确认分支名或 upstream,再使用。

审查视角

至少从 3 个独立视角审查同一对象。

1. 正确性与回归

  • 是否破坏规格、既有行为、边界条件;
  • 在 null、空值、缺失、重复、乱序、并发输入下是否出错;
  • 是否破坏 public API、schema、CLI 合约、输出格式的兼容性;
  • 是否因错误处理不足导致崩溃、数据丢失或部分更新。

2. 安全与信任边界

  • 是否存在注入、路径遍历、SSRF、不安全反序列化、原型污染;
  • 是否越过认证、授权、权限边界、租户/仓库/工作区边界;
  • 是否将 secret、token、PII、内部 URL、堆栈跟踪泄漏到日志或输出;
  • 不可信输入是否混入 LLM 提示词、工具路由、shell 命令、URL 或文件路径。

3. 可靠性、运维与可维护性

  • retry、timeout、幂等性、清理、回滚、恢复等必要环节是否缺失;
  • 性能影响是否出现可测量的恶化;
  • 是否避开构建产物、生成文件、大量 diff 导致的误报;
  • 是否偏离既有模式、邻近实现和测试方针。

噪声过滤

只报告读者实际值得修复的发现项,分为 Critical / High / Medium / Low;Low 只要有依据且修复有价值也可报告。

不报告:

  • 风格、格式、命名、个人偏好的设计;
  • 语法、拼写、注释文字的轻微改进;
  • “最好”“一般来说”级别的 best practice;
  • 修复后不影响需求成果的重构。

不确定的发现项不报告,改为在 Assumptions / Not Reviewed 中简短记录。

批评者复核

对于非显而易见的变更、安全发现项、多文件变更或 fix 模式,应通过可用的 rubber duck / critic 途径再次核对审查结果:

  • 可用时使用 native Rubber Duck、duck-critic 技能、只读子代理或另一模型的 critic;
  • critic 保持只读,不负责修改或改变状态;
  • 对 critic 的指出去重,只把实际采纳的写入发现项或修复;
  • 若无法使用 critic 途径,自行做第二遍审查,并在 Verification 中说明未能使用的原因。

验证

尽可能在给出发现项前进行只读或低风险确认:

  • 检查周边代码、现有测试、调用点、schema、README、配置;
  • 必要时运行 compile / typecheck / lint / 聚焦测试;
  • 无法执行时,写明原因和替代确认方式;
  • review-only 下不编辑代码,也不创建、修改、删除文件;
  • fix 模式下,在批评者复核后做最小修复,并执行聚焦验证。

输出格式

先按严重度给出发现项:

Review Findings

1. {短标题}

  • Severity: Critical | High | Medium | Low
  • Lane: Correctness | Security | Reliability
  • File: {path}:{line}
  • Problem: {实际发生的问题}
  • Evidence: {从差异、周边代码、测试、规格确认的依据}
  • Suggested Fix: {实现方案,不修改代码}

No Significant Issues

{仅在无发现项时,用一行说明未发现重大问题的原因}

Assumptions / Not Reviewed

  • {未确认范围、未能执行的验证、前提;无则 None}

Fixes Applied

  • {仅 fix 模式,列出修改的文件和理由,包括分类(Fix now / Guard now / Block)与 Sweep 结果;review-only 为 None}

Learnings Candidate

  • {希望持久化的学习候选;无则 None}

Verification

  • {已执行的确认,或未执行原因}

不输出赞美、冗长工作日志或已查看文件的完整列表。

完成标准

  • 已确定目标差异或指定范围;
  • 已从 3 个以上视角检查;
  • 发现项只保留可执行的,并分为 Critical / High / Medium / Low;
  • 非显而易见的审查或 fix 模式已进行批评者复核,或注明替代第二遍审查;
  • 尽可能完成依据确认或聚焦验证;
  • review-only 下未修改代码;
  • fix 模式下完成最小修复后执行了聚焦验证。