用途：在自动化脚本或子代理环境中可靠地使用 GitHub gh CLI 完成 issue、PR、标签的创建、查看、编辑、关闭等操作，重点解决静默认证失败问题。
主要能力：提供操作前预检流程（gh auth status、gh repo view <org>/<repo> --json name,url），确认认证与仓库访问后再执行变更；给出 issue/PR/标签常用命令与 --json --jq 可解析输出；提供按标题 upsert 的幂等创建模式，避免重复 issue。
常见故障与处理：沙箱无法读取系统钥匙串导致误报未登录，需禁用沙箱运行 gh；GH_CONFIG_DIR 指向不存在目录导致未登录，需指向真实配置目录或取消该变量；多账号时用 gh auth switch -u <username> 切换；组织启用 SAML SSO 时 .env 中的 PAT 常被拒绝，优先使用钥匙串 OAuth 或服务端 GitHub App 安装令牌（SSO 豁免）。CI/批量场景可通过 AWS SSM 在持有 App 令牌的服务器上执行 gh 命令。
限制与原则：任何操作无法验证成功时，必须报告确切错误，不得编造 issue 编号、URL 或成功消息；预检失败应硬停止。具体环境配置与命令示例以资料为准。