diff-review 是一个代码审查技能,核心是读取差异、理解变更,只报告能指出具体位置的问题。其理念是:少量真实发现胜过大量主观意见。
【用途】 对当前分支相对基准分支的变更做审查,输出按严重程度分组的审查结果,并给出结论(如是否请求修改)。
【主要能力】
- 获取正确的 diff:优先使用用户指定的基准分支,否则依次尝试 main、master、develop;支持查看分支已提交变更、未提交变更、暂存区变更(git diff --cached)或单个提交(git show <sha>)。
- 变更量提示:diff 超过约 1500 行时会明确说明,优先审查高风险文件(认证、支付、迁移、公开 API、并发),并列出未覆盖部分。
- 先理解再判断:阅读提交信息与 PR 描述,用一句话概括变更意图;每个改动文件需打开完整文件而非只看 hunk;对改动的函数搜索调用方,发现签名或返回值变更带来的外部影响;同时避免重复报告项目工具链(linter、格式化、类型检查)已能捕获的问题。
- 按顺序检查:正确性(条件错误、边界、空值、异步处理、状态突变等)、安全(鉴权缺失、注入、密钥泄露、不安全反序列化等)、数据与迁移(破坏性 schema 变更、回滚丢数据、不向后兼容)、契约(公开 API、响应结构、事件或配置键变更无版本或迁移路径)、并发与性能(竞态、N+1 查询、无界循环、热点路径、缺索引)、测试(新行为无测试、无法失败的测试、删除断言)、可维护性(仅限会导致缺陷或真实困惑的问题)。
- 严重程度分级:Blocker(会破坏生产、丢数据或开安全漏洞,不应合并)、Major(可能的缺陷或高风险逻辑缺测试)、Minor(真实但影响小)、Nit(工具链未捕获的风格命名问题);不确定时选较低级别并说明原因。
- 报告格式:引用新版本文件的行号,每条包含文件:行号、问题描述和修复建议;缺失测试可只给文件。最后列出未审查内容和结论。
【使用方式】 以技能形式调用,用户可指定基准分支或审查范围;审查过程中除非被要求,否则不修改文件。
【适用场景】 分支合并前的自查、PR 评审辅助、高风险变更(认证、支付、数据库迁移)的重点排查。
【限制】 不报告工具链已能发现的问题;不赞美、不逐行复述 diff;无法说明具体后果的发现应丢弃;不替代人工判断。更多安装方式与调用细节暂未提供。