Skill 更新与升级管理

要解决什么问题

OpenClaw 里会同时存在来自 SkillHub、ClawHub 和自维护路径的 Skill，版本散落在各目录的 _meta.json 与 SKILL.md frontmatter 里。手工对照官频 index/API 既慢，也容易漏掉 ownerId、slug、publishedAt 等字段不一致的情况；更麻烦的是，本地改过版本的「定制版」一旦被脚本无脑覆盖，就等于静默降级。

技能如何工作

x-skill-updater 通过检查脚本（check.py）从脚本位置向上定位 OpenClaw 根目录，扫描 /skills/ 与 /workspace-*/skills/ 下全部 Skill，再按 data/skill-sources.json 中的来源分流：

• skillhub：对照 COS bucket index
• clawhub：调用 clawhub.ai API
• custom：只记录说明，不自动拉包

核对时把 _meta.json（version / slug / ownerId / publishedAt）与 SKILL.md（author / slug / homepage / metadata）做全量字段比对。核心规则包括：不降级（本地 version 高于官频则标为定制版并跳过）、检查结果先出报告，用户明确回复「更新」后才执行升级；脚本退出码 1 表示有可升级项并通知用户，0 表示无更新仅存档到 data/last-report.md。来源未登记的 Skill 会进入 data/pending-sources.json，你按约定格式回复即可补登记。

适用边界与注意点

• 触发方式：用户说「检查 skill 更新」等，或 cron 每周一 09:00 定时检查（有可升级时才需要用户确认）。
• 文档中的 ~/.openclaw 仅为示例，实际以你机器上的 OpenClaw 根目录为准。
• 官频版本不完整或字段冲突会标为 需关注，不会擅自改文件；custom 来源仍需你自行跟进上游。