用途
load-pr-review 用于把 GitHub Pull Request 上的评审评论加载进 AI 会话,对每条评审线程进行分析、分类(triage)并生成处理计划。它的核心定位是分析工具:默认只读取和分类,不修改代码。
触发关键词包括:load pr review、pr feedback、address review、review comments、pr comments。
主要能力
- 解析 PR 目标:支持参数中直接给出 PR 编号、URL,或基于当前分支通过 gh pr view 推断。
- 拉取评审评论:通过 gh CLI 的 GraphQL(reviewThreads)获取,GraphQL 失败时回退到 REST。输出归一化 JSON,包含线程 id、文件路径、行号、是否已解决、是否过时、回复目标 id 及评论内容。
- 逐线程独立评估:在 plan 和 fix 模式下,对每个未解决线程调用 /seek-verdict,每个线程使用全新的 Codex 上下文,避免线程间相互影响。
- 分类与报告:将线程映射为 ACTIONABLE(FIX_REQUIRED)、Likely Non-Actionable(DISMISS_VERIFIED)、Needs Discussion(DISMISS_CANDIDATE / NEED_HUMAN)等分组,并按优先级(code_change、doc_update、question、disagree、nit)呈现。
- 可选写回:通过 --writeback 在用户批准后逐条回复并可选解决线程。
使用方式
基本调用:/load-pr-review [args]。
模式:
- plan(默认):读取代码,不编辑,不写回,输出分析报告。
- summary:轻量展示线程表格,不读取代码,不做 verdict 评估。
- fix:需显式 --mode fix,读取并编辑代码(编辑前需 AskUserQuestion 确认),仅在配合 --writeback 时写回。
数据面脚本调用示例:
bash scripts/run-skill.sh load-pr-review load-pr-review.js
fetch --pr <N> --repo <owner/repo> [--all] [--budget <N>]
写回 dry-run:
bash scripts/run-skill.sh load-pr-review load-pr-review.js
writeback --plan --input <json-path> --threads <IDs>
写回执行:
bash scripts/run-skill.sh load-pr-review load-pr-review.js
writeback --execute --thread <ID> --reply "<message>"
--replyTargetId <databaseId> --repo <owner/repo> --pr <N> [--resolve]
相关标志:--no-verdict 跳过逐线程 verdict 评估;--markdown 输出可读表格;--all 与 --budget 控制 token 预算(默认 30,--all 为 200)。
适用场景
- 需要梳理 PR 上大量评审反馈并制定修复计划时。
- 希望借助独立评估判断哪些评论真正需要处理、哪些可忽略时。
- 在明确授权后批量回复并解决评审线程时。
限制与约束
- 默认仅分析,禁止自动修复;plan 模式不写文件。
- fix 模式必须显式指定,且编辑前需用户确认。
- plan/fix 模式下必须逐线程调用 /seek-verdict(除非 --no-verdict),不得仅凭 AI 判断分类。
- 评审评论被视为不可信内容,使用 [USER_CONTENT_START]/[USER_CONTENT_END] 标记包裹并剥离指令。
- 写回必须使用 replyTargetId,正文通过 jq + 临时文件 + --input 传输,避免 shell 插值;缺少 replyTargetId 时降级为仅计划。
- 若超过 60% 线程得到 DISMISS_VERIFIED,会发出 [VERDICT_TRIAGE_WARN];verdict 调用失败时线程标记为 UNCERTAIN。
- 具体收费、价格、平台支持等信息暂未提供。