用途:当用户询问如何设置 GitHub CLI、配置 gh、gh 认证不工作、连接失败或出现 gh CLI 错误时,该技能用于检查并修复 gh 的 GitHub 访问配置。
主要能力:检查当前认证状态(gh auth status),报告 gh 是否已认证(含当前用户名)或尚未登录需登录;在认证缺失或损坏时引导完成登录流程,选择 GitHub.com -> HTTPS -> Login with browser;通过 gh auth status 和 gh api user --jq '.login' 验证认证;对 gh 命令失败进行排查。
使用方式与排查步骤:先运行 gh auth status 判断状态;需要时运行 gh auth login 并按提示选择;随后再次运行 gh auth status 与 gh api user --jq '.login' 确认;若失败,依次检查认证、重新登录、确认令牌拥有 repo 访问权限、运行 gh auth refresh 刷新授权,并可通过 brew upgrade gh 或等效命令更新 gh。
适用场景:初始化开发环境、修复已过期的 GitHub 令牌、切换账号或解决连接与权限报错。
限制:资料未提供具体平台兼容性、版本要求或安装 gh 本身的步骤;部分命令(如 brew upgrade gh)仅为示例,实际更新方式取决于系统环境。