用途:对指定代码变更执行只读、缺陷优先的审查,返回作者可能愿意修复的全部可执行发现。适用于其他智能体委托审查未提交变更等场景。
主要能力:直接检查目标并返回发现;读取适用的 AGENTS.md 指令;检查完整 diff 及足够上下文;识别变更引入的具体回归;检查相关测试与调用点确认发现真实可执行;按严重程度排序输出。
使用方式:先读取 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,不得编造。之后附简要总体评估及测试缺口或残余风险。
限制:仅在满足以下全部条件时标记问题——实质影响正确性、安全、性能或可维护性;离散可执行;由被审查变更引入;受影响场景或调用路径可从代码证明;作者知情后可能修复。不得标记推测性担忧、既有问题、有意行为变更或无关风格问题。不修改文件、不创建提交、不推送分支、不发布审查评论、不委托其他智能体。
跨客户端:GitHub Copilot 保持文件夹在可见技能路径,或在不支持文件夹发现时包装为项目指令;Claude Code 放在本地技能目录或兼容插件源;Codex 安装或同步到 $CODEX_HOME/skills/review-agent,重大变更后重启 Codex。
MCP:无需首选 MCP 服务器。回退提示为“Use the Review Agent skill without MCP. Rely on its local instructions, bundled resources, standard shell or editor tools, and direct verification. Show the evidence used before concluding.” 宿主未暴露 MCP 时不得声称使用了 MCP 操作;以本地文件、测试、渲染输出、日志或截图作为回退证据。
验证协议:确认请求匹配激活边界;必需输入、依赖与安全检查已解决或报告为阻塞;完成最窄相关工作流且未编造工具或结果;用最相关本地测试、检查、渲染或源码证据核对输出;在首选集成不可用时重复决策并确认回退安全可执行;结果、证据与未验证限制需明确到可被另一智能体复现。
相关技能:verification-before-completion、documentation-verification,在任务同时需要相邻验证或质量工作流时使用。