关于 github
面向使用 `gh` CLI 的开发者,涵盖 GitHub 认证、Issue、拉取请求、代码审查和仓库管理,并按任务提供参考流程及远程状态核验。
主要功能
- 01认证设置与故障排查
- 02Issue 创建与分类
- 03拉取请求和 CI 流程
- 04Issue 到拉取请求的交付
- 05代码审查
- 06仓库与发布管理
适用场景
- 01在新设备配置 GitHub 访问
- 02将 Issue 推进为已核验的拉取请求
- 03审查拉取请求及其讨论
- 04管理仓库、远程地址和发布
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ nousresearch/ hermes-agent --skill github安装后在 Claude Code 中输入/github确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/auth.mdci-troubleshooting.mdcode-review.mdconventional-commits.mdgithub-api-cheatsheet.mdissue-to-pr.mdissues.mdpr-workflow.mdrepo-management.mdreview-output-template.mdscripts/gh-env.shgit-credential-token.pytemplates/bug-report.mdfeature-request.mdpr-body-bugfix.mdpr-body-feature.md详细介绍
GitHub
使用 gh CLI 端到端处理 GitHub 工作流(注明时使用 REST 作为回退):身份验证、
问题、PR 生命周期、从问题到 PR 的交付、代码审查和仓库
管理。此技能整合了六项原有技能;每个工作流的完整内容都在其参考文件中——开始
工作流前,务必先阅读对应的参考文件,以下正文仅用于指引。
路由
| 任务 | 首先阅读 |
|---|---|
| 身份验证故障 / 新设备 / 令牌或 SSH 设置 / gh login | references/auth.md |
| 创建、分类、添加标签、指派、关闭问题 | references/issues.md |
| 分支、提交、创建 PR、监控 CI、合并 | references/pr-workflow.md |
| 将 ISSUE 推进至已验证的 PR(完整交付流程) | references/issue-to-pr.md |
| 审查他人的 PR:差异、行内评论、结论 | references/code-review.md |
| 克隆/创建/派生仓库、远程仓库、发布 | references/repo-management.md |
支持资源:scripts/gh-env.sh + scripts/git-credential-token.py
(身份验证辅助脚本)、templates/(PR 正文、错误报告、功能请求)、
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;仅当gh缺少对应功能时才使用gh api(缺少的端点列于速查表中)。 - 未亲自检查
gh pr checks,绝不报告 CI 通过;未验证state,mergedAt,绝不 声称 PR 已合并。 - 撰写内容前先阅读完整上下文:
gh issue view --comments/gh pr view --comments——决策体现在讨论串中,而非标题里。 - 创建任何内容前,先查找重复项:
gh pr list --search/gh issue list --search。
验证
- 对应任务的完成标准由该工作流自己的参考文件定义。
- 跨工作流要求:每条关于远程状态(CI、合并、发布、问题状态)的声明,都必须有最新的
gh读取结果作为依据,不能依赖记忆。
评论
支持 Markdown