/skill-publish-sync

name: skill-publish-sync
homepage: https://github.com/cat-xierluo/legal-skills
author: 杨卫薪律师（微信ywxlaw）
version: "1.7.2"
license: MIT
description: 将本地开发的 Skills 同步到 ClawHub、腾讯 SkillHub 与联想开放平台。支持智能 .gitignore 过滤、平台独立白名单、增量与单个 skill 同步。本技能应在用户需要将本地 skills 发布到上述平台、批量同步技能或检查发布状态时使用。

Skill 同步工具（ClawHub + 腾讯 SkillHub）

将本地开发的 Skills 批量同步到三个公开平台：

• **ClawHub** — 国际通用 Skills 社区，强制 MIT-0 许可证
• **腾讯 SkillHub** — 专为中国用户优化的 Skills 社区，无许可证限制
• **联想开放平台** — 面向联想 AI 智能体生态，使用 `@lenovo-open/skill-cli` (Node.js)；无强制许可证

支持读取 `.gitignore` 智能忽略敏感文件和临时文件。三个平台各自维护独立的 allowlist 列表文件（`allowlist-clawhub.yaml` / `allowlist-skillhub.yaml` / `allowlist-lenovo.yaml`），同一 skill 可在多份文件中独立维护字段（一对多，不强制不重复分发）。

依赖

系统依赖

| 依赖 | 用途 | 安装方式 | |------|------|----------| | `rsync` | `prepare-publish.sh` 复制过滤文件到临时发布目录 | macOS 自带；Linux: `sudo apt-get install rsync` | | `git` | `prepare-publish.sh` 用 `git ls-files` 精确匹配追踪文件 | macOS 自带；Linux: `sudo apt-get install git` | | Python 3 | 运行腾讯 SkillHub CLI（Python 脚本） | macOS 自带；Linux: `sudo apt-get install python3` | | Node.js（≥ 18）+ `npm` | 运行联想 `lenovoskill` CLI（`npx @lenovo-open/skill-cli` 走 Node.js 运行时） | macOS 自带或 `brew install node`；Linux: `sudo apt-get install -y nodejs npm` |

CLI 工具（按目标平台按需安装）

