前言¶
在 Cursor、Claude Code 等环境里让模型查 Issue、看 PR、跟 CI，常见做法是口述步骤或贴网页链接。模型往往缺少统一约定：该用 REST 还是网页、权限怎么配、PR 和 Run 分别走哪条命令。wtff 是 SkillHub 上的一条 dev-programming 类 Skill，把能力收敛到 GitHub 官方 gh CLI，用 gh issue、gh pr、gh run、gh api 覆盖 Issue、PR、CI 与进阶查询。
下面介绍它是什么、能做什么，以及如何在本地安装启用。
这是什么¶
wtff（坐标 @user_eb2b0784/wtf-github，当前版本 1.0.5，来源 community）由 SkillHub 发布者 user_eb2b0784 维护；SkillHub 页面标注作者为王腾飞。官方简介为：通过 gh CLI 与 GitHub 交互，使用 gh issue、gh pr、gh run、gh api 处理 Issue、PR、CI 运行与高级查询。
它不负责替代 gh 本身，而是给 Agent 一套可执行的技能说明（通用 SKILL.md 格式），让模型在需要 GitHub 操作时优先走已安装的 gh 子命令，而不是随意拼凑未核实的 API 调用。
核心功能¶
依据 SkillHub 与官方 API 页面上的说明，wtff 覆盖的能力边界如下：
- Issue：通过
gh issue创建、查看、列表、评论等（具体子命令由 Agent 结合任务选择）。 - Pull Request：通过
gh pr处理 PR 的查看、创建、合并相关流程及与分支的关联操作。 - CI / Actions：通过
gh run查看 workflow 运行状态、日志与失败原因，便于排查 PR 检查。 - 进阶查询：通过
gh api访问 GitHub REST/GraphQL 端点，处理gh issue/gh pr未直接封装的场景。
Skill 标签标明 requires_api_key=false：技能包本身不要求单独配置 Skill 专用 API Key；实际调用仍依赖本机 gh 已登录的 GitHub 凭据（gh auth login 等），与 gh 官方行为一致。
安装与启用¶
安装 SkillHub CLI¶
若尚未安装，可先检查：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档执行完整安装（CLI + 默认 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
安装 wtff¶
SkillHub 页面给出的安装方式为：参照 SkillHub 安装文档，安装 @user_eb2b0784/wtf-github。
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/，Agent 可能无法加载。常用路径如下：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
示例（Cursor）：
skillhub install user_eb2b0784/wtf-github --dir ~/.cursor/skills/
也可将提示词交给 AI：「请根据 https://skillhub.cn/install/skillhub.md，安装 @user_eb2b0784/wtf-github。」
安装后按你所用客户端要求重启或刷新 Agent，使技能生效。
前置：本机 gh¶
wtff 假定环境已安装并可用的 GitHub CLI。使用前请自行完成 gh 安装与 gh auth login；Skill 文档未替代这一步。
典型用法¶
官方资料未附带独立的长示例脚本，能力描述即围绕下列命令族。下列命令为 gh 本身用法，体现 wtff 引导 Agent 的操作面；在已启用该 Skill 的会话中，可将自然语言任务交给 Agent，由其选择合适子命令。
Issue
gh issue list --repo OWNER/REPO
gh issue view 123 --repo OWNER/REPO
Pull Request
gh pr list --repo OWNER/REPO
gh pr view 456 --repo OWNER/REPO
gh pr checks 456 --repo OWNER/REPO
CI 运行
gh run list --repo OWNER/REPO
gh run view RUN_ID --repo OWNER/REPO --log-failed
REST / 自定义查询
gh api repos/OWNER/REPO/pulls/456
经过上面的步骤，Agent 在「查 PR 状态」「跟失败 workflow」「用 API 拉元数据」等任务上应统一走 gh，减少与 GitHub 实际 CLI 行为不一致的幻觉命令。
适用场景与注意¶
适合谁
- 日常在 Agent 里处理 GitHub Issue、PR、Actions，且团队或本机已标准化使用
gh。 - 希望模型用 Shell 执行可复现命令，而不是仅生成无法执行的伪 API 片段。
限制与注意
- 依赖本机
gh版本、登录账号与仓库权限；私有库、组织策略限制与不用gh时相同。 - SkillHub 统计（截至页面展示）：评分 100000，下载 782，安装 0；安装数为平台计数，不代表本地是否已
--dir安装成功。 - 分类为 dev-programming；不涉及 Skill 包内嵌 GitHub PAT（
requires_api_key=false）。
结尾¶
wtff 把 GitHub 相关 Agent 能力锚定在官方 gh CLI 上，Issue、PR、CI 与 gh api 进阶查询一条线对齐。若你已在 Cursor 等环境使用 SkillHub，可按坐标 @user_eb2b0784/wtf-github 安装到对应 skills 目录。
- SkillHub 页面：https://www.skillhub.cn/skills/user_eb2b0784/wtf-github
- 官方 API 入口：https://api.skillhub.cn/user_eb2b0784/wtf-github
- 安装说明：https://skillhub.cn/install/skillhub.md
