用途:用 gh CLI 以惯用、省 token 的方式完成 GitHub 操作,覆盖 PR、issue、release、workflow run、仓库与搜索。git 在此为只读(log、diff、status),不负责提交、推送或创建 PR,这些交给配套的 /plate。
主要能力:PR 列表/查看/diff/状态/检查/审查/合并/关闭/重开/转正/回滚/检出;issue 创建、列表、查看、编辑、评论、关闭、重开、从 issue 建分支;workflow 列表与触发、run 列表/查看/日志/监视/重跑/取消;release 创建、上传资产、列表、查看、下载、校验;仓库查看/克隆/fork/设默认;搜索仓库、代码、issue、PR;认证登录、状态、刷新 scope、setup-git。
用法要点:不要将 gh 管道到独立 jq,改用内置 --jq 或 --template,例如 gh pr list --json number --jq '.[].number';JSON 字段名与 REST API 不同,用 --help 查看,如 stargazerCount、forkCount、watchers。issue/评论正文不要用 heredoc --body,写入文件后用 --body-file。批量操作可先 --jq 再管道到 xargs。
限制:不暂存、提交、推送、创建 PR、rebase 或改动工作树;不做代码质量审查;不创建工作树;不执行删除类破坏性命令(如 gh repo delete、gh release delete、gh secret delete 等),除非用户明确确认。gh api 原始调用不如命名子命令稳定,有子命令时优先用子命令。认证 401 时运行 gh auth refresh,403 时补 scope。多远程仓库时用 gh repo set-default 或 --repo 指定。速率限制:已认证 5000/小时,未认证 60/小时。
适用场景:在已有 PR 后做审查、合并、CI 监控、发布与仓库检索等日常 GitHub 维护工作。