用途:为 feature/bugfix/refactoring 类 PR 生成审查报告,既辅助常规代码审查,也可作为实现者的自查工具,目标是让 PR 达到可供人工审阅的"清醒"状态。库更新 PR(dependabot/renovatebot 等)不属于本技能范围,由 library-update-review 处理。
主要能力:按固定步骤执行审查——先确认执行环境(要求 Claude Opus 以上 tier,或 Codex CLI 具备 Sol 以上 flagship 且 reasoning effort 为 medium 以上)、取得 PR 信息并确认报告输出位置;随后读取对话上下文(来源为 PR 评论中的"对话上下文"或 .dev/contexts/{分支名}.md);对 PR 概要栏按 4 项检查表做质量评价;核对实现者说明与实现的一致性;检查命名与设计模式是否符合既有惯例;借助外部 Agent 调查 bug 与漏洞并自行验证其指摘;有对话上下文时再核对设计判断、被驳回的替代方案、失败尝试、刻意不处理事项及事实准确性;最后按同目录 TEMPLATE.md 生成报告。
使用方式:PR 编号或 URL 可作参数指定,否则自动检测当前分支关联的 PR。常用命令包括 gh pr view {PR编号或URL} --json number,title,body,url,author,comments,headRefName、gh pr diff {number},以及 gh api repos/{owner}/{repo}/pulls/{number}/comments --paginate 与 gh api repos/{owner}/{repo}/pulls/{number}/reviews --paginate。外部 Agent 咨询按 codex-consultation、subagent-consultation、main agent 单独执行 的顺序回退,咨询时需指定深度。
适用场景:需要生成结构化 PR 审查报告、核对实现者说明与代码一致性、审查设计取舍过程,或让实现者自查时。
限制:不适用于库更新 PR;执行环境不满足要求时停止审查;缺少对话上下文时跳过考虑遗漏的确认步骤,或请用户先行准备;外部 Agent 不可用导致回退到 main agent 单独执行时,审查精度不完整,报告中会给出相应警告。费用、价格与具体支持平台等细节资料暂未提供。