SuperAPI AI 工具集

gh-address-comments

编程与开发

查看项目

更新于 10-16 06:03

技能介绍

用途

gh-address-comments 用于帮助处理当前分支上打开的 GitHub Pull Request 的评审评论(review comments)与 issue 评论。它通过 gh CLI 定位该 PR,并引导用户逐条处理需要关注的评论。

主要能力

  • 查找当前分支对应的打开 PR,并获取其评论与评审线程。
  • 通过运行 scripts/fetch_comments.py 打印出 PR 上的所有评论和评审线程。
  • 对评审线程和评论进行编号,并给出应用修复所需的简要说明。
  • 根据用户选择的编号,对相应评论应用修复。

使用方式

  1. 前置条件:确保 gh 已完成身份验证(例如先运行一次 gh auth login),然后以提升的权限运行 gh auth status(包含 workflow/repo 权限范围),使 gh 命令能够成功执行。如果沙箱阻止 gh auth status,需以 sandbox_permissions=require_escalated 重新运行。
  2. 检查需要关注的评论:运行 scripts/fetch_comments.py,它会打印出 PR 上的所有评论和评审线程。
  3. 向用户请求澄清:对所有评审线程和评论进行编号,并提供应用修复所需的简要说明,然后询问用户应处理哪些编号的评论。
  4. 如果用户选择了评论:对选定的评论应用修复。

注意:所有 gh 命令都应在提升的网络访问权限下运行。如果 gh 在运行过程中遇到认证或速率限制问题,应提示用户使用 gh auth login 重新认证,然后重试。

适用场景

适用于开发者需要集中处理当前分支 PR 上评审意见和 issue 评论的场合,尤其是希望借助 gh CLI 与脚本自动化获取评论、并逐条确认修复范围的流程。

限制

  • 依赖 gh CLI 且需要预先完成身份验证,并具备相应的 workflow/repo 权限范围。
  • 在沙箱环境中可能需要提升权限(sandbox_permissions=require_escalated)才能运行 gh auth status。
  • 运行中可能遇到认证或速率限制问题,需要用户重新认证后重试。
  • 关于具体支持的操作系统、安装方式、收费情况等,资料暂未提供。