Skip to content

nicholyx/ai-skills / custom/daily/skills-sync

skills-sync

Unverified

Use when you need to synchronize commands and skills from ~/.agents/ to AI tool directories like Claude or CodeBuddy using symbolic links. 当用户说「把我的技能同步到 Claude」「同步一下我的技能」时使用。

Skills Sync

概述

将 ~/.agents/commands/ 和 ~/.agents/skills/ 通过软链接同步到各种 AI 工具目录,实现跨工具的命令和技能共享。

支持同步文件和目录:

  • Commands:同步 .md 命令文件和命令目录
  • Skills:同步 skill 目录和相关文件

核心原则

  • 软链接而非拷贝:使用符号链接避免重复维护
  • 智能跳过:已存在的有效链接不会被重新创建
  • 自动清理:删除指向不存在目标的无效软链接
  • 跨平台支持:Python 实现,支持 macOS/Linux/Windows

何时使用

digraph when_to_use {
    "需要同步 commands/skills?" [shape=diamond];
    "同步到 Claude?" [shape=diamond];
    "同步到 CodeBuddy?" [shape=diamond];
    "同步到多个工具?" [shape=diamond];

    "使用 skills-sync" [shape=box];
    "指定 --target claude" [shape=box];
    "指定 --target codebuddy" [shape=box];
    "指定 --target claude,codebuddy" [shape=box];

    "需要同步 commands/skills?" -> "同步到 Claude?" [label="是"];
    "需要同步 commands/skills?" -> "手动操作" [label="否"];

    "同步到 Claude?" -> "使用 skills-sync" [label="是"];
    "同步到 Claude?" -> "同步到 CodeBuddy?" [label="否"];

    "同步到 CodeBuddy?" -> "使用 skills-sync" [label="是"];
    "同步到 CodeBuddy?" -> "同步到多个工具?" [label="否"];

    "同步到多个工具?" -> "使用 skills-sync" [label="是"];
    "同步到多个工具?" -> "手动操作" [label="否"];

    "使用 skills-sync" -> "指定 --target claude" [label="Claude"];
    "使用 skills-sync" -> "指定 --target codebuddy" [label="CodeBuddy"];
    "使用 skills-sync" -> "指定 --target claude,codebuddy" [label="多个工具"];
}

使用场景:

  • 在 ~/.agents/ 中添加新的 command 或 skill 后,需要同步到 Claude
  • 更新 skill 后,需要确保所有工具使用最新版本
  • 多个 AI 工具需要共享同一套 commands 和 skills
  • 清理无效的软链接

不适用于:

  • 需要为不同工具维护不同版本的命令
  • 拷贝文件而非创建软链接

快速参考

目标命令
同步 commands 到 Claudeuv run --directory ~/.agents/skills/skills-sync python sync.py --target claude --type commands
同步 skills 到 Claudeuv run --directory ~/.agents/skills/skills-sync python sync.py --target claude --type skills
同步两者到 Claudeuv run --directory ~/.agents/skills/skills-sync python sync.py --target claude --type both
同步两者到 CodeBuddyuv run --directory ~/.agents/skills/skills-sync python sync.py --target codebuddy --type both
同步两者到多个工具uv run --directory ~/.agents/skills/skills-sync python sync.py --target claude,codebuddy --type both

目标路径

工具Commands 路径Skills 路径
Claude~/.claude/commands/~/.claude/skills/
CodeBuddy~/.codebuddy/commands/~/.codebuddy/skills/

实现

脚本位于:~/.agents/skills/skills-sync/sync.py

功能特性

  1. 支持文件和目录:同步 .md 命令文件和命令/技能目录
  2. 智能创建:仅创建不存在的软链接
  3. 有效性检查:验证现有软链接是否指向存在的目标
  4. 自动清理:删除指向不存在目标的无效软链接
  5. 批量同步:支持同时同步到多个工具(逗号分隔)
  6. 选择性同步:可选择仅同步 commands、skills 或两者
  7. 隐藏文件过滤:自动跳过 .DS_Store 等隐藏文件

输出符号说明

  • ✓ - 成功操作
  • ⚠ - 跳过(目标已存在且不是软链接)
  • ✗ - 错误或删除无效链接

常见错误

错误原因解决方法
源目录不存在~/.agents/commands/ 或 ~/.agents/skills/ 不存在创建相应的源目录
创建失败权限不足或目标路径冲突检查目标目录权限
目标已存在且不是软链接目标位置有同名文件/目录手动删除或重命名目标
未知的目标工具拼写错误或不支持的工具检查 --target 参数

实际应用

典型工作流:

# 1. 在 ~/.agents/ 中创建新 skill
mkdir -p ~/.agents/skills/my-skill
echo "..." > ~/.agents/skills/my-skill/SKILL.md

# 2. 同步到 Claude
uv run --directory ~/.agents/skills/skills-sync python sync.py --target claude --type skills

# 3. 同步到 CodeBuddy
uv run --directory ~/.agents/skills/skills-sync python sync.py --target codebuddy --type skills

# 或一次性同步到两者
uv run --directory ~/.agents/skills/skills-sync python sync.py --target claude,codebuddy --type skills

清理无效链接:

# 运行同步会自动清理无效链接
uv run --directory ~/.agents/skills/skills-sync python sync.py --target claude --type both
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall