Skill Sync - 自动同步 Skills 到 ClawHub & GitHub
一键同步你的所有 skills
✨ 核心功能
🔄 自动同步
- ✅ 检测新增的 skills
- ✅ 检测修改的 skills
- ✅ 自动发布到 ClawHub
- ✅ 自动提交到 GitHub
- ✅ 记录同步状态
📊 状态管理
- ✅ 跟踪每个 skill 的同步状态
- ✅ 记录 ClawHub 发布 ID
- ✅ 记录 GitHub commit hash
- ✅ 提供同步报告
🔍 智能检测
- ✅ 检测 SKILL.md 文件变化
- ✅ 检测 scripts 文件变化
- ✅ 检测 package.json 变化
- ✅ 忽略临时文件和缓存
🚀 使用方法
1. 手动触发同步
node /Users/xufan65/.openclaw/workspace/skills/skill-sync/scripts/sync.cjs
功能:
- 扫描所有 skills
- 检测需要同步的 skills
- 发布到 ClawHub
- 提交到 GitHub
- 推送同步报告
2. 自动监控模式（推荐）
创建定时任务，每小时自动检查并同步：
openclaw cron add \
--name "skill-sync" \
--cron "0 * * * *" \
--tz "Asia/Shanghai" \
--session isolated \
--wake now \
--deliver \
--message "运行 skill-sync: 检查所有 skills 的变化，自动同步到 ClawHub 和 GitHub。报告格式用中文。"
运行频率:
- 每小时检查一次（
0 * * * *） - 或每 30 分钟检查一次（
*/30 * * * *）
3. 查看同步状态
cat /Users/xufan65/.openclaw/workspace/memory/skill-sync-status.json
包含内容:
- 每个 skill 的同步状态
- ClawHub 发布 ID
- GitHub commit hash
- 最后同步时间
- 版本信息
📋 工作流程
┌─────────────────┐
│ 扫描 Skills │
│ - 检测新增 │
│ - 检测修改 │
└────────┬────────┘
│
▼
┌─────────────────┐
│ 生成同步列表 │
│ - 新 skills │
│ - 修改的 skills│
└────────┬────────┘
│
▼
有需要同步的？
│
┌────┴────┐
Yes No
│ │
▼ ▼
┌───────┐ ┌──────────┐
│同步流程│ │推送报告 │
└───┬───┘ │无需同步 │
│ └──────────┘
▼
┌─────────────────┐
│ 1. Git Commit │
│ 2. ClawHub Pub │
│ 3. Git Push │
│ 4. 更新状态 │
└────────┬────────┘
│
▼
┌─────────────────┐
│ 推送同步报告 │
│ - 成功列表 │
│ - 失败列表 │
│ - 状态更新 │
└─────────────────┘
🔧 配置选项
config/settings.json
{
"skillsDir": "/Users/xufan65/.openclaw/workspace/skills",
"statusFile": "/Users/xufan65/.openclaw/workspace/memory/skill-sync-status.json",
"gitRepo": "/Users/xufan65/.openclaw/workspace",
"clawhubConfig": {
"autoPublish": true,
"requireConfirmation": false
},
"gitConfig": {
"autoCommit": true,
"autoPush": true,
"commitMessage": "Auto-sync skills to ClawHub"
},
"ignorePatterns": [
"node_modules",
".git",
"*.log",
"*.tmp"
]
}
📊 同步状态文件
memory/skill-sync-status.json
{
"lastSync": "2026-03-12T14:30:00+08:00",
"skills": {
"deals-hunter": {
"version": "3.0.0",
"clawhubId": "k97c0kee4b0t8rmf4490m9r9bn82s082",
"clawhubPublished": "2026-03-12T10:00:00+08:00",
"gitCommit": "7779310",
"gitPushed": "2026-03-12T14:30:00+08:00",
"status": "synced"
},
"failure-monitor": {
"version": "1.0.0",
"clawhubId": "k973cr1p4k5g3mh36yjp24agg182rcsa",
"clawhubPublished": "2026-03-12T14:30:00+08:00",
"gitCommit": "22b355d",
"gitPushed": "2026-03-12T14:35:00+08:00",
"status": "synced"
}
}
}
🎯 同步条件
需要同步的情况:
-
新增 Skill
skills/目录下出现新的 skill 文件夹- 包含
SKILL.md文件
-
版本更新
SKILL.md中的version字段变化package.json中的version字段变化
-
文件修改
SKILL.md被修改scripts/目录下的文件被修改config/目录下的文件被修改
-
未同步状态
- 状态文件中没有该 skill 的记录
- 状态为
pending或failed
🔒 安全考虑
- ✅ 只同步 skills 目录：不会修改其他文件
- ✅ 保留 Git 历史：使用
git add+git commit - ✅ ClawHub 验证：发布前检查 skill 格式
- ✅ 错误处理：发布失败不会中断整个流程
- ✅ 回滚支持：可以通过 Git 回滚到之前的状态
📝 Discord 推送格式
同步成功
# ✅ Skills 同步完成
**同步时间**: 2026-03-12 14:30:00
**总计**: 3 个 skills
## 📦 成功同步
### 1. **failure-monitor** v1.0.0
- ✅ ClawHub: k973cr1p4k5g3mh36yjp24agg182rcsa
- ✅ GitHub: commit 22b355d
- 📅 发布时间: 2026-03-12 14:30:00
### 2. **deals-hunter** v3.0.0
- ✅ ClawHub: k97c0kee4b0t8rmf4490m9r9bn82s082
- ✅ GitHub: commit 7779310
- 📅 发布时间: 2026-03-12 10:00:00
---
**🔗 快速链接**:
- ClawHub: https://clawhub.com/skill/failure-monitor
- GitHub: https://github.com/sunnyhot/deals-hunter
无需同步
# ℹ️ Skills 检查完成
**检查时间**: 2026-03-12 15:00:00
**总计**: 10 个 skills
✅ 所有 skills 已是最新状态，无需同步
部分失败
# ⚠️ Skills 同步完成（部分失败）
**同步时间**: 2026-03-12 14:30:00
**成功**: 2 个 | **失败**: 1 个
## ✅ 成功同步
- failure-monitor v1.0.0
- deals-hunter v3.0.0
## ❌ 失败列表
### skill-name v1.0.0
- **错误**: ClawHub API rate limit exceeded
- **建议**: 稍后重试或手动发布
---
**建议**: 检查失败的 skills 并手动修复
📁 文件结构
skills/skill-sync/
├── SKILL.md # 技能说明
├── scripts/
│ ├── sync.cjs # 主同步脚本
│ ├── scan-skills.cjs # 扫描 skills
│ ├── publish-clawhub.cjs # 发布到 ClawHub
│ └── git-sync.cjs # Git 同步
├── config/
│ └── settings.json # 配置选项
└── package.json # 依赖管理
🔧 命令行选项
完整同步
node scripts/sync.cjs --all
同步所有需要同步的 skills
指定 Skill
node scripts/sync.cjs --skill failure-monitor
只同步指定的 skill
仅 ClawHub
node scripts/sync.cjs --clawhub-only
只发布到 ClawHub，不提交到 GitHub
仅 GitHub
node scripts/sync.cjs --git-only
只提交到 GitHub，不发布到 ClawHub
Dry Run
node scripts/sync.cjs --dry-run
只检查需要同步的 skills，不实际执行
🎯 最佳实践
1. 运行频率
- ✅ 推荐：每小时检查一次
- ✅ 可接受：每 30 分钟检查一次
- ❌ 不推荐：超过 2 小时（可能错过更新）
2. 版本管理
- ✅ 每次修改后更新
version字段 - ✅ 使用语义化版本（SemVer）
- ✅ 在 SKILL.md 中记录更新日志
3. 提交信息
- ✅ 使用清晰的 commit message
- ✅ 包含 skill 名称和版本
- ✅ 描述主要修改内容
🚨 故障排除
Q: ClawHub 发布失败怎么办？
A: 检查以下几点：
- ClawHub CLI 是否已登录（
clawhub login） - SKILL.md 格式是否正确
- 是否有网络问题
- 可以稍后重试或手动发布
Q: Git 推送失败怎么办？
A: 检查以下几点：
- Git 仓库是否正确配置
- 是否有网络问题
- 是否有冲突需要解决
- 可以手动
git push解决
Q: 如何查看详细日志？
A: 查看日志文件：
cat /Users/xufan65/.openclaw/workspace/memory/skill-sync-log.json
📝 更新日志
v1.0.0 (2026-03-12)
- ✅ 初始版本
- ✅ 支持自动检测 skills 变化
- ✅ 支持自动发布到 ClawHub
- ✅ 支持自动提交到 GitHub
- ✅ 支持同步状态跟踪
- ✅ 支持 Discord 推送通知
🤝 贡献
欢迎提交 Issue 和 Pull Request！
GitHub: https://github.com/sunnyhot/skill-sync
🎉 让你的 skills 管理更加自动化！