用途:用于 GitHub CLI(gh)自动化,包括仓库读取、workflow 运行、搜索、codespaces、release、配置以及 gh 命令语法等。该 skill 声明豁免协调,跳过 ai-coord 门禁。
路由与分工:若需撰写或更新 pull request、issue、issue comment 或 discussion,应使用 yeet,它负责语义分析、仓库模板、写作风格、幂等与直接发布。仓库重命名走 repo-rename,使 GitHub 与本地保持同步。
权限边界:读取和检查无需确认;仅在用户明确要求时才执行可逆或普通的 GitHub 写入;绝不允许删除仓库、release/资产、workflow 运行/缓存、secrets/变量、密钥、codespaces、扩展或 gists。标签删除是唯一的破坏性例外:需先展示目标仓库、具体标签、命令及对 issue/PR 的影响,再在后续消息中获得批准,才能执行 gh label delete ... --yes。
工作流:当 cwd 不明确时显式解析仓库。用首个必需的只读命令验证认证,仅在诊断认证时运行 gh auth status。用已安装的 gh <command> <subcommand> --help 解析标志、JSON 字段与行为;CLI 的 JSON 字段名可能与 API 不同,建议使用 --json 配合 --jq 输出结构化结果。大范围写入前预览仓库、目标、命令及 issue/PR 影响;已明确请求的普通写入无需二次批准。
CI 失败排查:当用户询问 CI 失败原因或要求修复时使用。查找分支或提交的失败运行:gh run list --branch <branch> --status failure --limit 5,或 gh run list --commit <sha> --status failure --limit 5。只提取失败步骤行,不要打印原始日志:gh run view <run-id> --log-failed | rg --no-config -n 'error|FAIL|panic|✗' | head -80。改代码前检查工具链漂移,对比 .github/workflows/*.yml 中固定版本与本地 --version 输出,常见为 Foundry(forge)、Bun(bun)、Node.js(node)、Rust(rustc)。若用户要求修复,则修复原因并推送提交,再用 gh run list --commit <new-sha> --limit 5 获取新 run ID,并监视:gh run watch <run-id> --exit-status --compact,最后报告 gh run view <run-id> --json url --jq .url 的 URL 与最终状态。
值得注意的标志(gh 2.98+):gh pr checkout --worktree <path> 与 gh issue develop --checkout --worktree <path> 会签出到关联 git worktree;gh search issues --search-type semantic|hybrid 按相关性排序,仅限 issues、单页、无 --sort/--order,GitHub Enterprise Server 不支持;gh config set api_host <gateway> --host <host> 将该 host 的 API 流量经网关路由,此功能为实验性且非安全边界;gh auth login 与 gh auth refresh 默认复制 OAuth 设备码到剪贴板(2.101+),可用 gh config set clipboard disabled 关闭;issue/PR 创建、编辑与评论的 --attach '<file>#<alt>' 可上传图片或视频,这些写入需走 yeet。
完成条件:命令输出验证了所需的 GitHub 数据或状态即完成。写入后拉取结果资源。遇到部分或不明失败,重试前先确认是否已变更。报告已验证状态与 URL 或稳定标识。未完成时给出具体错误与下一步,并区分未知结果与确认失败。
限制:资料未提供收费、价格、平台支持范围等细节。本 skill 依赖已安装的 GitHub CLI 及本地工具链。