SuperAPI AI 工具集

load-pr-review

编程与开发

查看项目

更新于 10-16 04:13

技能介绍

用途

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。
  • 具体收费、价格、平台支持等信息暂未提供。