用途 address-pr-comments 用于批量处理一个拉取请求(PR)上的全部未解决评审评论,直到没有任何未解决线程为止。它适合在 PR 收到多条评审意见后,需要逐条回应并关闭讨论的场景。
主要能力
- 自动识别目标 PR:如果用户提供 PR 编号则直接使用;否则从当前分支的上游 PR 解析编号,若不存在则要求用户提供编号或仓库信息。
- 通过 GraphQL 列出所有未解决的评审线程,同时获取线程节点 ID(用于解决线程)和评论数据库 ID(用于在线程内回复)。
- 逐条阅读评论内容,提取 <details> 块中隐藏的可操作建议,结合当前代码判断该评论是否仍然有效。
- 分为两条处理路径:修复(修改文件、提交、推送,然后在线程内回复修复内容与提交 SHA)和反驳(不修改代码,在���程内给出具体技术理由)。
- 回复必须作为原评论的线程内回复(使用 in_reply_to 指向原评论的 databaseId),而非 PR 顶级评论。
- 回复后使用线程节点 ID 将线程标记为已解决,包括反驳的线程。
- 最后重新查询确认未解决线程数为 0,并报告修复数量、反驳数量和 PR 链接。
使用方式 该工具以技能形式提供,文档中给出的操作依赖 GitHub CLI(gh)命令与 GitHub GraphQL/REST API,包括:
- 用 gh pr view 解析当前分支对应的 PR 编号;
- 用 gh repo view 获取 OWNER/REPO 信息;
- 用 gh api graphql 列出评审线程与解决线程;
- 用 gh api repos/.../pulls/.../comments 配合 in_reply_to 在线程内回复。 文档还给出具体查询与变更命令示例,实际执行需具备相应仓库访问权限。
处理规则
- 每条评论都必须回复;不得只解决不回复,也不得只回复不解决(若线程无法解决,例如非线程形式的 diff 外评论,则以 PR 顶级评论记录处理结果)。
- 修复顺序为:修改→提交→推送→回复→解决,回复中引用修复的提交 SHA。
- 反驳顺序为:回复→解决,不提交不推送。
- 行动前先核对当前代码,评论可能指向已变更的代码;修改保持最小化;可能相互影响的评论逐条处理,独立的可批量处理。
- 判断修复还是反驳的依据包括:评论是否仍对应当前代码、是否与仓库规范冲突、是否属于仓库有意不强制执行的风格偏好、建议是否技术上不正确、是否超出本 PR 范围等;不确定时,低风险改动倾向修复,涉及较大架构决策则倾向反驳。
适用场景 适用于需要系统化清理 PR 评审意见、确保每条评论都有回应并被关闭的开发流程。
限制 文档未说明该技能的具体安装方式、运行环境依赖版本或收费信息,暂未提供。其操作依赖 GitHub CLI 与 GitHub API 访问权限。