{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}

Github

经 gh CLI 使用 GitHub：PR、issue、评审、仓库、认证。

Skill 元数据
来源内置（默认安装）
路径skills/software-development/github
版本2.0.0
作者Ben Barclay（benbarclay）、Hermes Agent
许可证MIT
平台linux, macos, windows
标签github, gh, git, pull-requests, issues, code-review, repos, auth, ci
相关 skillcodebase-inspection、requesting-code-review

参考：完整 SKILL.md

INFO

以下是 Hermes 在触发该 skill 时加载的完整 skill 定义。这是 agent 在 skill 激活时所看到的指令内容。

GitHub

用 gh CLI 端到端处理 GitHub（标注处用 REST 回退）：认证、issue、PR 生命周期、issue 转 PR 交付、代码评审和仓库管理。本 skill 合并了六个旧 skill；每个工作流完整位于其参考文件中——开始该工作流前务必先读对应参考，下方正文只做路由。

路由

任务先读
认证坏掉 / 新机器 / token 或 SSH 设置 / gh loginreferences/auth.md
创建、分拣、打标签、指派、关闭 issuereferences/issues.md
建分支、提交、开 PR、盯 CI、合并references/pr-workflow.md
把一个 ISSUE 带到已验证的 PR（完整交付循环）references/issue-to-pr.md
评审他人 PR：diff、行内评论、结论references/code-review.md
克隆/创建/fork 仓库、远程、releasereferences/repo-management.md

配套资产：scripts/gh-env.sh + scripts/git-credential-token.py（认证辅助）、templates/（PR 正文、bug 报告、功能请求）、references/ci-troubleshooting.md、references/conventional-commits.md、references/github-api-cheatsheet.md、references/review-output-template.md。

核心纪律（适用于每个工作流）

  • 每会话预检一次：gh auth status——若失败，先读 references/auth.md 再做其他。
  • 优先用 gh 而非裸 REST；仅在 porcelain 缺少对应 endpoint 时降到 gh api（速查表列出它们）。
  • 从不自己不查 gh pr checks 就报 CI 绿；从不未验证 state,mergedAt 就声称已合并。
  • 写入前读完整上下文：gh issue view --comments / gh pr view --comments——决定在线程里，不在标题里。
  • 创建任何东西前扫重：gh pr list --search / gh issue list --search。

验证

  • 该工作流自己的参考文件定义了该任务的完成标准。
  • 横切：每个关于远端状态的论断（CI、合并、release、issue 状态）都由一次新的 gh 读取支撑，绝不靠记忆。