GitHub CLI 新增 gh skill 命令，统一管理 AI 编程 Agent 技能包
GitHub CLI 新增 gh skill 命令，统一管理 AI 编程 Agent 技能包
基于已整理草稿生成的网页版文章，适合先稳定落地，再做局部润色与发布检查。
如果你用 AI 编程 Agent，可能遇到过这样的问题：找到一个好用的"技能包"，却不知道装到哪个目录；或者同事分享了一段 Agent 提示词，你手动复制粘贴后才发现版本对不上。
4月16日，GitHub CLI v2.90.0 发布了 gh skill 命令（Public Preview），专门解决这个痛点——用一个命令行工具，跨多个 Agent Host 管理技能包。
什么是 Agent Skills？
Agent Skills（智能体技能）是一套可移植的"教学包"，包含指令、脚本和资源，教 AI 编程 Agent 如何执行特定任务。
比如，你可以有一个"代码审查"技能包，教 Agent 如何检查代码风格、发现潜在 bug、生成审查意见。或者一个"文档生成"技能包，教 Agent 如何从代码中提取注释、生成 API 文档。
这些技能包遵循开放的 [Agent Skills 规范](https://agentskills.io)，可以在不同的 Agent Host 之间移植。目前支持的平台包括：
- GitHub Copilot
- Claude Code
- Cursor
- Codex
- Gemini CLI
- Antigravity
gh skill 能做什么？
gh skill 是 GitHub CLI 新增的命令组，主要功能包括：
发现技能包
```bash
搜索技能包
基于已整理草稿生成的网页版文章，适合先稳定落地，再做局部润色与发布检查。
gh skill search copilot
预览技能包内容（不安装）
基于已整理草稿生成的网页版文章，适合先稳定落地，再做局部润色与发布检查。
gh skill preview github/awesome-copilot documentation-writer
```
安装技能包
```bash
安装到默认目录
基于已整理草稿生成的网页版文章，适合先稳定落地，再做局部润色与发布检查。
gh skill install github/awesome-copilot documentation-writer
指定 Agent Host 和作用域
基于已整理草稿生成的网页版文章，适合先稳定落地，再做局部润色与发布检查。
gh skill install github/awesome-copilot documentation-writer --agent claude-code --scope user
锁定版本
基于已整理草稿生成的网页版文章，适合先稳定落地，再做局部润色与发布检查。
gh skill install github/awesome-copilot documentation-writer --pin v1.2.0
```
技能包会自动安装到对应 Agent Host 的正确目录。
更新技能包
```bash
检查更新
基于已整理草稿生成的网页版文章，适合先稳定落地，再做局部润色与发布检查。
gh skill update
更新所有已安装的技能包
基于已整理草稿生成的网页版文章，适合先稳定落地，再做局部润色与发布检查。
gh skill update --all
```
发布技能包
如果你维护技能包仓库，可以用 gh skill publish 验证技能包是否符合规范，并检查远程设置（如标签保护、密钥扫描、代码扫描）。
```bash
验证所有技能包
基于已整理草稿生成的网页版文章，适合先稳定落地，再做局部润色与发布检查。
gh skill publish
自动修复元数据问题
基于已整理草稿生成的网页版文章，适合先稳定落地，再做局部润色与发布检查。
gh skill publish --fix
```
供应链安全：不只是包管理
技能包本质上是一段"可执行指令"——它会影响 AI Agent 的行为。如果技能包在发布后被悄悄修改，就是供应链风险。
gh skill 在设计上借鉴了包管理器的安全实践：
版本锁定
用 --pin 锁定到特定标签或 commit SHA，避免意外升级：
```bash
gh skill install github/awesome-copilot documentation-writer --pin v1.2.0
```
不可变发布
gh skill publish 会建议开启 [immutable releases](https://docs.github.com/repositories/releasing-projects-on-github/about-releases)，确保发布内容无法被修改，即使管理员也不行。
内容寻址变更检测
每个已安装的技能包会记录源目录的 git tree SHA。gh skill update 比对本地和远程 SHA，检测真正的"内容变更"，而不仅仅是版本号变化。
便携式溯源元数据
溯源信息（仓库、引用、tree SHA）直接写入技能包的 SKILL.md front-matter。这意味着即使技能包被复制、移动到其他项目，版本追踪信息也不会丢失。
对开发者的实际意义
统一管理：如果你同时使用 GitHub Copilot 和 Claude Code，以前要分别管理技能包目录；现在用 gh skill 一个命令搞定。
安全可控：技能包来源透明、版本可锁定、变更可追踪。这对团队协作尤其重要——你可以确保所有人用的是同一个版本的技能包。
易于分享：GitHub 仓库就是技能包来源。分享技能包只需要分享仓库链接，安装只需要一条命令。
小结
gh skill 的推出，意味着 Agent 技能包管理从"手动复制粘贴"进入了"包管理器"时代。
对于使用多 Agent 工作流的开发者，这是一个值得尝试的升级。目前处于 Public Preview 阶段，可能会有变动，但基础功能已经可用。
如果你有兴趣，可以更新 GitHub CLI 到 v2.90.0，然后运行 gh skill --help 查看详细用法。
---
*信息来源：GitHub Blog Changelog（2026-04-16）、GitHub CLI Releases*
参考来源
说明：该页面由基础模板稳定生成，后续可继续局部润色样式或补充模块，再进入发布检查。