跳到正文
早期资源档案 · 内容保留供查阅探索设计 Skills →

gh skill 安装 Agent Skill 前先验 5 项

给准备用 GitHub CLI 管理 Agent Skills 的团队一份安装、更新、发布前检查清单。

`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、维护人和“不适合做什么”。

来源

gh skill 管理 Agent Skills 前检查清单