Skill Publisher
将本地 Agent 技能发布到多个平台。支持单平台发布、一键多平台发布，平台可扩展。
平台架构
采用插件式平台注册，每个平台是独立适配器，通过统一元数据声明自己的能力。
skill-publisher/
SKILL.md
scripts/
publish.sh # 主入口
platform_registry.sh # 平台注册表 & 能力发现
platform_clawhub.sh # ClawHub 适配器
platform_github.sh # GitHub Releases 适配器
platform_skillhub.sh # SkillHub CN 适配器
validate.sh
version.sh
status.sh
references/
adding-platforms.md # 如何添加新平台
platform-interface.md # 完整接口规范
平台适配器声明（manifest）
每个平台适配器在文件头部以注释形式声明元数据：
# @platform_name: clawhub
# @platform_label: ClawHub (OpenClaw Registry)
# @auth_method: cli # cli | api_key | oauth | web_login | ssh_key | none
# @auth_check: clawhub whoami
# @auth_hint: "请先运行: clawhub login"
# @upload_type: tarball # tarball | files | http_api | cli_tool
# @upload_command: clawhub publish
# @requires_bin: clawhub
# @install_hint: "npm i -g clawhub"
# @supports_changelog: true
# @supports_version: true
认证方式（@auth_method）
| auth_method | 说明 | 适配器职责 |
|---|---|---|
cli |
CLI 工具自带登录 | 调用 CLI 检查登录态，给出登录提示 |
api_key |
环境变量或配置文件 | 检查环境变量，提示设置方式 |
oauth |
OAuth 浏览器授权 | 返回授权 URL，等待 token 输入 |
web_login |
浏览器登录（无 CLI） | 打开浏览器，提示粘贴确认码 |
ssh_key |
SSH 密钥认证 | 检查密钥，提示添加到平台 |
none |
无需认证 | 直接跳过 |
上传方式（@upload_type）
| upload_type | 说明 | 适配器职责 |
|---|---|---|
tarball |
打包 tar.gz 后上传 | 主流程打包，适配器接收路径并上传 |
files |
逐文件上传 | 遍历目录，逐文件调用上传接口 |
http_api |
HTTP REST API | 构造 HTTP 请求上传 |
cli_tool |
委托第三方 CLI | 组装命令行并执行 |
标准函数接口
# 必选
platform_<name>_manifest # 返回元数据 JSON
platform_<name>_check_auth # 检查认证
platform_<name>_publish # 执行发布
# 可选
platform_<name>_validate # 平台特定验证
platform_<name>_status # 查询远程版本/状态
platform_<name>_post_publish # 发布后钩子
platform_<name>_help # 平台帮助信息
主流程
publish <path> --to <platforms>
│
├─ 1. validate ← 全局验证
├─ 2. version check ← 版本号管理
├─ 3. for each platform:
│ ├─ manifest ← 读取平台能力
│ ├─ check_auth ← 检查认证
│ ├─ validate ← 平台验证（可选）
│ ├─ package ← 按 upload_type 打包
│ ├─ publish ← 上传
│ └─ post_publish ← 后钩子（可选）
└─ 4. summary ← 汇总结果
内置平台
🟢 ClawHub（OpenClaw 官方）
- auth:
cli（clawhub login） - upload:
tarball→clawhub publish - 支持 slug、changelog、版本管理
🟣 GitHub Releases
- auth:
cli（gh auth login） - upload:
cli_tool→gh release create - 自动创建 tag，附带 tarball
🟠 SkillHub CN（腾讯云 ClawHub 镜像）
- 地址:
skillhub.cloud.tencent.com - 模式:
mirror（ClawHub 镜像，发布到 ClawHub 后自动同步） - auth: 无需单独认证，通过 ClawHub 发布即可
- 专为中国用户优化，国内高速下载
第三方扩展
参考 references/adding-platforms.md，社区可添加：
| 平台 | auth | upload | 说明 |
|---|---|---|---|
| GitLab Packages | api_key | http_api | REST API |
| Gitee | ssh_key | cli_tool | git push |
| 自建 Registry | api_key | http_api | POST tarball |
| 飞书云盘 | oauth | files | lark-cli 逐文件上传 |
| ClawHub Mirror | none | mirror | 自动同步，无需单独发布 |
命令
# 验证
skill-publisher validate <skill-path>
# 打包
skill-publisher package <skill-path> [--output <dir>] [--version <ver>]
# 发布
skill-publisher publish <path> --to <platform> [平台参数...]
skill-publisher publish <path> --to clawhub,github
skill-publisher publish <path> --to all
skill-publisher publish <path> --to <platform> --yes
# 版本管理
skill-publisher version <skill-path>
skill-publisher version <skill-path> --bump patch|minor|major
skill-publisher version <skill-path> --set <ver>
# 状态检查
skill-publisher status <skill-path>
# 平台管理
skill-publisher platforms list
skill-publisher platforms info <name>
安全规则
- 发布前自动 validate，失败则中止
- 不发布含敏感关键词的文件
- 认证凭证不写入日志或输出
- 所有发布操作需用户确认（
--yes跳过） - 每次发布记录到
~/.openclaw/skill-publisher/history.jsonl（不含凭证）
参考
- ClawHub CLI:
clawhub --help - GitHub CLI:
gh release create --help - SkillHub CN: https://skillhub.cn/
- OpenClaw 技能规范:
skill-creatorskill
