技能介绍

要解决的问题

WorkBuddy 平台的 Skill 依赖自家专有工具（SkillManage、working_memory、TaskCreate 等）和专有 frontmatter 字段，直接搬到 OpenClaw/ClawHub 会踩一连串坑：agent_created、description_zh 这些字段在 OpenClaw 规范里并不存在，正文里的工具调用引用全部失效，二进制资源和超长正文还会被 ClawHub 拒收。手工迁移一个 skill 可能要花半小时以上，而且审核规则还得逐条核对。

核心能力与工作方式

skill-migrate 把迁移流程拆成三个可独立执行的步骤，对应三种使用场景：

仅校验：只跑合规检查，输出校验报告，不改动任何文件
仅转换：执行前两步，把适配后的文件写到 ~/.openclaw/workspace/skills/
转换+发布：全流程执行，最后通过 clawhub publish 推送到 ClawHub

转换逻辑的核心是字段映射表加正文适配规则：

Frontmatter 映射：name、version、description 直接保留；agent_created 和 description_zh 必须删除；再按需补充 metadata.openclaw 下的 emoji、author、homepage、requires、envVars、os
正文适配：Skill/SkillManage/working_memory/Task* 等专有工具调用替换为通用说明；设计原则、工作流、Prompt 模板、代码脚本原样保留
文件白名单：references/ 下的 .md、.yaml、.json、.html 与 scripts/ 下的脚本直接复制；.png、.jpg 等二进制不复制；总包不超过 50MB

合规校验分为三档：P0 必须通过（SKILL.md 存在、semver 版本号、slug 格式、文件扩展名白名单、环境变量声明一致等）、P1 建议通过（补齐 emoji/author、清除专有字段）、P2 可选优化（正文控制在 500 行以内、非 .md 文件不超过 40 个）。批量模式会扫描 ~/.workbuddy/skills/ 下所有子目录，逐个转换并输出结果表格，用户确认后再统一发布。