Agent Skills
返回列表
💻

SkillHub 发布管道

开发编程 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_c6124052/skillhub-cli-publish-pipeline。

技能介绍

需要解决的问题

WorkBuddy 内置的 BuiltinMarket 仅支持技能的搜索与安装,无法实现反向发布。若要把本地开发的技能上架到 SkillHub 平台,必须依赖官方的独立 CLI 工具来处理鉴权与上传请求。

Skill 运作方式

该技能的核心是一套完整的发布管道,标准流程为:本地技能目录 -> Token 鉴权 -> skillhub publish HTTP 请求 -> 平台审核。

关键步骤与环境适配:

  • CLI 安装与审计:推荐下载官方 tarball 到用户目录,手动审查 install.sh 脚本后,使用 --cli-only 参数安装,避免捆绑无用的默认技能。
  • Windows 环境路径映射:在 Git Bash 下,Python 可能将 /c/Users/... 错误解析为 D:\c\Users\...。技能要求手动修正包装脚本中的路径映射逻辑,确保 Windows Python 正确识别文件位置。
  • Python 3 别名检查:Git Bash 环境通常缺少 python3 别名,需通过创建符号链接来让 CLI 的基础环境检查通过。
  • 鉴权与发布机制:登录需用户提供 skillhub.cn 个人中心获取的 skh_ 前缀 Token,并通过 --key 参数显式传递,CLI 不支持环境变量自动读取。执行 skillhub publish 时,传入包含 SKILL.md 的目录,工具会携带本地存储的凭证完成 HTTP 上传。

适用边界与注意点

  • 反向发布的限制:WorkBuddy 内置的 BuiltinMarket 完全不具备发布能力,必须通过此 CLI 或网页端操作。
  • 凭证安全:切勿在技能代码、脚本或聊天历史中暴露真实的 skh_ Token,将其视为敏感密钥处理。
  • 鉴权失效处理:若登录后执行 whoami 等命令报认证失败,需重新使用 --key 参数提供凭证。
  • 目标格式约束:发布的目标目录或 .zip 文件必须包含结构合法的 SKILL.md 文档。

使用场景

  • 开发完一个本地 WorkBuddy 技能后,需要通过 CLI 登录并上传到 SkillHub 平台进行审核。
  • 在 Windows Git Bash 环境下发布技能时,需要修复 Python 执行 Unix 路径时的映射错误。
  • Git Bash 环境中缺少 python3 别名导致 CLI 校验失败,需要创建符号链接以通过检查。
  • 需要将本地包含 SKILL.md 的技能目录打包或直接指定,通过 HTTP 请求发布到远端服务器。

适合人员

  • 开发自定义 WorkBuddy 技能并需要将其上架到官方社区的独立开发者。
  • 在 Windows 环境下使用 Git Bash 进行命令行工具发布与维护的运维工程师。
  • 需要处理 CLI 依赖环境与外部凭证安全配置的后端开发人员。