用途:借助 gh 命令行工具与 GitHub 仓库、议题、PR 和 CI 交互。适用于查看 PR 状态、评审或可合并性,查看 CI/工作流运行状态与日志,创建、关闭或评论议题,创建或合并 PR,通过 GitHub API 查询仓库数据,以及列出仓库、发布版本或协作者。
不适用:本地 git 操作(提交、推送、拉取、分支)应直接用 git;非 GitHub 仓库(GitLab、Bitbucket、自托管)使用其他 CLI;克隆仓库用 git clone;审查实际代码改动、复杂多文件差异应使用 coding-agent 技能或直接读取文件。
初始化:一次性认证 gh auth login,随后用 gh auth status 验证。
主要命令:PR 方面有 gh pr list、gh pr checks、gh pr view、gh pr create、gh pr merge;议题方面有 gh issue list、gh issue create、gh issue close;CI 方面有 gh run list、gh run view、带 --log-failed 只查看失败步骤日志、gh run rerun --failed 重跑失败任务;API 查询如 gh api 配合 --jq 过滤字段。多数命令支持 --json 输出结构化数据并用 --jq 过滤。
使用注意:不在 git 目录内时始终指定 --repo owner/repo;可直接传入 URL,如 gh pr view 某个 PR 链接;存在速率限制,重复查询可用 gh api --cache 1h。以上为资料明确提供的内容,其他细节暂未提供。