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 文件。
范围识别
按以下优先顺序确定审查对象:
- 用户指定的 PR URL、比较分支、文件、选中范围、粘贴的 diff;
- 暂存变更:git --no-pager diff --staged;
- 未暂存变更:git --no-pager diff;
- 工作区干净时: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 模式下完成最小修复后执行了聚焦验证。