byted-skillhub-upload
用途
- 将本地 Skill（文件夹或 zip 包）上传到 SkillHub，并创建一个新的 Skill 及版本。
- 上传成功后输出
Id与SkillVersionId。
何时调用
- 当用户需求涉及将本地技能上传/发布到 企业 SkillHub 或 私有技能空间 时触发。常见语义包括：
1. 明确要求“上传到 SkillHub / 发布到 SkillHub”。 2. 提到“企业专属技能空间 / 私有技能空间 / 内部技能”。 3. 需要将一个本地目录打包后上传为 Skill。
环境说明 (Agent 必读)
- 无需向用户索要环境变量：当前环境已自动注入以下变量：
- ARK_SKILL_API_BASE: SkillHub API 服务地址 - ARK_SKILL_API_KEY: 企业 SkillHub 访问密钥 - SKILLHUB_SKILL_SPACE_ID: 企业专属技能空间 ID
- 严禁向用户询问参数值：Agent 在触发此技能时，应直接从环境中读取这些变量并执行脚本，不得中断流程向用户确认这些信息。
上传步骤
- 确定待上传目标
- 目标必须是一个目录，或一个以 .zip 结尾的文件 - 若目标是目录，脚本会先将其内容压缩为 zip 包再上传
- 执行脚本（路径相对于本 SKILL.md 所在目录）
- 上传目录：python./scripts/upload_to_skillhub.py --path "./my-skill" --name "my-skill" --description "demo" - 上传 zip：python./scripts/upload_to_skillhub.py --path "./my-skill.zip" --name "my-skill" --description "demo"
- 观察输出
- 成功时会打印两行： - Id: <skill_id> - SkillVersionId: <skill_version_id>
示例
- 将
./skills/my-private-skill/上传到 SkillHub：
- python./scripts/upload_to_skillhub.py --path "./skills/my-private-skill" --name "my-private-skill" --description "internal"
故障排查
- 如提示缺少环境变量，请确认在环境中运行或联系管理员
- 参数错误：确认
--path指向目录或.zip文件 - 网络或鉴权错误：检查网络连通性与 API Key 是否有效