结构化代码审查
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_07e78b9e/code-review-walter。
技能介绍
要解决什么问题
PR 或本地改动一多,review 很容易变成「顺手改命名、整文件格式化」的扩 scope 讨论,或者泛泛而谈、找不到对应 diff 行。更麻烦的是:任务只要求改 A,却静默破坏了 B 的兼容逻辑——这类需求外影响往往在 merge 后才暴露。
本技能把 review 约束在可验证的边界上:有 仅变更代码 与 全量(仍优先本次改动) 两种模式;没有 diff 时先收集变更,不凭空点评。
工作方式
- 收集变更:并行确定 review 边界(base 分支、变更文件、hunk 增删改、任务目标)。
- 理解需求边界:明确「要求改什么」与「理论上不应动什么」,后续结论都对照这条线。
- 三项核心检查(按优先级扫 diff 每一处):
- A. 需求外影响:是否超出任务描述、动了公共 API/鉴权/错误契约、引入行为回归等;疑似越界时标出 hunk 并说明风险。
- B. 冗余:重复逻辑、死代码、与现有工具重复的实现、可用更小 diff 达成的写法。
- C. 逻辑漏洞:边界条件、分支与状态、错误传播、数据流与安全类问题。
- 输出报告:每条发现必须引用文件 + 行号或 diff hunk,避免空泛结论。
适用边界
- 默认只读 review,除非你明确要求修复。
- 仅变更代码模式下,不对未改动代码提「顺便可以改」类建议(除非与本次 bug 直接相关)。
- 需要上下文时只读理解变更意图所需的最小范围,结论仍只针对 diff 中的行。
使用场景
- 合并前要求助手只审查当前分支相对 main 的 diff,并标出是否改了鉴权或公共 API
- 用户说明「仅看已变更代码」,在 feature 提交后核对改动是否超出任务描述里的重构范围
- 发版前对 hotfix 的 hunk 做逻辑漏洞检查,重点看空值、错误传播与行为回归
- Review 多人协作 PR 时,按文件列出冗余实现与可合并分支,并要求每条结论对应具体行号
适合人员
- 负责合入主干、需要在 diff 上确认「需求外影响」的后端或全栈维护者
- 开 PR 前想自检变更边界与逻辑漏洞、且希望报告带 hunk 引用的功能开发者
- 带新人改公共模块时,要对照任务边界审查是否误动配置、降级或兼容逻辑的 Tech Lead
- 收到「只 review diff」指令的代码助手使用者,需要结构化输出而非整库泛泛点评