SuperAPI AI 工具集

review-agent

编程与开发

查看项目

更新于 11-02 23:20

技能介绍

用途 review-agent 用于对指定的代码变更执行只读、以缺陷为先的审查,并返回每一条作者很可能愿意修复的可执行发现。典型使用场景是另一个智能体委托它审查未提交的改动,或进行基于分支的审查。

主要能力

  • 读取适用的 AGENTS.md 指令。
  • 检查请求目标的完整 diff,并阅读足够的周边代码以理解每条变更路径。
  • 识别变更引入的具体回归,并在发现第一个问题后继续遍历整个 diff。
  • 检查相关测试和调用点,确认每条发现真实且可执行。
  • 对于基于分支的审查,比较实际会合并的变更,而不是直接与分支顶端做 diff:当上游存在且领先本地分支时,将比较引用解析为该分支的上游,否则使用本地分支;运行 git merge-base HEAD <comparison-ref>,再检查 git diff <merge-base-sha>;若本地分支无法解析,先显式尝试其配置的上游,再报告目标不可用。

使用方式与输出格式 技能只读运行,不修改文件、不创建提交、不推送分支、不发布审查评论、不委托审查。结果先列发现,按严重程度排序,每条问题使用如下格式:[P1] 祈使式发现标题 — path/to/file.rs:line,随后用一段短文说明受影响场景及为何行为有误。引用范围尽量小,并确保与被审查 diff 重叠。优先级为:P0 通用发布阻断或严重失败;P1 应尽快修复的紧急缺陷;P2 应修复的普通缺陷;P3 影响低但仍值得修复的问题。若无合格发现,输出 No findings,不编造发现。发现之后附简短总体评估,并提及重要测试缺口或残余风险。

适用场景 适合智能体间的代码审查委托,尤其是对未提交改动或分支变更做缺陷优先的只读审查。

限制 只报告同时满足以下条件的发现:显著影响正确性、安全性、性能或可维护性;离散且可执行;由被审查变更引入;受影响场景或调用路径可从代码中证明;作者知情后可能修复。不报告推测性担忧、既有问题、有意的行为变更,或不影响代码可读性的风格挑剔。