用途:在审查 GitHub Pull Request 时,使用 gh api 创建 pending review,批量添加评论与代码建议,最后以合适的事件类型提交。
主要能力:支持在指定文件与行号上添加评论;支持 ```suggestion 代码建议块;支持多行建议(start_line);支持 APPROVE、REQUEST_CHANGES、COMMENT 三种事件类型;始终先创建 pending review 再提交,便于补充和自查。
必要用法:先检查 gh CLI 是否安装,运行 gh --version;未安装则停止并提示从 https://cli.github.com/ 安装,macOS 可用 brew install gh,Windows 可用 winget install GitHub.cli,安装后运行 gh auth login 认证。获取最新提交 SHA:gh pr view <PR_NUMBER> --json commits --jq '.commits[-1].oid'。创建 pending review:gh api repos/:owner/:repo/pulls/<PR_NUMBER>/reviews -X POST -f commit_id="<COMMIT_SHA>" -f 'comments[][path]=path/to/file.ts' -F 'comments[][line]=<LINE_NUMBER>' -f 'comments[][side]=RIGHT' -f 'comments[][body]=...' --jq '{id, state}'。提交:gh api repos/:owner/:repo/pulls/<PR_NUMBER>/reviews/<REVIEW_ID>/events -X POST -f event="COMMENT" -f body="..."。
限制与要求:发布任何评论前必须用 AskUserQuestion 展示将发布的内容并获得明确批准;即使时间紧迫也必须使用 pending review;comments[][] 参数需用单引号,字符串用 -f,数字用 -F;代码建议会替换整行或行范围,需确保完整正确;含嵌套代码块时改用四个反引号或波浪线。gh 未安装或未认证时不得继续。