用途
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 语法。
使用方式
- 确保当前对话中存在最近的 /gs-review 报告,或用户粘贴了报告;否则停止并提示先运行 /gs-review [base ref]。
- 依次执行命令获取 PR 信息、用户登录名、HEAD、工作区状态、PR diff 和已有评论。
- 根据选择提示将发现项分类为发布或跳过,并记录跳过原因。
- 判断每个发现项能否行内评论,其余放入概述。
- 按 gs-pr-comment 技能(若已安装)或内置模板撰写评论,包括概述、失败视图、修复建议、证据和合并危险部分。
- 打印草稿并请求用户批准,应用用户要求的修改后再次展示。
- 用户批准后,通过 gh api 提交审查,输出返回的 html_url 及行内评论数量。
适用场景
适用于已经运行过 /gs-review 并希望把审查结果以结构化评论形式发布到 GitHub PR 的用户。需要本地已安装 gh CLI 并具备对应仓库的评论权限。
限制
- 必须存在 /gs-review 报告和对应的 PR,否则停止。
- 只能发布评论,不执行批准、请求更改、解决讨论或推送修复。
- 行内评论若指向 diff 外行会导致 GitHub 拒绝整个审查,因此需逐行核对 hunk 范围。
- 评论撰写需遵循 gs-pr-comment 技能规则;未安装时使用内置模板。
- 发布前需人工检查评论中是否包含密钥、令牌、绝对本地路径和私人信息。
- 报告过期时仍可发布,但需在草稿中说明。