SkillHub 发布管道
将以下提示词粘贴到你的 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 依赖环境与外部凭证安全配置的后端开发人员。