Agent Skills
返回列表
🤖

Skill Hub 命令行查询

AI Agent 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_2a52e6b3/skill-hub-query。

技能介绍

要解决什么问题

团队若自建 Skill Hub，或对接实现文档化 API 契约的兼容节点，Agent 和用户仍需要一套可脚本化、行为一致的入口：查目录、看版本、拉 ZIP 安装。该技能不面向 clawhub.ai（其 API 与官方 clawhub CLI 不同）；它面向私有 Hub 或通用契约 Hub，并额外提供 skillhub.cn 内置适配。

核心怎么工作

  • 双通道：配置了 SKILL_HUB_TOKEN（或 credentials 文件）时走 OpenAPI 全能力（含私有技能）；无 token 时降级到 legacy 公开检索/安装，并在首次使用时提示配置 token。
  • 三条主脚本：sync.sh 维护本地 JSON 缓存（通用 Hub）；query.sh 按关键词、时间、组合条件检索并输出可读表格；install.sh 下载并解压到自动探测的技能目录。解压走 Python zipfile，避免系统 unzip 破坏非 ASCII 文件名。
  • skillhub.cn 模式：设置 SKILL_HUB_PROVIDER=skillhub_cn 后直连 https://api.skillhub.cn，检索/详情/版本/安装为实时 API，sync.sh 仅为 no-op；无需 token。
  • Agent 约定：安装前用 query.sh slug 确认展示名与版本，必须经用户明确同意后再带 --yes 调用 install.sh；批量安装串行执行并汇总失败。

边界与注意点

  • 通用契约 Hub 必须配置 SKILL_HUB_URL（无内置默认）；上线前跑 bash scripts/doctor.sh。
  • 本地缓存适合发现技能；latestVersion 在缓存过期时与新版无异，版本决策、发布基线务必先 sync.sh（缓存超过 7/30 天会 stderr 告警）。skillhub.cn 不受此缓存规则影响。
  • skillhub.cn 不支持 edit.sh 改卡片字段（元数据来自上游同步）；legacy 无 token 时以源 IP 识别用户，共享主机需 per-user token。
  • 勿回显完整 token、勿写入 git 或 credentials 目录外。

使用场景

  • Agent 对话中用户要求从 skillhub.cn 按关键词搜技能，核对展示名与版本后再执行安装。
  • 自建 Skill Hub 上按「本周」「某作者」等条件浏览新上架条目，整理 name/author/version 表给团队。
  • 私有技能仅 token 通道可下载：先 query 定位 slug，经用户确认后用 install.sh 拉 ZIP 到技能目录。
  • 发布或升级前怀疑本地缓存过旧，先 sync 再读 slug 的 latestVersion，避免以错误基线定版本号。

适合人员

  • 维护公司内网或兼容 API 契约的 Skill Hub、需要给脚本与 Agent 统一 query/sync/install 入口的平台工程师。
  • 主要使用 skillhub.cn 公开目录、希望在对话里完成检索并在明确授权后再安装的 AI 辅助编程用户。
  • 编排 Agent 工作流时要把 Hub 查询与安装写进 SKILL.md 约定、且不能擅自加 --yes 的集成/技能作者。
  • 在通用 Hub 上维护多个 slug、发布前依赖 sync 与 query 核对版本与 changelog 的技能维护者。