用途:当环境中没有 gh 或未认证时,自动检测操作系统、终端、下载器与包管理器,生成或更新 ~/.issue/settings.json,并给出安装与登录方案;无权限要求的命令自动执行,需要管理员权限的命令则提示用户手动运行,最后引导完成 gh auth login,并检查 gh-attach 扩展。
主要能力与子命令:detect 生成或更新配置;status 检查 gh 安装、认证与 gh-attach 扩展状态并更新 settings.gh;plan 按 OS 列出安装命令(标注 [auto]/[user]/[guide]);install [--dry-run] 仅执行 [auto] 命令,并在确认 gh 后自动安装 gh-attach 扩展(幂等);login 按环境给出登录方法;config get/set 读写配置,可调整 terminals、downloaders 顺序。
使用方式:脚本路径按 .claude/skills/gh-setup、.codex/skills/gh-setup、~/.claude/skills/gh-setup、~/.codex/skills/gh-setup 顺序取第一个存在者。运行时调用路由器:macOS/Linux/WSL 用 sh <skill>/scripts/gh-env.sh <子命令>,Windows 用 powershell -ExecutionPolicy Bypass -File <skill>/scripts/gh-env.ps1 <子命令>。路由器按 node、python 顺序选择实现,输出中的 RUNTIME= 显示实际实现;两者都缺失时回退到 sh/ps1,仅支持检测与提示,不支持 install 自动执行和 config set。典型流程为 detect、status、plan、install、login、status,全部就绪后返回原任务。
限制:install 只执行 [auto] 命令,[user] 命令需用户自行在会话中执行;未登录时 gh-attach 扩展仍可安装,缺失该扩展不影响 gh 本身,仅在私有仓库图片上传时由相关技能回退为手动上传。资料未提供收费、价格或更多平台支持信息。