用途:整理 GitHub CLI(gh)的实用约定,以及用内联评论审查 PR 的做法。gh --help 与官方手册已覆盖命令面,本技能只讲其未涵盖之处。
主要约定:
- 每个列表命令都要传 --limit N,例如 pr list、issue list、run list;默认输出远超终端所需。
- 输出要喂给脚本时使用 --json FIELDS,再管道输出到 jq。
用行级评论审查 PR:gh pr review 只能提交整体正文,内联评论需用 gh api,一次调用可同时提交评论与总结。先读 diff(gh pr diff NUMBER),然后执行示例命令(保留原样): gh api repos/{owner}/{repo}/pulls/NUMBER/reviews --input - <<'EOF' { "commit_id": "LATEST_COMMIT_SHA", "event": "COMMENT", "body": "Overall: solid changes with a few suggestions.", "comments": [ { "path": "src/example.go", "line": 42, "side": "RIGHT", "body": "This variable is unused." } ] } EOF
要点与限制:side 对新增为 RIGHT,对删除为 LEFT;多行评论需加 start_line 与 start_side。正文可包含 GitHub suggestion 代码块(```suggestion)提出替换代码。event 可为 COMMENT、APPROVE 或 REQUEST_CHANGES;提交前应先询问选择哪一种,默认使用 COMMENT。其他内容暂未提供。