SuperAPI AI 工具集

deep-review

通用与其它

查看项目

更新于 10-16 08:06

技能介绍

用途:deep-review 用于对分支、PR 或 diff 做深度代码审查。它的核心判断是:通过普通审查的 bug 往往不在 diff 里,而在三文件之外假设了旧返回类型的调用方、仍调用已删除方法的任务、需要同样修复的第二条代码路径。该技能追踪改动的影响半径,并修复已确认的问题。

主要能力:先确定范围与意图,读取 PR 描述、关联 issue、已有评论与 git log,并查找 .scratch/<branch>/spec.md 与 plan.md 作为衡量标准;读取仓库的 CLAUDE.md、AGENTS.md、CONTRIBUTING.md、REVIEW.md 和 lint 配置以了解项目规则。随后运行 scripts/change_map.py <base-ref>(或 --diff <file>)生成改动映射,列出变更文件与增删改的标识符及其所有引用位置,作为排查队列。对每个改动的函数、类、常量、schema 字段、路由、配置键、环境变量或查询,检查调用方、被调用方、同类模式、数据流、状态与持久化、历史与测试。再进行计划与规格符合性检查,以及对抗性 bug 类别清单与对应技术栈文件(django-stack.md 或 rails-stack.md,使用 Stripe 时读相关章节)的检查。之后执行能运行的测试、类型检查和 lint,复现运行时断言,筛除已处理与不显著的问题,最后按严重级别修复。

使用方式:GitHub PR 用 gh pr view <n> 和 gh pr diff <n>;分支用 git diff <base>...HEAD;粘贴的 diff 按原样使用并说明无法追踪其外部影响。每个确认的修复做最小改动,补充或调整本应捕获它的测试,单独提交并命名问题,例如 fix: guard nil company on revision export (review)。每个修复后重新运行测试与类型检查。若分支有 PR,推送修复提交以便机器人重跑。

审查原则:每个发现都要在代码中验证(打开文件、读调用方、跑测试),无法确认就丢弃;只报会改变作者合并决定的重要问题,风格与 lint 输出除非用户要求否则不报;确认的 BLOCKER 与 MAJOR 问题在分支上修复,MINOR 在局部且明显时修复,无法安全修复的带原因报告。严重级别分为 BLOCKER、MAJOR、MINOR、NOTE。报告包含 Summary、Fixed、Open findings、Plan and spec、Verified、Not covered 等章节,摘要用两到四句话。完整追踪后零发现也是好审查。若同一类错误在仓库中第二次出现,可在报告中建议向 CLAUDE.md 或 AGENTS.md 添加一行。用户反驳时重新打开代码核对,而非凭记忆辩护。

限制:本技能依赖 git、gh、rg 等工具及脚本运行环境;对粘贴的 diff 无法追踪外部影响;无法运行的内容需声明并标注运行时相关发现为未验证;修复仅限于分支范围,需要作者决策、超出范围或改变规格时改为报告并给出建议修复。