用途:把一份可维护的来源清单(scripts/manifest.local.json)中的 skill 批量导入或更新到 Multica 工作区 skill 数据库,将安装或更新一批 skill 变成一条命令或定时任务。适合需要从外部来源批量安装、并周期性刷新 skill 的场景。
主要能力:支持 GitHub、ClawHub、skills.sh 及本地文件来源;提供 init(初始化导入)、update(更新刷新)、plan(预览操作)三种模式,可按 category 筛选。每次运行输出结构化同步报告,区分 imported、conflict(existed)、skipped、failed。
使用方式:复制模板 cp scripts/manifest.example.json scripts/manifest.local.json 并填写真实来源;本地 skill 用 source=file 加本机路径,云端用 source=github/clawhub/skills.sh 加 URL。执行命令如 python scripts/sync_skills.py --mode init、--mode update、--mode plan,可用 --manifest、--dry-run、--category 参数。连接时通常需显式指定 profile 与 workspace-id。脚本会探测 multica CLI,也可用 --multica-bin 指定路径;缺少 CLI 时退出码 2。
限制:同步对象是 Multica 数据库,不是本地 .codebuddy/skills/ 路径;不负责定时,需由 Multica Autopilot 的 CRON 触发。来源刷新须用 import --on-conflict overwrite,而非 multica skill update;overwrite 仅限原始创建者,非本人来源宜用 skip。--url 与 --file 互斥;--on-conflict 默认 fail。使用 App 内置 CLI 需指定 profile 与 workspace。autopilot 相关 flags 以本机 --help 为准。