skillshare 同步模式详解merge、copy、symlink 三种方案怎么选【免费下载链接】skillshare Sync skills across all AI CLI tools with one command and simplify team sharing. Supporting Codex, Claude Code, OpenClaw more项目地址: https://gitcode.com/gh_mirrors/skill/skillshareskillshare 同步模式是新手最该先搞懂的概念它决定了你的技能skills以什么方式分发到 Claude Code、Codex、Cursor 等 AI CLI 工具目录中。skillshare 提供merge、copy、symlink三种同步模式一条命令即可跨工具共享技能选对模式能直接决定日常使用的省心程度。本文用一张对比表 3 个典型场景帮你快速做出选择。一分钟看懂三种 skillshare 同步模式对比维度 merge默认 copy symlink工作方式每个技能单独建符号链接每个技能复制为真实文件整个目录一个符号链接保留目标目录里的本地技能✅✅❌源目录修改后的生效速度即时需再次sync即时磁盘占用低高完整副本低删除安全性安全安全⚠️ 会删到源目录支持 include/exclude 过滤✅✅❌适合人群大多数用户CI、容器、Windows、兼容差的工具想要所有工具完全一致的极简派 官方建议拿不准就先从 merge 开始个别目标再单独切成 copy。详细原理可查阅website/docs/understand/sync-modes.md模式一merge 合并模式默认推荐新手merge 模式下目标目录里的每个技能是一个指向源目录的符号链接而你自己在该工具里手写的本地技能会被原样保留——互不干扰。源目录 skills/ 目标 ~/.claude/skills/ ├── my-skill/ ──────► ├── my-skill/ → 符号链接 ├── another/ ──────► ├── another/ → 符号链接 └── local-only/ 本地技能不受影响为什么它最适合大多数人️ 非破坏性skillshare 只管理自己创建的链接删技能不会误伤本地文件️ 精细控制支持按目标include/exclude过滤Claude 要全部技能、Cursor 只要子集各取所需⚡ 改一处、处处生效编辑源目录后立即反映到所有目标 自动孤儿清理卸载技能后sync会自动移除失效链接典型场景你在 Claude Code 里有几个只给自己用的本地技能同时希望共享技能库分发给其他工具。模式二copy 复制模式兼容性最强copy 模式把每个技能复制为真实文件并写入.skillshare-manifest.json记录清单和 SHA-256 校验和。每次sync时对比校验和没变的跳过快变了才覆盖。什么时候必须切到 copy 你的 AI CLI 读不到符号链接报 skill not found️ Windows 上符号链接行为依赖系统权限不可靠 CI 流水线、容器、隔离环境不跟随符号链接 想把技能vendor进项目仓库让队友不用装 skillshare 也能用常见首选 copy 的目标cursor、antigravity、copilot、opencode。本地技能同样会被保留行为和 merge 对齐。模式三symlink 整体链接模式最激进symlink 模式把整个目标目录替换为一个指向源目录的符号链接——目标即源处处完全一致管理最省事也没有孤儿链接问题。但有两个硬约束❌ 目标目录不能存在本地技能整个目录就是源⚠️通过目标目录删除文件 删除源文件想安全断开请用skillshare target remove claude而不是rm适合skillshare 就是该工具唯一的技能来源、全新环境、追求零歧义的团队统一配置。三种 skillshare 同步模式怎么选3 个决策问题按顺序问自己三个问题答案指向你的模式目标目录里要保留本地手写的技能吗要 → merge 或 copy不要 → 可考虑 symlink你的工具/系统可靠地支持符号链接吗不确定或已出现读取失败 → copy支持良好 → merge要不要按工具过滤技能子集要 → merge/copysymlink 忽略过滤规则一键切换同步模式target 命令 配置文件模式可以全局设置也可以按目标覆盖——这正是 skillshare 的精髓一个默认模式 少量例外。方式一CLI 即时切换skillshare target cursor --mode copy # Cursor 改用真实文件 skillshare target claude --mode merge # 切回 merge skillshare sync # 应用变更方式二配置文件推荐可版本化mode: merge # 全局默认 targets: claude: path: ~/.claude/skills # 继承 merge cursor: path: ~/.cursor/skills mode: copy # 单独覆盖 codex: path: ~/.codex/skills mode: symlink # 再覆盖切换模式后务必执行一次skillshare sync不确定会动什么时先加--dry-run预览。切换细节见 website/docs/reference/commands/target.md 与 website/docs/reference/commands/sync.md。常见疑问速答Q换模式会丢数据吗不会。切换前会自动备份目标目录target remove也会先把链接还原为真实文件再移除。Qcopy 模式每次 sync 会不会很慢不会。校验和相同的技能直接跳过只有变更项才重新复制。Qmerge 模式在 Windows 上能用吗能。技能是目录junctionWindows 无需开发者模式仅单文件agents/extras链接在无开发者模式时会自动退化为复制。详见 website/docs/troubleshooting/windows.md。Qagents 和 extras 也遵循这三种模式吗是的三种模式对 skills、agents、extras 行为一致同样支持按目标 include/exclude。小结你的情况推荐模式新手 / 日常主力 merge工具不认符号链接、CI、Windows copy所有工具要完全一致、无本地技能 symlink一句话记住merge 是默认最优解copy 救兼容symlink 求极简。深入原理可继续阅读 website/docs/understand/philosophy/sync-modes-explained.md 和 website/docs/reference/targets/configuration.md。【免费下载链接】skillshare Sync skills across all AI CLI tools with one command and simplify team sharing. Supporting Codex, Claude Code, OpenClaw more项目地址: https://gitcode.com/gh_mirrors/skill/skillshare创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考