用途:通过 gh CLI 与 REST/GraphQL 操作 GitHub 托管状态,覆盖 PR、Issue、仓库、协作者与团队、组织权限与 2FA、分支保护、Actions 工作流、GHCR 镜像发布等。核心原则是交付用户要求的 GitHub 状态,而非仅返回成功响应;200/201/202/204 只代表请求被接受,不等于字段已变更、邀请已接受或异步任务已完成。
主要能力:按操作路由到对应参考文档,如 PR 操作、Issue 操作、仓库操作、多账号仓库同步、组织访问与设置、分支保护、工作流操作、CI 需求与通知、GHCR 发布、API 参考与最佳实践。
使用方式:先分类请求(只读或写入),再绑定身份、主机与目标,例如 gh auth status --hostname HOST、gh api --hostname HOST user --jq '.login'、gh repo view HOST/OWNER/REPO --json nameWithOwner,visibility,isPrivate,viewerPermission,url。写入前预览变更(目标、当前状态、请求变更、影响范围、恢复方式、读回方式),优先使用专用 gh 子命令,其次 REST,再次 GraphQL,最后 UI。写入后必须独立读回验证,异步状态需有界轮询。授权写入可通过 uv run python <github-ops-dir>/scripts/checked_gh.py --expected-login <EXPECTED_LOGIN> --host HOST 执行,该包装器会校验当前凭据并固定身份。
适用场景:需要精确、可验证地变更 GitHub 托管状态的自动化与运维任务。
限制:不得盲目重试非幂等写入;不得绕过分支保护、必需检查或签名;不得在输出、URL、参数或文件中暴露凭据;仓库创建必须显式指定 OWNER/REPO 与可见性,不得默认公开;企业策略可覆盖组织或仓库设置。本地 Git 恢复请使用 git-safety-net。