用途:获取当前分支对应 GitHub PR 的全部评审评论并展示给用户,本身只做信息呈现。
主要能力:脚本经 gh api --paginate 抓取三类内容——PR 级 issue 评论、diff 上的行级/文件级评论、带文本的 code review;会裁剪过大的 diff hunk 至评论行附近;为回复评论设置 reply_metadata,为顶层 diff 评论设置 location_metadata(文件路径、裁剪后的 diff、行号、side);PR 级评论无 location 与 reply 元数据。
使用方式:需在已打开 PR 的 git 仓库当前分支中运行,并设置 do_not_summarize_output: true 以免 JSON 被截断:python3 {{skill_dir}}/scripts/fetch_github_review_comments.py,脚本将 JSON 打印到 stdout,再用 insert_code_review_comments 传入 local_repository_path、base_branch、comments 三个字段。脚本失败时改用 fallback:先用 gh pr view --json number,url,baseRefName 找 PR 号与 base 分支,并据 PR URL 解析出 {owner_login}/{repo_name}(评论位于 base 仓库,从 fork 开的 PR 也须用 base 仓库,否则 404);再分别调用 issues/{pr_number}/comments、pulls/{pr_number}/comments、pulls/{pr_number}/reviews 端点(reviews 过滤出 body 非空者),并清除 GH_PAGER 避免分页,例如 GH_PAGER="" gh api ...。
限制与注意事项:要求 gh CLI 已认证且有仓库权限、当前分支存在打开的 PR。展示评论后必须停下询问用户如何继续,未经明确指示不得改代码、不得代用户提交回复;无评论时用该工具返回空列表,且不要在不调用工具的情况下直接朗读评论内容。