`gh skill` 把 GitHub 仓库变成了 Agent Skill 的发现、安装、更新和发布入口。方便是真的,但它也把 skill 安装变成了供应链动作,不能只按复制命令处理。
先验 CLI 版本
GitHub 把 `gh skill` 标为 public preview,并要求 GitHub CLI 2.90.0 或更高版本。团队文档写安装命令前,先跑 `gh --version` 和 `gh skill --help`。
安装前必须 Preview
可以用 `gh skill search` 找候选,但不能把搜索结果当批准。先用 `gh skill preview` 看 `SKILL.md` 和文件树,因为 GitHub 明确提醒 skills 未经验证,可能包含 prompt injection、隐藏指令或恶意脚本。
- 打开原始仓库。
- 读完整说明和 supporting files。
- 拒绝来源不清、路由含糊、要求大范围信任的 skill。
Scope 和 Pin 要分清
项目规范用 project scope;跨项目个人工作流才考虑 user scope。团队生产 skill 建议 pin 到已审过的 tag 或 commit,避免 silent update 改掉 agent 行为。
更新按代码审
`gh skill update` 会用本地 metadata 和上游变化对比。共享 skill 先跑 `--dry-run`,再看上游 diff;不要轻易 force 覆盖本地改过的 skill 文件。
发布前先 Dry Run
维护者发布 skill 前,先用 `gh skill publish --dry-run` 验证格式和元数据,再决定 tag、release、license、维护人和“不适合做什么”。
来源
- GitHub·官方资料·核心来源GitHub Changelog: Manage agent skills with GitHub CLI
- GitHub·官方资料·核心来源GitHub CLI manual: gh skill
- GitHub·官方资料·核心来源GitHub Docs: Adding agent skills for GitHub Copilot
- GitHub·官方资料·辅助来源GitHub CLI manual: gh skill install
- GitHub·官方资料·辅助来源GitHub CLI manual: gh skill update
- GitHub·官方资料·辅助来源GitHub CLI manual: gh skill publish
- GitHub·官方资料·辅助来源GitHub CLI manual: gh skill search
