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"
    }
  }
}

🎯 同步条件

需要同步的情况:

1. 新增 Skill

   • skills/ 目录下出现新的 skill 文件夹
   • 包含 SKILL.md 文件

2. 版本更新

   • SKILL.md 中的 version 字段变化
   • package.json 中的 version 字段变化

3. 文件修改

   • SKILL.md 被修改
   • scripts/ 目录下的文件被修改
   • config/ 目录下的文件被修改

4. 未同步状态

   • 状态文件中没有该 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: 检查以下几点：

1. ClawHub CLI 是否已登录（clawhub login）
2. SKILL.md 格式是否正确
3. 是否有网络问题
4. 可以稍后重试或手动发布

Q: Git 推送失败怎么办？

A: 检查以下几点：

1. Git 仓库是否正确配置
2. 是否有网络问题
3. 是否有冲突需要解决
4. 可以手动 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 管理更加自动化！