用途:该技能提供 gh CLI 的操作模式,用于在终端中访问 GitHub 仓库、服务与 API,覆盖认证、仓库管理、议题、拉取请求、Actions、发布、Projects、搜索以及 REST/GraphQL API。Git 工作流(分支、提交、CI/CD)由另一个技能负责。
主要能力(按领域):认证(gh auth status、gh auth login、gh auth token);仓库(gh repo clone、create、fork、sync);浏览(gh browse,可带 --settings 或 file.ts:42);议题(gh issue list/create/edit/close);拉取请求(gh pr create/review/merge/checkout);Actions(gh run list/view、gh workflow run、gh cache list);发布(gh release create/list/verify);Projects(gh project list/create/item-add);搜索(gh search repos/issues/code);API(gh api repos/{owner}/{repo}、gh api graphql);安全(gh attestation verify、gh ruleset list、gh secret set);状态(gh status、gh pr checks、gh pr status);Codespaces(gh codespace create/ssh/code)。
常见工作流示例:快速 PR 为先 git push -u origin feat 再 gh pr create --fill;草稿 PR 用 gh pr create --draft --fill,后用 gh pr ready;审阅合并用 gh pr checkout 45、gh pr review --approve、gh pr merge --squash --delete-branch;自动合并用 gh pr merge --auto --squash;查看 CI 用 gh pr checks 与 gh run watch;重跑失败 CI 用 gh run rerun <run-id> --failed;创建发布用 gh release create v1.0.0 --generate-notes;搜索代码用 gh search code "handleAuth" --repo owner/repo;加入项目用 gh project item-add 1 --owner @me --url <issue-url>;校验产物用 gh attestation verify artifact.tar.gz --owner owner;触发工作流用 gh workflow run deploy.yml -f environment=production;回滚已合并 PR 用 gh pr revert 45;同步 fork 用 gh repo sync。
输出格式化:多数 list/view 命令支持 --json、--jq、-t(Go 模板)、--web、--comments,便于脚本与自动化。
作用域:secret 与变量可作用于仓库(默认)、环境(--env production)、组织(--org name --visibility);project 命令必须指定 --owner @me 或 --owner org-name。
认证前提:多数命令需先认证,用 gh auth status 检查;缺 scope 会静默失败,可用 gh auth refresh -s scope 补充;CI 中可设置 GITHUB_TOKEN 或 GH_TOKEN。
常见错误纠正:创建 PR 前需先推送分支;合并前先查 CI 或用 --auto;从提交生成 PR 用 --fill;嵌套数据用 gh api graphql;project 命令必须带 --owner;下载产物用 gh run download <run-id>;脚本化输出应加 --json 与 --jq;合并建议加 --delete-branch;gh api POST 用 -f key=value(字符串)或 -F(有类型字段)。
委派建议:跨仓库搜索代码或议题可用 Explore 代理配合 gh search;多步骤发布可用 Task 代理协调;仓库结构与权限规划可用 Plan 代理。
限制:资料未提供 gh 的安装步骤、版本要求、收费信息、速率限制细节与各命令完整参数,使用时需另行查阅官方文档。