用途：在使用 GitHub 官方命令行工具 gh 处理拉取请求、议题、发布和 GitHub 自动化时提供操作指导，也适用于理解 gh 的心智模型、命令结构与脚本化场景。
主要能力：覆盖三层结构——面向用户的高级命令（gh pr、gh issue、gh repo）、直接访问 REST/GraphQL 的 gh api，以及基于 git 远程与当前分支的仓库/PR 上下文自动识别。包含 PR 创建查看检出评审合并与检查、议题创建列表查看编辑关闭与指派标签、仓库查看克隆创建与 fork、发布创建列表及资产上传下载，以及输出格式化（--json、--jq、--template）、认证配置、别名、扩展和 GitHub Actions 交互。
使用方式：先确认安装 gh --version，再用 gh auth login 或 gh auth status 处理认证，gh config set 配置默认值。常见命令如 gh pr create、gh pr list、gh issue list、gh api <endpoint>、gh api graphql -f query='...'。文档建议按需渐进加载 references/gh.md，涉及 Projects V2、Discussions、批量查询等高级场景时加载 references/graphql.md 与 graphql-schema-core.md，涉及限流与 API 后端映射时加载 api-backend-audit.md。排查问题可用 gh auth status、gh api user、gh api rate_limit、GH_DEBUG=api gh <command>。
适用场景：日常 PR 工作流、议题分诊、发布自动化、多仓库操作、命令行代码评审、CI/CD 中的 GH_TOKEN 认证与自动化脚本。
限制：资料未提供具体收费、价格、平台兼容范围与实测效果；上述命令与配置项的可用性以 gh 官方实际行为为准。