SuperAPI AI 工具集

gs-review-pr-reply

编程与开发

查看项目

更新于 11-15 16:33

技能介绍

用途

gs-review-pr-reply 用于把 /gs-review 生成的审查报告发布到当前分支对应的 GitHub Pull Request 上。它不会重新审查代码,而是将已有报告整理为一次审查提交,包含一条概述评论和若干行内评论。

主要能力

  • 发布审查:将报告中的每个发现项作为行内评论挂在变更行上,无法挂行内的放入概述。
  • 选择发现项:接受自由文本选择提示,例如“只发布阻塞项”、“1 和 3”、“跳过测试覆盖项”、“只发第二个模型确认的”。无提示时发布全部。
  • 过期检测:当 HEAD 与 PR headRefOid 不一致或工作区有未提交变更时,标记报告为过期,但仍可发布,并在草稿中说明。
  • 去重:跳过已在 PR 上存在相同路径、相同行且评论体以归属标注开头的发现项。
  • 行内定位:仅当发现项的文件:行位于 PR diff 右侧(新增行或 hunk 内上下文行)且 PR head 在该行包含对应代码时,才添加行内评论。
  • 草稿审批:在发布前打印草稿(概述渲染、各路径:行的行内评论、跳过项及原因、未决项标记、过期提示),等待用户批准后才提交。
  • 提交方式:使用 gh api 以 COMMENT 事件提交一次审查,payload 写入仓库外文件并通过 --input 传入,避免评论内容成为 shell 语法。

使用方式

  1. 确保当前对话中存在最近的 /gs-review 报告,或用户粘贴了报告;否则停止并提示先运行 /gs-review [base ref]。
  2. 依次执行命令获取 PR 信息、用户登录名、HEAD、工作区状态、PR diff 和已有评论。
  3. 根据选择提示将发现项分类为发布或跳过,并记录跳过原因。
  4. 判断每个发现项能否行内评论,其余放入概述。
  5. 按 gs-pr-comment 技能(若已安装)或内置模板撰写评论,包括概述、失败视图、修复建议、证据和合并危险部分。
  6. 打印草稿并请求用户批准,应用用户要求的修改后再次展示。
  7. 用户批准后,通过 gh api 提交审查,输出返回的 html_url 及行内评论数量。

适用场景

适用于已经运行过 /gs-review 并希望把审查结果以结构化评论形式发布到 GitHub PR 的用户。需要本地已安装 gh CLI 并具备对应仓库的评论权限。

限制

  • 必须存在 /gs-review 报告和对应的 PR,否则停止。
  • 只能发布评论,不执行批准、请求更改、解决讨论或推送修复。
  • 行内评论若指向 diff 外行会导致 GitHub 拒绝整个审查,因此需逐行核对 hunk 范围。
  • 评论撰写需遵循 gs-pr-comment 技能规则;未安装时使用内置模板。
  • 发布前需人工检查评论中是否包含密钥、令牌、绝对本地路径和私人信息。
  • 报告过期时仍可发布,但需在草稿中说明。