| CLI | 用途 | 安装命令 | 必需场景 | |------|------|----------|----------| | `clawhub` | 发布到 ClawHub | 见 [ClawHub 官方文档](https://docs.openclaw.ai/clawhub/cli) | 仅发布 ClawHub 时 | | `skillhub` | 发布到腾讯 SkillHub | 官方 CLI，`skillhub self-upgrade` 升级（须 ≥ 2026.7.29） | 仅发布 SkillHub 时 | | `lenovoskill`（`npx @lenovo-open/skill-cli`） | 上传到联想开放平台 | `npx @lenovo-open/skill-cli <cmd>`（免装，推荐）或 `npm i -g @lenovo-open/skill-cli` | 仅上传联想平台时 |

> **⚠️ 版本要求（重要）** > > 腾讯 `skillhub` CLI **必须 ≥ 2026.7.29** 才支持 `publish`/`login`。早期版本（如 2026.3.18）只有 `search`/`install`，不能发布。 > 运行 `skillhub self-upgrade` 升级到最新版；不确定时先用 `skillhub self-upgrade --check-only` 检查是否有新版。

首次安装清单（SkillHub 发布）

# 1. 安装 CLI（macOS/Linux）
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

# 2. 升级到支持发布的版本（≥ 2026.7.29）
skillhub self-upgrade

# 3. 验证（应含 publish/login 命令）
skillhub --help

# 4. 登录（token 从 https://skillhub.cn 个人设置获取，skh_ 前缀）
skillhub login --key skh_xxx

# 5. 确认身份
skillhub auth whoami

> **ClawHub 强制使用 MIT-0 许可证**（无需署名，允许商业使用）。 > **腾讯 SkillHub 无许可证限制**，CC-BY-NC / MIT / Apache 等均可发布。 > > **ClawHub 许可证关键条款**（来自官方 Skill Format 文档，截至 2026-08 核实）： > - "All skills published on ClawHub are licensed under `MIT-0`." —— 所有发布即等同 MIT-0。 > - "Anyone may use, modify, and redistribute published skills, including commercially." —— 允许任何人商用。 > - "Attribution is not required." —— 不要求署名。 > - "ClawHub does not support per-skill license overrides." —— **不支持按 skill 覆盖许可证**（frontmatter 写 `license: CC-BY-NC` 平台层面不生效）。 > - "Do not add conflicting license terms in `SKILL.md`." —— **禁止在 SKILL.md 内加冲突的许可证条款**。 > > 因此（**v1.7.1 三份独立列表架构**）： > - 每个平台独立维护自己的 allowlist 文件：ClawHub / SkillHub / 联想各一份 > - MIT 许可证的通用工具 skill → 默认只发 ClawHub（`allowlist-clawhub.yaml`） > - CC-BY-NC 等限制性许可证的法律类 skill → 默认只发 SkillHub（`allowlist-skillhub.yaml`，ClawHub MIT-0 冲突不收） > - 想在 ClawHub / SkillHub 之外额外分发到联想生态的 skill → 在 `allowlist-lenovo.yaml` 里登记（无许可证限制，可与 SkillHub / ClawHub 重复登记，即同一 skill 跨多份文件是完全允许的） > - ClawHub slug 被占用、发不了的 → 从 `allowlist-clawhub.yaml` 移到 `allowlist-skillhub.yaml` 或 `allowlist-lenovo.yaml` > > 即**三份独立 allowlist 文件**，每份独立维护各自平台的 skill 名单与字段；同一 skill 可同时出现在多份文件里（一对多），无需为新平台改动旧 skill 的配置。详见 DECISIONS `D-2026-08-12-02`。 > > ClawHub 许可证详见 [ClawHub Skill Format 官方文档](https://docs.openclaw.ai/clawhub/skill-format)

---

平台对比

| 维度 | ClawHub | 腾讯 SkillHub | 联想开放平台 | |------|---------|---------------|---------------| | CLI 工具 | `clawhub` | `skillhub`（官方 CLI，`skillhub self-upgrade` 升级；**须 ≥ 2026.7.29** 才支持 publish/login） | `lenovoskill`（`npx @lenovo-open/skill-cli`，Node.js 运行时） | | 登录命令 | `clawhub login` | `skillhub login --key skh_xxx` | `lenovoskill login`（OAuth 浏览器授权） | | 发布命令 | `clawhub publish <path> --slug --name --version --changelog` | `skillhub publish <path> [--version] [--changelog] [--dry-run]` | `lenovoskill package && lenovoskill push`（两步：先打 zip 再传） | | skill 标识 | `--slug` + `--name`（命令行传入） | `slug` + `displayName`（prepare-publish.sh 从 `allowlist-skillhub.yaml` 注入临时副本；源 SKILL.md 不含） | `slug` + `displayName`（prepare-publish.sh 从 `allowlist-lenovo.yaml` 注入临时副本；源 SKILL.md 不含） + 项目内 `.skill-config.json` | | 凭证位置 | clawhub CLI 默认 | 本地 skillhub 配置 | `~/.lenovoskill/auth.json`（600，OAuth 双 token：Login Token + Biz Token）+ `~/.lenovoskill/config.json`（默认 API） | | 可见性 | 无 | —（无此概念） | —（无此概念） | | namespace | 无 | **有**（绑定账号，发布命令不传，记录用于溯源） | **无**（OAuth 双 token，无 namespace 概念） | | **许可证** | **强制 MIT-0** | **无限制** | **无限制** | | 默认 registry/API | 内置 | `https://api.skillhub.cn` | `https://open.lenovomm.com` | | 官方教程 | — | https://skillhub.cn/tutorials#publish-via-cli | https://open.lenovomm.com |

---

前置条件

SKILL.md frontmatter 必需字段

---
name: skill-name
description: 技能描述
version: "1.0.0"  # 推荐但不强制
homepage: https://github.com/cat-xierluo/legal-skills  # 自动设置
---

> **slug / displayName 不写进 SKILL.md**。SkillHub 需要的字段从 `config/allowlist-skillhub.yaml` 读取；联想开放平台需要的字段从 `config/allowlist-lenovo.yaml` 读取。**每个平台独立白名单，字段独立维护**（同一 skill 可同时出现在多份文件里，一对多）。发布前由 `prepare-publish.sh`（`--platform skillhub` 或 `--platform lenovo`）自动注入临时副本 frontmatter。源 SKILL.md 只保留 skill 标准字段，平台元数据与 skill 本体解耦。ClawHub 不依赖 frontmatter（用 `--slug`/`--name` 命令行参数）。

CLI 安装

CLI 工具的完整安装方式、版本要求，详见本文档开头「[依赖](#依赖)」章节。

快速验证已安装：

clawhub --version      # ClawHub
skillhub --help        # SkillHub（确认含 publish/login 命令即为发布版）

---

使用方式

1. 登录平台（首次使用）

**ClawHub**：

clawhub login

**腾讯 SkillHub**（使用 API Token，格式 `skh_xxx`，从 SkillHub 个人设置获取）：

# token 从 https://skillhub.cn 个人设置获取（skh_ 前缀）
skillhub login --key skh_xxx

# 如需临时使用其他 token 覆盖登录态（不写入本地）
skillhub login --key skh_yyy

> 登录后 token 存在本地，后续发布命令无需重复传 token。也可在 `skillhub publish` 时用 `--token skh_xxx` 临时覆盖。

2. 验证登录状态