多工具 Skills 同步

问题

在多个 AI 编码工具中使用 skills 时，容易在 Claude Code、Codex、Cursor、Cline 等目录里重复维护同一套 skill，产生版本漂移。直接复制又可能覆盖某个工具里已经修改过的真实文件。

工作机制

skills-sync 使用符号链接建立统一视图：维护一个来源目录，其他位置通过链接引用同一份 skill。核心命令包括 config、sync --tool <tool>、pull --to <tool>、push --from <tool>、status、list 和 version。脚本只操作 sync-skills.json 中已配置的工具，遇到真实文件会跳过，已有正确链接也会跳过，链接指向错误时更新为正确来源。

边界与注意点

agents 是共享只读来源，可作为 pull 来源，但不能作为 push 或 unlink 目标。项目级同步只适用于支持项目目录的工具，并自动检测 git root。修改类操作建议先 --dry-run，再执行真实同步。