SuperAPI AI 工具集

pr-sweep

通用与其它

查看项目

更新于 10-16 05:43

技能介绍

用途:整理 GitHub 拉取请求(PR)中尚未解决的评审讨论线程,判断哪些意见已被现有代码处理,回复并解决这些线程,其余事项则整理为可执行任务。

主要能力:

  • 读取当前分支 PR 的编号、URL、标题、基准分支与头分支等元数据。
  • 通过 GraphQL 查询未解决的 review threads,并用 jq 精简为 id、路径、行号、作者与评论内容。
  • 结合文件内容及 git diff(含 git diff <base>...HEAD -- <path> 与 git diff --cached <path>)判断评论是否已被处理,例如建议的修复已实现、相关重构使建议不再适用、风格命名结构问题已修正、缺失测试或文档已补上。
  • 在本地提交已全部推送到远端时才回复并解决线程;回复用一两句话说明处理方式,先回复再解决以便评审者看到上下文。
  • 对仍需处理的评论按文件分组,逐项创建任务,并在任务描述中包含评论原文、作者、文件路径、行号以及建议实现思路。

必要条件与使用方式:

  • 当前分支必须存在 PR,且 gh CLI 已完成认证,否则报告后停止。
  • 使用 gh 命令获取仓库与 PR 信息,通过 gh api graphql 查询、回复、解决线程。
  • 运行前会检查远端同步:比较本地 HEAD 与远端分支 SHA;若两者不一致或远端引用不存在,则跳过回复与解决,直接进入任务创建,并提示先推送更改。

限制与注意:

  • 只有反馈被完全处理时才标记为已解决;有疑问时应保持未解决并加入任务列表,避免误报。
  • 本地提交未推送时不回复也不解决,因为评审者无法看到所引用的改动。
  • 关于缺失测试或文档的评论,需确认确实已补充;关于重构建议,需确认新代码达成相同目标。
  • 输出包含自动解决评论、剩余评论与已创建任务三段;远端落后时仅列出“待推送后可自动解决”的项与剩余项。
  • 未提供关于收费、平台支持范围或依赖版本等更多信息。