前言¶
日常开发里,Issue、Pull Request、Actions 跑没跑完,多半要切到浏览器或自己敲 gh。把 Agent 接进工作流时,如果没有统一约定,它容易去猜网页结构、乱调未文档化的接口,结果不稳定。下面介绍 SkillHub 上的社区 Skill github-qinghong:把 GitHub 相关操作收敛到官方 GitHub CLI(gh),用 gh issue、gh pr、gh run、gh api 覆盖 Issue、PR、CI 与进阶查询。
这是什么¶
github-qinghong(坐标 @user_5c68097a/github-qinghong,版本 1.0.0)由社区发布者 user_5c68097a 维护,来源为 community,在 SkillHub 分类为 dev-programming。Skill 页标注 requires_api_key=false,表示 Skill 本身不额外要求配置独立 API Key;实际访问 GitHub 仍依赖本机已安装并完成登录的 gh。
一句话定位:在 Agent 侧注入一套「凡 GitHub 操作优先走 gh」的执行约定,而不是让模型自行拼凑 HTTP 请求。
核心功能¶
依据 SkillHub 简介,已核实的能力范围如下:
- Issue:通过
gh issue子命令查看、创建或处理 Issue(具体子命令由任务与gh文档决定)。 - Pull Request:通过
gh pr处理 PR 列表、详情、评审与合并等相关操作。 - CI / Actions:通过
gh run查看工作流运行状态、日志与失败原因。 - 进阶查询:通过
gh api调用 GitHub REST API,适合列表页装不下的字段或批量查询。
Skill 不替代 gh 本身,而是指导 Agent 在 Shell 里选用上述入口,与 GitHub 官方 CLI 行为保持一致。
安装与启用¶
SkillHub 页面给出的安装提示如下:先阅读 SkillHub 安装与优先源配置,再安装本 Skill。
1、确认 SkillHub CLI(可选但推荐)
command -v skillhub && skillhub --version
未安装时,可按安装文档执行完整安装或仅安装 CLI(文档中的 curl 安装脚本见 skillhub.md)。
2、安装 github-qinghong
安装时必须用 --dir 指向当前 Agent 的 skills 目录,否则默认落在 ./skills/ 可能不会被识别:
skillhub install @user_5c68097a/github-qinghong --dir <skills 目录>
常用 skills 目录(摘自 SkillHub 安装文档):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下的.agents/skills/
也可将 SkillHub 页面中的提示词发给 AI,让其按上述文档完成安装。
3、本机前置:gh
Skill 描述明确要求使用 gh CLI。使用前请在本机安装 GitHub CLI,并通过 gh auth login 等方式完成认证;否则 Agent 即使加载了 Skill,也无法在 Shell 中成功执行命令。
典型用法¶
安装并启用后,可将 Issue、PR、CI、仓库元数据类需求用自然语言交给 Agent,并预期其通过 gh 子命令在终端完成。下列示例与 Skill 简介中列出的四类入口一致,可在已登录 gh 的环境中自行复现:
# Issue
gh issue list --repo OWNER/REPO
# Pull Request
gh pr status
# Actions 运行记录
gh run list --repo OWNER/REPO
# REST API 查询(路径按 GitHub API 文档填写)
gh api repos/OWNER/REPO/pulls --jq '.[].title'
更复杂的流程(例如先 gh run view 看失败 Job,再 gh pr checks 对照 PR)同样落在 gh run / gh pr 能力范围内;具体参数以 GitHub CLI 手册 为准。
适用场景与注意¶
适合谁
- 已在用 Cursor、Claude Code、Codex 等支持 Skills 的 Agent,且本机习惯或允许使用
gh。 - 希望 Agent 查 PR 状态、跟 Issue、盯 CI 失败,而不是打开网页或手写 curl。
限制与注意
- 依赖本机
gh版本、登录账号与仓库权限;私有库、组织策略、SSO 等与直接使用gh时相同。 - SkillHub 抓取数据显示:评分 100000,下载 943,安装计数 0(统计以 SkillHub 页面为准,会随时间变化)。
- 公开页面未提供完整
SKILL.md正文;行为边界以简介中的四类gh入口为准,未在资料中出现的配置项不写。
结尾¶
github-qinghong 的价值在于把 Agent 的 GitHub 操作锚定在官方 CLI 上,Issue、PR、CI 与 gh api 查询有统一路径,便于复现和排错。安装与元数据见 SkillHub:
- 技能页:https://www.skillhub.cn/skills/user_5c68097a/github-qinghong
- API 坐标:https://api.skillhub.cn/user_5c68097a/github-qinghong