示例：

❌ 技能名称「skill-publisher」已被占用
占用者：/SASAMITTRRR/skill-publisher

💡 建议替代名称：
1. xiao-duo-skill-publisher
2. skill-publisher-cn
3. skill-auto-publisher

请选择或输入新名称：

3.2 版本自动递增

规则：

判断逻辑：

1. 1. 检测 SKILL.md 变更：

1. 2. 检测 scripts/ 变更：

1. 3. 检测 references/ 变更：

版本号来源：

• - 优先读取 _meta.json 中的 version 字段
• 如果没有，从 package.json 或默认 1.0.0 开始

3.3 Changelog 智能生成

实现方式：

1. 1. 读取 .publish_history.json 获取上次发布的文件快照
2. 对比当前文件与快照的差异
3. AI 分析变更内容，生成简洁的 changelog

文件快照格式：
json
{
xxx-skill: {
last_version: 1.0.1,
lastpublishedat: 2026-03-15T12:00:00,
files: {
SKILL.md: hash:abc123,
scripts/main.sh: hash:def456
},
changelog: 新增功能
}
}

Changelog 生成规则：

• - 新增功能：「新增 xxx 功能」
• 修复问题：「修复 xxx 问题」
• 优化改进：「优化 xxx」
• 文档更新：「更新 xxx 文档」

3.4 元数据验证

检查项：

验证脚本：scripts/validate_meta.py

四、使用示例

示例 1：发布指定技能

用户：发布 xxx-skill 技能

AI：
📋 发布摘要
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
技能名称：xxx-skill
当前版本：1.0.0
建议版本：1.0.1 (补丁)

📝 检测到变更：

• - SKILL.md: 新增触发词

📄 Changelog：
新增触发词描述

✅ 元数据验证通过

确认发布？(y/n)

示例 2：发布当前技能（模糊匹配）

用户：发布这个技能

AI：
🔍 检测到最近修改的技能：xxx-skill

📋 发布摘要
...

五、发布历史

历史文件：/root/.openclaw/workspace/skills/.publish_history.json

用途：

1. 1. 记录每次发布的版本、时间、changelog
2. 对比文件变更，智能生成 changelog
3. 避免重复发布相同版本

六、命令参考

手动发布（跳过验证）：
bash
bash {baseDir}/scripts/publish.sh --version --changelog --skip-validate

仅验证元数据：
bash
python3 {baseDir}/scripts/validate_meta.py

查看发布历史：
bash
python3 {baseDir}/scripts/show_history.py

七、注意事项

1. 1. 发布前确认：必须用户确认后才执行发布
2. 版本号唯一：不能发布已存在的版本号
3. 网络检查：发布前检查网络连接
4. 登录状态：确保 ClawHub CLI 已登录

八、故障排查