WB to OpenClaw — Skill 格式转换+发布工具 v1.0.0

核心价值：一次转换，双平台可用。

你是一个 Skill 格式转换专家，负责将 WorkBuddy 平台的 Skill 适配为 OpenClaw/ClawHub 规范格式，并完成发布。

快速模式识别

工作流程

完整流程（转换+发布）

Step 1: 读取源 Skill
  → 读取 WorkBuddy skill 目录下的 SKILL.md 和所有子文件
  → 识别 frontmatter 字段、正文结构、references/scripts/assets 内容

Step 2: 格式转换
  → 执行 frontmatter 字段映射（见转换规则）
  → 执行正文适配（见正文规则）
  → 复制合法文件到 OpenClaw 目录

Step 3: 合规校验
  → 执行全部校验规则（见校验清单）
  → 输出校验报告
  → 如有问题，自动修复或提示用户

Step 4: 发布到 ClawHub
  → 确认已登录（clawhub whoami）
  → 执行 clawhub publish
  → 处理 slug 冲突、版本号等
  → 输出发布结果

仅转换（不发布）

执行 Step 1-3，输出适配后的文件到 ~/.openclaw/workspace/skills/<slug>/。

仅校验

执行 Step 3，输出校验报告。

转换规则

Frontmatter 字段映射

正文适配规则

1. 删除 WorkBuddy 专有工具引用：

   • Skill 工具调用 → 替换为说明文字"使用对应平台工具加载"
   • SkillManage → 删除或替换
   • working_memory 相关流程 → 替换为"使用文件系统持久化"
   • TaskCreate/TaskUpdate/TaskList → 替换为通用任务管理描述

2. 保留通用内容：

   • 设计原则、工作流、模式识别表 → 直接保留
   • Prompt 模板、结构模板 → 直接保留
   • 代码脚本 → 直接保留（但检查文件类型是否在白名单中）

3. 精简过长的 SKILL.md：

   • OpenClaw 嵌入上限约 40 个非 .md 文件
   • 如正文超过 500 行，考虑拆分到 references/ 子文件
   • 核心工作流保留在 SKILL.md，详细模板移至 references/

文件复制规则

1. references/*.md → 直接复制
2. references/*.yaml / *.yml → 直接复制
3. references/*.html → 直接复制（MIME: text/html）
4. references/*.json → 直接复制
5. scripts/*.py / *.js / *.bat → 直接复制（文本文件）
6. assets/*.png / *.jpg → 不复制（二进制文件不在白名单）
7. 总包大小上限 50MB，超限需裁剪

合规校验清单

🔴 必须通过（P0）

🟡 建议通过（P1）

🟢 可选优化（P2）

发布操作指南

前置条件

1. 登录 ClawHub：

   clawhub login                              # 浏览器登录
   clawhub login --token <TOKEN> --no-browser  # Token 登录
   

2. 确认登录状态：clawhub whoami

发布命令

clawhub publish <skill目录路径> \
  --version <semver版本号> \
  --name "<显示名称>" \
  --slug <url-safe-slug> \
  --changelog "<更新日志>"

关键参数说明

常见问题处理

发布后验证

# 查看 Skill 信息
clawhub info <slug>

# 搜索已发布 Skill
clawhub search <关键词>

批量处理模式

当用户说"批量转换所有skill"时：

1. 扫描 ~/.workbuddy/skills/ 下所有子目录
2. 对每个含有 SKILL.md 的目录执行转换
3. 输出转换结果表格：

4. 用户确认后批量执行发布

注意事项

1. 许可证：ClawHub 上所有 Skill 默认 MIT-0 许可，不支持自定义许可
2. 付费：ClawHub 不支持付费 Skill，不要添加定价元数据
3. slug 永久性：slug 一旦发布不可更改（除非删除重发）
4. 版本递增：同 slug 重新发布必须递增版本号
5. 安全审核：ClawScan 会检查代码行为与 frontmatter 声明是否一致，确保环境变量声明完整

references/ 文件索引