企业官网建设流程全解析

如何用 GitHub CLI 的 gh skill 命令固定 Scientific Agent Skills 版本并执行更新

【免费下载链接】scientific-agent-skillsTurn any AI agent into an AI Scientist. The #1 Agent Skills library for science, used by 190,000+ scientists worldwide. 165 ready-to-use validated skills plus 100+ scientific databases covering biology, chemistry, medicine, and drug discovery. Compatible with Cursor, Claude Code, Codex, Pi, Antigravity, and the open Agent Skills standard.项目地址: https://gitcode.com/GitHub_Trending/cl/scientific-agent-skills

Scientific Agent Skills 是一个包含 163 个科研技能的 Agent Skills 标准技能库，技能会随仓库持续更新。如果你希望团队成员安装的是同一个固定版本，而不是某个随时变化的分支，可以用 GitHub CLI 的gh skill命令在安装时通过--pin参数锁定版本，之后再用gh skill update有控制地更新。这条路径适用于 macOS、Linux 或 Windows (WSL2)，要求 GitHub CLI 版本为 v2.90.0+，并且你的 AI agent 支持 Agent Skills 标准（如 Cursor、Claude Code、Codex、Google Antigravity 等）。

准备工作

执行前确认两件事：

• 本机已安装 GitHub CLI，且版本不低于 v2.90.0（gh skill子命令从该版本提供）。
• 你使用的 agent host 支持 Agent Skills 标准，这样安装完成后 host 才能从已配置的 skills 路径发现技能。

另外注意：gh skill本身只负责安装技能文件。技能运行所需的 Python 依赖仍由各个技能各自声明，仓库推荐用uv安装这些依赖，具体包名以对应技能的SKILL.md为准。

安装时用 --pin 固定版本

当前集合版本为 2.65.0（见 pyproject.toml 与 plugin.json），对应 README 示例中使用的v2.65.0发布标签。--pin支持两种固定方式：

# Pin to a release tag gh skill install K-Dense-AI/scientific-agent-skills --pin v2.65.0 # Pin to a commit SHA gh skill install K-Dense-AI/scientific-agent-skills --pin abc123def

两条命令的区别在于固定的粒度：

• 第一条固定到一个 release tag，适合锁定一个已发布的集合版本；
• 第二条固定到一个 commit SHA，适合锁定到某个精确提交。abc123def是文档中的占位示例，实际使用时替换为你要固定的真实 commit SHA。

README 将这两种方式描述为用于可复现安装（reproducible installs）。仓库 README 的 "Security and safe deployment" 部分也给出了配套建议：固定版本，而不是追踪一个分支。

可选分支：只装单个技能或指定 host

如果你只需要某个技能（例如 scanpy），而不是整个集合，在同一个安装命令中加上技能名即可：

# Install a specific skill directly gh skill install K-Dense-AI/scientific-agent-skills scanpy

如果你的机器上配置了多个 agent host，可以用--agent明确安装目标，README 给出的四个示例值如下：

gh skill install K-Dense-AI/scientific-agent-skills --agent cursor gh skill install K-Dense-AI/scientific-agent-skills --agent claude-code gh skill install K-Dense-AI/scientific-agent-skills --agent codex gh skill install K-Dense-AI/scientific-agent-skills --agent gemini

不带这些参数的gh skill install K-Dense-AI/scientific-agent-skills则是交互式浏览安装。首次使用时建议只安装你实际需要的技能，并在安装前阅读对应技能的SKILL.md——这是 README 安全声明中明确给出的两条建议。

验证安装是否生效

gh skill会把技能自动安装到对应 agent host 的正确目录，并记录 provenance metadata 用于供应链完整性。安装完成后的判断方式如下：

1. 重启你的 agent/IDE（复制技能后需要重启才会被发现）。
2. 在提示词中直接提到技能名，手动调用该技能；README 说明兼容 host 可以从已配置路径发现技能，也可以靠提及技能名来手动触发。
3. 如果技能没有加载，按 README 的 Troubleshooting 逐项检查：
   • 技能目录是否在正确位置；
   • 每个技能文件夹内是否包含SKILL.md文件；
   • 在 Cursor 中可额外检查 Settings → Rules 确认技能被发现。

更新已固定的技能

需要升级时，使用gh skill update：

# Check for updates interactively gh skill update # Update all installed skills gh skill update --all

第一条进入交互式流程逐个检查更新，第二条直接更新所有已安装技能。如果你希望把多个环境统一升到同一个版本，更稳妥的做法是用--pin指向同一个 release tag 重新安装，而不是依赖默认的自动更新路径。

边界与常见问题

• v2.43.0+ 的路径变化：README 记录了这样一个故障现象——gh skill install或文档链接指向scientific-skills/会失败，原因是自 v2.43.0 起技能目录从scientific-skills/改为skills/，以匹配 GitHub CLI 期望的 Agent Skills 布局。如果你还留着旧的手动复制路径、书签或引用，需要从scientific-skills/<name>更新为skills/<name>，并在拉取最新发布后重新执行gh skill install K-Dense-AI/scientific-agent-skills。
• 不要混淆集合版本与技能版本：v2.65.0是整个集合的版本（pyproject.toml中的版本），而每个技能的SKILL.mdfrontmatter 里还有各自的metadata.version，两者是不同层面的版本号。
• 固定版本不等于免审：README 的安全声明强调技能可以执行代码、安装包、发起网络请求，固定版本只是保证你拿到的内容与预期一致，安装前仍应审查技能内容。

完成以上步骤后，你得到的是一条可复现的安装链：--pin决定装哪个版本，gh skill update（或按新 tag 重装）决定何时升级到哪个版本，两者之间的状态都可以从安装记录与 host 的 skills 目录中核对。

【免费下载链接】scientific-agent-skillsTurn any AI agent into an AI Scientist. The #1 Agent Skills library for science, used by 190,000+ scientists worldwide. 165 ready-to-use validated skills plus 100+ scientific databases covering biology, chemistry, medicine, and drug discovery. Compatible with Cursor, Claude Code, Codex, Pi, Antigravity, and the open Agent Skills standard.项目地址: https://gitcode.com/GitHub_Trending/cl/scientific-agent-skills