这篇把“本地可用”升级为“可分发、可安装、可维护”。你会得到完整发布路径：发布前检查、仓库整理、ClawHub 分发、版本维护。
本章完成标准
你完成后应该能把一个本地 Skill 变成别人也能稳定安装和使用的可分发资产。
先明确 3 类发布目标
- 本地自用：只在你机器上运行。
- 团队共享：私有仓库内复用。
- 公开分发：通过 ClawHub 或公开仓库发布。
不是所有 Skill 都要立刻公开，先稳定再扩散更稳。
步骤一：发布前先过基础检查
- 命名稳定，不再使用临时名。
SKILL.md包含用途、触发条件、执行规则。- 路径全部可移植（
{baseDir}）。 - 没有任何密钥写进仓库文件。
- 本地已跑通并完成基本排障。
步骤二：整理可分发目录结构
my-skill/
+-- SKILL.md
+-- scripts/
+-- templates/
+-- examples/
+-- assets/目录不必全有，但要一眼可读、职责明确。
步骤三：补齐依赖声明与说明文档
在 metadata.openclaw 里补齐依赖信息，让他人能快速判断可用性：
requires.binsrequires.envrequires.configprimaryEnv
同时在仓库说明页补上：用途、依赖、密钥申请入口、系统限制。
步骤四：通过 ClawHub 分发与更新
ClawHub 适合做统一搜索、安装、更新和版本同步。发布前确认：
- 技能描述能让用户判断适用场景。
- 安装后若缺依赖，能给出可操作提示。
- 示例至少包含 1 组输入输出。
步骤五：建立发布后维护机制
- 版本号语义化，重大变更写迁移说明。
- 新增依赖时更新
requires与文档。 - 每次发布前跑一次最小可用回归测试。
发布不是终点，维护才是口碑来源。
可直接复制的发布前清单
[ ] SKILL.md frontmatter 合法
[ ] name / description 清楚
[ ] metadata.openclaw.requires 已补
[ ] 没有硬编码密钥
[ ] {baseDir} 路径已替换
[ ] examples 至少一组输入输出
[ ] 本地可加载、eligible、可执行
[ ] README / homepage 已写清楚5 个最容易踩的发布坑
- 把本机路径发布出去，别人安装即失败。
- 依赖说明漏写，导致“我这里能跑你那里不行”。
- 密钥误入仓库，造成安全风险。
- 技能名过泛，容易与他人技能冲突。
- 只写安装步骤，不写使用场景与边界。
私有团队共享建议
- 先私有仓库内稳定迭代。
- 统一拉取方式与版本策略。
- 结构稳定后再决定是否公开分发。
到这里，Skill 开发章节闭环
- 写第一个 Skill。
- 写规范的
SKILL.md。 - 整理目录与资源。
- 连接 Tools / API。
- 完成调试排障。
- 发布并维护。