用途：让智能体以编程方式完成 GitHub 操作，如创建 issue、拉取请求、管理仓库、发布、标签、Actions 运行、Projects、secrets 等。
主要能力：CLI 优先，凡 gh 有原生命令即用 gh <command>；无命令的 REST 操作通过 gh api <endpoint> 构造；仅 GraphQL 支持的功能（如 Discussions）用 gh api graphql。附带 OpenAPI 规范与端点索引，可先解析 schema 再构造调用。gh 自身处理 base URL、分页与输出。
使用方式：调用方注入 host 与令牌变量名，按项目 .env 优先、否则环境变量的顺序解析；每次调用前缀 GH_TOKEN="$<token_env>"，例如 GH_TOKEN="$<token_env>" gh issue create --repo OWNER/REPO --title "…" --body "…"。可用 --json/--jq 获取结构化输出；gh api 支持 --paginate、--slurp。secrets 用 gh secret set，由 gh 客户端加密。
适用场景：对 github.com 的编程式读写操作。
限制：不适用于本地/交互式 gh 操作（如 gh auth、gh browse、gh repo clone、gh pr checkout、gh config、gh alias、gh extension、gh completion）；v1 面向 github.com，GitHub Enterprise Server 未测试；不负责凭据的创建或解析，凭据由调用方提供；令牌值不得读取或打印，仅以变量名引用；禁止使用 gh auth switch/login 以免修改全局状态。