git Skill:用 gh CLI 操作 GitHub Issue、PR 与 CI

前言

在 Agent 里处理 GitHub,常见做法是临时查文档、手写 curl,或让模型「猜」仓库 API。Issue 状态、PR 差异、CI 运行结果一旦要联动,上下文很容易碎掉。下面介绍的 git Skill(坐标 @user_dd5c5538/gith-lyx,版本 1.0.0)把能力收敛到本机已安装的 GitHub CLI(gh):由 Agent 按 Skill 指引调用 gh issue、gh pr、gh run、gh api,覆盖 Issue、Pull Request、Actions 运行记录以及 REST 高级查询。SkillHub 分类为 dev-programming,社区来源,发布者 user_dd5c5538;页面标注 requires_api_key=false(Skill 本身不要求单独配置 API Key,实际仍依赖你本机 gh 的登录状态)。

这是什么

git 是 SkillHub 上的 Agent Skill,采用通用 SKILL.md 格式。一句话定位:教 Agent 用 gh 与 GitHub 交互,而不是替代 git 版本库命令或自行拼装未文档化的 HTTP 调用。维护方为社区发布者 user_dd5c5538,SkillHub 展示页:https://www.skillhub.cn/skills/user_dd5c5538/gith-lyx;资源地址:https://api.skillhub.cn/user_dd5c5538/gith-lyx。

核心功能

依据官方简介,已核实的能力边界如下:

  1. Issue:通过 gh issue 子命令查看、创建或管理 Issue(具体子命令以本机 gh issue --help 为准)。
  2. Pull Request:通过 gh pr 处理 PR 列表、详情、创建与审查相关操作。
  3. CI / Actions:通过 gh run 查看工作流运行、日志与状态。
  4. 高级查询:通过 gh api 调用 GitHub REST API,适合列表过滤、组合字段等 CLI 子命令未直接封装的场景。

Skill 不宣称替代 git commit / git push 等本地仓库操作;其价值在于把 GitHub 平台侧协作与自动化查询统一进 Agent 可执行的工具链。

安装与启用

方式一:让 AI 按 SkillHub 规范安装

SkillHub 页面提供的安装提示为:先阅读安装说明,再安装该坐标。

请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_dd5c5538/gith-lyx`。

方式二:使用 skillhub CLI

若尚未安装 CLI,可先检查版本;未安装时按 SkillHub 文档执行官方安装脚本(完整安装或 --cli-only 仅 CLI)。安装技能时必须用 --dir 指向当前 Agent 的 skills 目录,否则默认落在 ./skills/ 可能不会被识别。

command -v skillhub && skillhub --version

skillhub install @user_dd5c5538/gith-lyx --dir <你的 Agent skills 目录>

常用目录(来自 SkillHub 安装文档,按你实际使用的客户端择一):

  • Cursor:~/.cursor/skills/
  • Claude Code:~/.claude/skills/
  • Codex:~/.codex/skills/ 或项目下的 .agents/skills/

安装后按所用 Agent 的说明刷新或重启,使 Skill 被加载。Cursor、Codex CLI、Claude Code 的加载细节若与上文路径不一致,以各自当前文档为准;本文仅复述 SkillHub 公布的通用路径。

典型用法

下列示例与 Skill 简介中的四类入口一致,需在已 gh auth login 且位于对应仓库上下文(或显式指定 -R owner/repo)的环境中执行;Agent 在启用本 Skill 后,应优先通过 Shell 调用 gh,而不是臆造 API。

查看 Issue 与 PR:

gh issue list
gh pr list
gh pr view 123

关注 CI 运行:

gh run list
gh run view <run-id> --log

REST 高级查询(示例为公开端点形态,路径中的 OWNER/REPO 需替换):

gh api repos/OWNER/REPO/issues --jq '.[].title'

更复杂的过滤、分页与字段选择,可继续组合 gh api 与 --jq;具体参数以 GitHub CLI 手册 为准。

适用场景与注意

适合谁: 日常在 GitHub 上开 Issue、跟 PR、查 Actions 的开发者;希望 Agent 用可复现的 CLI 命令完成平台操作,而不是每次重新解释 REST 路径的人。

限制与注意:

  1. 依赖本机安装并配置好的 gh;Skill 标注无需额外 API Key,不等于无需 GitHub 身份认证。
  2. 社区 Skill(来源 community),行为以 SKILL.md 与 gh 版本为准;升级前可在 SkillHub 查看 v1.0.0 是否有新版本。
  3. SkillHub 页面统计(截至资料抓取):评分 100000,下载 801 次;安装数展示为 0,仅作商店参考,不代表本地不可用。
  4. 涉及写操作(创建 PR、关闭 Issue 等)时,应让 Agent 在执行前汇总命令与目标仓库,避免误操作。

结尾

git Skill 把 GitHub 平台侧工作收束到 gh issue、gh pr、gh run、gh api 四条主线,适合作为 Agent 处理协作与 CI 查询时的固定 playbook。安装与坐标以 SkillHub 为准:https://www.skillhub.cn/skills/user_dd5c5538/gith-lyx ,资源:https://api.skillhub.cn/user_dd5c5538/gith-lyx 。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