前言¶

在 Cursor、Claude Code 等环境里，让模型「帮你看 PR、查 CI、改 Issue」时，常见问题是：它要么臆造接口返回，要么用 curl 拼 REST，和你在终端里用的 gh 工作流不一致。若希望 Agent 与本地一样，通过官方 gh 子命令操作 GitHub，需要一份把用法写进上下文的 Skill。下面介绍 SkillHub 上的 ex.skill（坐标 @user_90f470a6/code-v2），其核心就是把与 GitHub 的交互收敛到 gh issue、gh pr、gh run、gh api 等 CLI 能力上。

这是什么¶

ex.skill 是社区发布者 user_90f470a6 在 SkillHub 上架的编程类 Skill（分类 dev-programming，当前版本 1.0.0，来源 community）。官方简介为：

Interact with GitHub using the gh CLI. Use gh issue, gh pr, gh run, and gh api for issues, PRs, CI runs, and advanced queries.

一句话定位：它不是替代 gh 的封装库，而是指导 Agent 优先、规范地调用 GitHub CLI，覆盖 Issue、Pull Request、Actions 运行记录，以及需要走 REST/GraphQL 的高级查询场景。

核心功能¶

依据 SkillHub 页面与抓取元数据，可核实的能力边界如下。

1. Issue：通过 gh issue 相关子命令查看、创建或管理 Issue（具体子命令由 Agent 在任务中按 gh 文档选用）。
2. Pull Request：通过 gh pr 处理 PR 列表、详情、评审与合并等常见仓库协作操作。
3. CI / Actions：通过 gh run 查看工作流运行状态、日志与失败原因，便于对照 PR 或分支上的检查。
4. 高级查询：通过 gh api 访问 GitHub API，在 CLI 未封装的场景下做结构化查询。

Skill 标签包含 requires_api_key=true，表示依赖可访问 GitHub 的凭据（通常由本机已配置的 gh auth 或等效 Token 提供）；Skill 本身不替代你在机器上安装并登录 gh。

安装与启用¶

安装流程以 SkillHub 官方说明为准：先具备 skillhub CLI，再将技能装进当前 Agent 实际读取的 skills 目录。

1、检查或安装 SkillHub CLI¶

command -v skillhub && skillhub --version

若未安装，可使用官方安装脚本（完整安装含默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅安装 CLI 时：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

2、安装 ex.skill¶

SkillHub 页面给出的安装提示为：根据 skillhub 安装文档 安装坐标 @user_90f470a6/code-v2。对应 CLI 写法示例（--dir 必须指向当前环境的 skills 目录，否则默认 ./skills/ 可能不会被 Agent 加载）：

skillhub install user_90f470a6/code-v2 --dir <你的 Agent skills 目录>

常见路径（来自 SkillHub 安装文档，按你实际使用的客户端择一）：

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

安装后按所用客户端要求重启或刷新 Agent，使 Skill 进入上下文。页面未单独列出 Cursor 与 Codex CLI 的差异步骤时，差异主要体现在 skills 目录路径，安装命令形式相同。

也可将下列提示交给 Agent，由其按安装文档执行（与 SkillHub 页面文案一致）：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_90f470a6/code-v2`。

典型用法¶

Skill 未附带独立示例仓库；典型用法即：在已安装 gh 且已完成认证的环境中，由 Agent 按 Skill 约束选择子命令。下列命令与官方简介一致，可在本机先验证环境，再交给 Agent 完成同类任务。

查看某仓库开放的 Issue：

gh issue list --repo OWNER/REPO

查看 PR 及检查状态：

gh pr view 123 --repo OWNER/REPO

查看最近一次 workflow 运行：

gh run list --repo OWNER/REPO --limit 5

需要 REST 端点时（示例路径以 GitHub 文档为准）：

gh api repos/OWNER/REPO/pulls/123

经过上面的步骤，Agent 在处理「查失败 CI」「汇总 PR 评论」「按 API 拉字段」等请求时，应走 shell 中的 gh，而不是编造 HTTP 响应。

适用场景与注意¶

适合谁

• 日常已用 gh 管理 GitHub，希望 Coding Agent 与同一套 CLI 对齐的开发者。
• 需要频繁查 Issue/PR/Actions，又不想在对话里重复粘贴 gh 子命令说明的团队。

限制与注意

1. 前置依赖：本机需安装 GitHub CLI 并完成 gh auth login（或等效配置）；requires_api_key=true 表示无有效凭据时相关操作会失败。
2. 权限范围：gh 能做什么，Agent 也只能在同样权限下做；私有仓库、组织策略、SSO 等与个人 Token 一致。
3. 元数据参考：SkillHub 列表显示评分约 100000、下载 685 次（统计随平台更新）；分类为 dev-programming。若以功能为准，以简介与 SKILL.md 内容为准，不以下载数为能力依据。
4. 安装目录：务必使用 skillhub install ... --dir，避免装到 Agent 不扫描的路径。

结尾¶

ex.skill 的价值在于把 GitHub 协作固定到 gh CLI 四条主线（issue、pr、run、api），减少 Agent 与终端行为脱节。需要安装或查看版本说明时，可打开 SkillHub 技能页与 API 入口：

• 技能页：https://www.skillhub.cn/skills/user_90f470a6/code-v2
• 官方地址：https://api.skillhub.cn/user_90f470a6/code-v2