mcpField
G
github

github

github.com/nousresearch开发258.9k173 次安装今天更新
代码仓库

关于 github

面向使用 `gh` CLI 的开发者,涵盖 GitHub 认证、Issue、拉取请求、代码审查和仓库管理,并按任务提供参考流程及远程状态核验。

主要功能

  1. 01认证设置与故障排查
  2. 02Issue 创建与分类
  3. 03拉取请求和 CI 流程
  4. 04Issue 到拉取请求的交付
  5. 05代码审查
  6. 06仓库与发布管理

适用场景

  1. 01在新设备配置 GitHub 访问
  2. 02将 Issue 推进为已核验的拉取请求
  3. 03审查拉取请求及其讨论
  4. 04管理仓库、远程地址和发布

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/nousresearch/hermes-agent --skill github

安装后在 Claude Code 中输入/github确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
auth.md
ci-troubleshooting.md
code-review.md
conventional-commits.md
github-api-cheatsheet.md
issue-to-pr.md
issues.md
pr-workflow.md
repo-management.md
review-output-template.md
scripts/
gh-env.sh
git-credential-token.py
templates/
bug-report.md
feature-request.md
pr-body-bugfix.md
pr-body-feature.md

详细介绍

GitHub

使用 gh CLI 端到端处理 GitHub 工作流(注明时使用 REST 作为回退):身份验证、 问题、PR 生命周期、从问题到 PR 的交付、代码审查和仓库 管理。此技能整合了六项原有技能;每个工作流的完整内容都在其参考文件中——开始 工作流前,务必先阅读对应的参考文件,以下正文仅用于指引。

路由

任务首先阅读
身份验证故障 / 新设备 / 令牌或 SSH 设置 / gh loginreferences/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