用途
gh-address-comments 用于帮助处理当前分支上打开的 GitHub Pull Request 的评审评论(review comments)与 issue 评论。它通过 gh CLI 定位该 PR,并引导用户逐条处理需要关注的评论。
主要能力
- 查找当前分支对应的打开 PR,并获取其评论与评审线程。
- 通过运行 scripts/fetch_comments.py 打印出 PR 上的所有评论和评审线程。
- 对评审线程和评论进行编号,并给出应用修复所需的简要说明。
- 根据用户选择的编号,对相应评论应用修复。
使用方式
- 前置条件:确保 gh 已完成身份验证(例如先运行一次 gh auth login),然后以提升的权限运行 gh auth status(包含 workflow/repo 权限范围),使 gh 命令能够成功执行。如果沙箱阻止 gh auth status,需以 sandbox_permissions=require_escalated 重新运行。
- 检查需要关注的评论:运行 scripts/fetch_comments.py,它会打印出 PR 上的所有评论和评审线程。
- 向用户请求澄清:对所有评审线程和评论进行编号,并提供应用修复所需的简要说明,然后询问用户应处理哪些编号的评论。
- 如果用户选择了评论:对选定的评论应用修复。
注意:所有 gh 命令都应在提升的网络访问权限下运行。如果 gh 在运行过程中遇到认证或速率限制问题,应提示用户使用 gh auth login 重新认证,然后重试。
适用场景
适用于开发者需要集中处理当前分支 PR 上评审意见和 issue 评论的场合,尤其是希望借助 gh CLI 与脚本自动化获取评论、并逐条确认修复范围的流程。
限制
- 依赖 gh CLI 且需要预先完成身份验证,并具备相应的 workflow/repo 权限范围。
- 在沙箱环境中可能需要提升权限(sandbox_permissions=require_escalated)才能运行 gh auth status。
- 运行中可能遇到认证或速率限制问题,需要用户重新认证后重试。
- 关于具体支持的操作系统、安装方式、收费情况等,资料暂未提供。