发布你的 Skill 到 ClawHub：打包和版本管理

开发完成的 Skill 需要通过规范的打包和版本管理才能发布到 ClawHub。本文详解发布流程、版本策略和社区规范，助你成为合格的 Skill 开发者。

一、核心概念

ClawHub 采用语义化版本控制（SemVer：MAJOR.MINOR.PATCH）。MAJOR 版本表示不兼容的 API 变更；MINOR 版本表示向后兼容的功能添加；PATCH 版本表示向后兼容的问题修复。

发布包采用标准化目录结构：SKILL.md（定义文件）、README.md（使用文档）、LICENSE（许可证）、examples/（示例代码）、tests/（测试文件）。目录命名使用 kebab-case（短横线连接）。

二、实操步骤

发布流程：1) 本地测试通过；2) 更新版本号；3) 编写 CHANGELOG；4) 打包为 zip；5) 提交到 ClawHub；6) 等待审核。首次发布需要注册开发者账号并通过实名认证。

第一步准备发布包。创建目录 my-skill-v1.0.0/，包含 SKILL.md、README.md、LICENSE。README 必须包含：功能描述、安装方法、使用示例、参数说明、常见问题。

# Skill 打包和发布命令
# 1. 验证 SKILL.md 语法
openclaw skill validate ./my-skill

# 2. 本地测试
openclaw skill test ./my-skill --input '{"city":"Beijing"}'

# 3. 打包
zip -r my-skill-v1.0.0.zip my-skill-v1.0.0/

# 4. 发布到 ClawHub
openclaw skill publish ./my-skill-v1.0.0.zip --category "tools" --tags "weather,api" --description "查询全球城市天气"

三、常见问题与最佳实践

常见问题：审核被拒常见原因：README 不完整、缺少 LICENSE、代码质量低、功能重复、安全漏洞。审核周期通常 1-3 个工作日。被拒后根据反馈修改后重新提交即可。

最佳实践：版本管理建议：使用 Git 管理代码；打标签标记版本（git tag v1.0.0）；维护 CHANGELOG.md 记录变更；向后兼容时 MINOR 版本递增；破坏性变更时 MAJOR 版本递增并说明迁移指南。

四、总结

发布 Skill 到 ClawHub 是参与开源社区的重要方式。规范的版本管理和完善的文档是获得用户信任的基础。持续维护和响应用户反馈，你的 Skill 将获得更多关注和采用。