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