SuperAPI AI 工具集

address-pr-comments

编程与开发

查看项目

更新于 11-17 03:02

技能介绍

用途 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 访问权限。