| name | skills-backup |
| description | Use when the user asks to backup or sync their skills. This skill automatically detects the OS (Windows/Mac) and syncs the entire skills directory to the configured Git repository, handling cross-platform conflicts like line endings and paths. |
Skills Backup & Sync (Cross-Platform)
这个 Skill 用于在 Windows 和 macOS 之间自动同步 OpenCode Skills。
它解决了跨平台路径问题（/Users/... vs C:\Users\...）和换行符冲突。
功能
- 自动识别系统：在 Windows 和 Mac 上都能直接运行。
- 智能同步：先拉取（Pull）远程更新，再推送（Push）本地修改，最大程度避免冲突。
- 冲突预防：自动创建
.gitattributes 处理换行符（CRLF/LF）问题。
- 特定同步：支持只同步指定的 Skill。
前置要求
- 确保
skills 目录是一个 Git 仓库：
cd ~/.config/opencode/skills
git init
git remote add origin <你的GitHub仓库地址>
- 确保已安装 Python 3。
使用方法
在 OpenCode 中直接告诉 AI：
- "备份 skills" (同步所有)
- "同步 skills" (同步所有)
- "备份 xlsx 技能" (仅同步 xlsx)
- "同步 writing-plans 和 theme-factory" (同步指定的两个技能)
自动备份 (Auto Backup)
你可以设置每小时自动备份，确保技能永不丢失。
安装方法：
在 OpenCode 中运行：
python3 /Users/wsxwj/.config/opencode/skills/skills-backup/setup_auto_backup.py
或者让 AI 帮你运行："设置自动备份"。
自动备份特性：
- 频率：每小时运行一次。
- 日志：记录在
skills-backup/logs/history.md。
- 静默：后台运行，不打扰工作。
运行原理
该 Skill 会执行 scripts/sync_skills.py 脚本：
- 检测当前操作系统。
- 检查 Git 状态。
- 执行
git stash (保存未提交修改)。
- 执行
git pull --rebase (拉取最新代码)。
- 执行
git stash pop (恢复本地修改)。
- 根据指令执行
git add . (全部) 或 git add <skill_name> (特定)。
- 执行
git commit (提交信息包含系统名称)。
- 执行
git push。
