前言¶
在 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。
核心功能¶
依据官方简介,已核实的能力边界如下:
- Issue:通过
gh issue子命令查看、创建或管理 Issue(具体子命令以本机gh issue --help为准)。 - Pull Request:通过
gh pr处理 PR 列表、详情、创建与审查相关操作。 - CI / Actions:通过
gh run查看工作流运行、日志与状态。 - 高级查询:通过
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 路径的人。
限制与注意:
- 依赖本机安装并配置好的
gh;Skill 标注无需额外 API Key,不等于无需 GitHub 身份认证。 - 社区 Skill(来源 community),行为以 SKILL.md 与
gh版本为准;升级前可在 SkillHub 查看 v1.0.0 是否有新版本。 - SkillHub 页面统计(截至资料抓取):评分 100000,下载 801 次;安装数展示为 0,仅作商店参考,不代表本地不可用。
- 涉及写操作(创建 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 。