用途:在 GitHub 上创建、克隆、Fork、配置和管理仓库,并处理远程、发布、分支保护、Actions 密钥与工作流等操作。
主要能力:克隆仓库(支持指定目录、浅克隆、指定分支、SSH);创建仓库(公开/私有、组织下、从本地目录推送、从模板生成);Fork 并同步上游;查看仓库信息与搜索;编辑仓库设置(描述、可见性、Wiki、Issues、默认分支、主题、自动合并);配置分支保护;管理 Actions 密钥;创建与下载 Release 及上传资产;查看、重跑、手动触发工作流;创建与列出 Gist。
使用方式:先完成 GitHub 认证(见 github-auth 技能)。技能会检测 gh 是否可用且已登录,否则回退到 git + curl,并尝试从环境变量、.env 或 ~/.git-credentials 读取 GITHUB_TOKEN。每个操作先给出 gh 命令,再给出 git + curl 回退。例如克隆用 git clone https://github.com/owner/repo-name.git 或 gh repo clone owner/repo-name;创建仓库用 gh repo create my-new-project --public --clone;Fork 用 gh repo fork owner/repo-name --clone;发布用 gh release create v1.0.0 --title "v1.0.0" --generate-notes。
适用场景:需要以命令行方式批量或自动化管理 GitHub 仓库、CI 工作流与发布流程时。
限制:执行前需验证本地命令、工具、密钥或桥接端点是否可用;发送、发布、部署、删除、移动、合并、云写入等视为外部写操作,需谨慎。若工具、认证或 macOS 权限缺失,应停止并报告具体缺失步骤,不要循环或静默改用浏览器自动化。密钥设置通过 API 需用仓库公钥加密(依赖 PyNaCl),gh secret set 更简单。具体收费、价格与平台支持范围资料暂未提供。