用途:该技能把 GitHub 相关操作统一交给 gh CLI 完成,覆盖 issue、拉取请求、Actions 工作流、仓库、release、搜索、gist、组织团队以及 REST/GraphQL API 调用,适合在终端、脚本或 CI 中自动化仓库协作流程。
主要能力:按用户意图路由到对应参考文档,例如 issue 增删改查与评论、PR 创建与评审合并、工作流运行与日志查看、仓库与 release 管理、代码与提交搜索、gh api 原始调用及分页限流处理、GraphQL 批量查询与变更。
使用方式:先安装 gh(macOS 用 brew install gh,Debian/Ubuntu 用 sudo apt install gh,Windows 用 winget install GitHub.cli),再执行 gh auth login 登录,用 gh auth status 检查状态;缺少权限时用 gh auth refresh --scopes repo,read:org,workflow 补充。不在 git 仓库内时始终显式传 --repo owner/repo;优先使用 --json 与 --jq 获得可解析输出,优先用高层命令而非原始 API,仅在嵌套或批量数据时用 GraphQL。调试可加 GH_DEBUG=api。
限制:所有命令需要联网,无离线模式;GraphQL 认证用户每小时 5000 点预算;secret 只写不可读,创建后无法取回;组织管理需 admin:org 权限且默认不授予;工作流产物默认保留 90 天,过期无法下载。