SuperAPI AI 工具集

review-agent

编程与开发

查看项目

更新于 11-08 01:12

技能介绍

用途: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,不为填充结果而虚构问题。问题之后附简短总体评估,并提及重大测试缺口或残余风险。

使用方式与限制:该技能为只读审查,不修改文件、不创建提交、不推送分支、不发布审查评论,也不把审查委派给其他代理。资料未提供安装命令、收费方式、平台支持或具体调用接口,暂未提供。

适用场景:适合代理间委派代码审查、未提交改动检查、基线分支合并前审查,以及需要按严重程度输出可操作缺陷清单的工程流程。