GitHub CLI 有 Skill 吗？从安装到使用 Agent Skills 的完整指南

GitHub CLI 有 Skill 吗从安装到使用 Agent Skills 的完整指南近期在研究各种 CLI 工具的 Skill 机制时发现GitHub CLIgh不仅有官方内置的gh skill命令还在 2025 年初随着 v2.67.0 版本正式开启了 Agent Skills 时代。本文整理从查阅资料、安装到上手验证的全流程以及和飞书 CLI 的对比。一、gh确实有 Skill从 v2.67.0 起GitHub CLI 内置了一组gh skill子命令专门用来给 AI 编程助手Claude Code、GitHub Copilot、Cursor 等安装技能包——也就是如何正确调用gh的说明书。最常用的三条命令# 安装官方 gh 技能用户级别 gh skill install cli/cli gh --scope user # 更新技能 gh skill update gh # 查看已安装的所有技能 gh skill list仓库引用格式是OWNER/REPO不能只写cli。cli/cli里的cli是 GitHub CLI 仓库的 owner第二个cli是仓库名。安装时的常用变体场景命令安装官方 gh 技能用户级gh skill install cli/cli gh --scope user安装到项目级默认gh skill install cli/cli gh强制覆盖已有技能gh skill install cli/cli gh -f从本地目录安装gh skill install ./my-skill --from-local安装所有技能不逐个确认gh skill install cli/cli --all二、安装时的交互选择第一次执行gh skill install后会进入一个全屏选择器询问要把技能安装到哪个 AI Agent 上方向键移动光标空格键选中/取消选中右键全选左键全部取消回车确认根据自己用的编辑器选一个或多个即可用的 AI 工具建议选择VS Code 里的 GitHub Copilot保持默认选中 GitHub Copilot直接回车Claude Code命令行版 Claude空格选中 Claude Code再回车Cursor 编辑器空格选中 Cursor再回车不确定保持默认 GitHub Copilot直接回车安装器屏幕上会出现一段安全提示技能未经过 GitHub 验证可能包含提示注入、隐藏指令或恶意脚本。使用前请务必审查技能内容。这是官方模板的标准提示cli/cli仓库是可信的但养成装完先看一眼内容的习惯总没错。三、技能装好之后AI 能帮你做什么技能包本质上是一份 Markdown 使用说明书告诉 AI 如何正确调用gh。装好后AI 会参考它自动拼出正确的命令。想做的事可以这样问 AI看仓库的 Issue帮我看看这个仓库有哪些开放的 Issue创建一个 PR帮我创建一个 PR标题是 xxx内容是 xxx看 PR 状态我有哪些待审核的 PR搜索特定 Issue搜索 repo:cli/cli 里标签是 bug 的 Issue读文件内容帮我看一下 README.md 的内容典型产出长这样gh issue list --limit 5 --json number,title,state,createdAt不必再去背零散的命令直接用人话提问就行。四、技能文档里的几个关键点官方技能包SKILL.md目前随 v2.96.0 release 发布的核心要点1. 结构化输出优先人类可读的列格式难以被程序解析永远先考虑--json# 查看全部可用字段 gh issue list --limit 1 --json # 指定字段 gh issue list --json number,title,state,createdAt # 直接按 jq 过滤 gh issue list --json number,title --jq .[] | select(.title | contains(bug))注意--template/-T在gh pr create -T、gh issue create -T上会和 body-template 撞名用前先--help看一眼。2. 分页必须显式指定列表命令默认只返回 30 条且不暴露totalCount没有全部共 N 条这种字段。需要总数就得退回 GraphQLgh api graphql -f query query { repository(owner: cli, name: cli) { issues(first: 0) { totalCount } } }需要下一页用--paginategh api --paginate repos/cli/cli/issues3. Repo 定位别含糊gh默认从当前目录的 git remote 推断仓库。要明确指定gh issue list --repo cli/cli # 简写 gh issue list -R cli/cli4. Search vs List 的语义差异场景用什么跨仓库搜索、按 author/label 过滤gh search issues|prs|code|repos|commits|users当前仓库内的列表gh issue list/gh pr list搜索语法里多个 qualifier要分多个 token 写# ✅ 正确 gh search issues repo:cli/cli is:open author:monalisa # ❌ 错误会被当成一个关键字解析 gh search issues repo:cli/cli is:openbot 作者如 dependabot要写--app dependabot--author dependabot会找不到。5. Issue 高级关系子 Issue、阻塞gh issue新版本支持类型化与层级化# 创建时指定类型、父 issue、阻塞关系 gh issue create --type Bug --parent 23 --blocked-by 24,25 # 编辑多个 issue 的关系 gh issue edit 23 34 \ --add-sub-issue 100,101 \ --add-blocked-by 200 # 查看结构化字段 gh issue view 23 --json issueType,parent,subIssues,blockedBy,blocking返回的subIssues、blockedBy、blocking形状是{nodes: [...], totalCount: N},nodes会被截断subIssues100 条blockedBy/blocking各 50 条。要判断是否被截看nodes.length是否等于totalCount。GHES 自托管版本Issue 类型/子 Issue 需要 3.17阻塞关系需要 3.19。6. 看不下去就用gh api一些--json没暴露的字段直接打 REST/GraphQL# PR 的 review thread 评论gh pr view --comments 不显示这种 gh api repos/cli/cli/pulls/1234/comments # 任意 GraphQL gh api graphql -f query... -F varvalue{owner}/{repo}占位符只在 git remote 推断得到时才会被替换要确定性的话显式写。7. 认证状态gh auth status # 人类可读 gh auth status --json # 结构化五、和飞书 CLI 的技能对比维度飞书 CLIGitHub CLI (gh skill)官方支持飞书办公场景专属消息/文档/日历通用 GitHub 操作Issues/PRs/Discussions命令规模200 命令19 个官方 Agent Skills内置gh子命令 1 套gh技能包第三方协议飞书自研MCPmcp-gh等社区实现把gh包装成 MCP 工具AI 适配官方优先官方 社区双轨两者本质理念一致——让 AI 能直接操作系统而不是让人来回搬运粘贴。在 AI 编程工具上先试内置的gh skill install cli/cli gh --scope user通常是最快的路径。六、一个验证脚本装完跑一下看有没有装上gh skill list然后让 AI 帮你执行一条命令验证它确实在用技能文档帮我用 gh 查看当前仓库最近的 5 个 Issue。正常会得到类似gh issue list --limit 5 --json number,title,state,createdAt这种带--json的结构化命令而不是gh issue list | head -5这种纯文本管道——后者说明 AI 还没读懂技能文档。小结gh skill是 GitHub CLI v2.67.0 的官方 Agent Skills 管理子命令本质是一份 Markdown 使用说明书装给 AI 看。安装格式是gh skill install OWNER/REPO SKILL_NAMEcli/cli gh用--scope user装到用户级。装好后AI 在调用gh时会自动参考技能文档用--json、-L N等AI 友好的方式拿到数据。看不下去--json没覆盖的字段直接gh api或者gh api graphql。GitHub CLI 和飞书 CLI 是同一思路给 AI 直接操作系统的两种生态实现先试官方的gh skill install通常最省事。