作者墨松你的 Skill 散落在几个地方当前 AI Coding 的发展正处在百花齐放的时代没有永远的王者。模型越来越强Cursor、Claude Code、Codex 轮番成为阶段性首选再加上额度限制、响应延迟等现实问题开发者早就习惯了“鸡蛋不放在一个篮子里”。除了编程工具各种通用 Agent 也在不断涌现每出一个新的总有人第一时间去尝鲜。如今同时使用多个 AI Agent 干活一边试用刚冒出来的新工具一边防着正在用的突然掉链子已经成为这个时代的开发新常态。然而工具可以无缝切换Skill 却无法自动跟随。在 Codex 中更新过的 SkillClaude Code 里仍是旧版Cursor 目录下还可能并存一份同名但内容迥异的副本。起初手动复制尚可忍受时间一长便陷入混乱哪份才是最新该用谁覆盖谁接入新工具时是否还要重复搬运这种碎片化的版本管理不仅降低工作效率更在反复确认中不断消耗人的心力。一份 Skill一个中心仓库其实社区早就意识到了这个问题也涌现了不少解法。有人用 Git submodule 或 Monorepo 统一管理但改个 Prompt 还要走 commit/push/pull 流程对日常 Coding 来说太重有人试过 Syncthing 这类通用文件同步工具但它只懂文件不懂 Skill 语义双向修改时极易产生覆盖灾难还有人转向 LangSmith 等 Prompt 管理平台却发现它们是为 LLM 应用开发设计的根本不管本地 Agent 配置文件的死活。开源社区也出现了一些专门针对 Agent Skill 管理的尝试有的提供了基础的分类检索与统一索引让散落的 Prompt 有了归处有的则聚焦跨项目共享试图解决同一个 Skill 在多个工程中重复维护的问题。这些探索都精准切中了痛点的某个侧面但试了一圈下来我发现它们要么解决了“存储”没解决“自动分发”要么解决了“共享”没解决“多 Agent 目录的实时同步与冲突感知”。当你的 Cursor、Claude Code、Codex 同时开着需要的是改一处就全部生效、且随时知道哪份是最新的——这个“最后一公里”的闭环依然没有现成的轮子能完整补上。既然现有方案都在“部分解决”那就自己造一个能彻底闭环的。这就是 Nacos Skill Sync 的由来。它做的事情可以用一句话概括把 Skill 收敛到一个中心仓库再按需分发给各个 Agent。具体来说只维护一份中心仓库统一存放 Skill 内容和同步状态默认用软链接让各 Agent 目录指向中心仓库——改一处全部生效。环境不支持软链接的话也可以切换到复制模式由 CLI 负责把内容同步过去同步状态随时可查远端有没有更新、本地有没有改动、是否存在冲突一眼就知道下一步该干什么它提供两种模式可以按需选择模式一句话概括适合谁Registry modeNacos AI Registry 可视化管理 跨设备共享想系统管理自己 Skill 库的人或者需要团队共建 Skill 的场景Local mode本地中心仓库 软链接/复制同步 零服务依赖只想先把本机多个 Agent 的 Skill 统一起来不想折腾部署两种模式共用一套操作习惯Local mode 适合先在本机收拢 SkillRegistry mode 则会在对应 profile 下维护独立的 Skill repo 和同步状态。这样不同 profile 的 Skill 不会互相覆盖真正切换同步来源时CLI 会先把旧的 profile 的软链接安全落回各 Agent 的本地副本。先从 Local mode 用起完全没问题后续需要跨设备共享、团队协作或版本治理时再切到 Registry mode。Registry mode远端 Registry 统一管理如果你手上有十几个 Skill 在持续迭代或者团队里几个人都在用同一套 Skill把它们散放在各自的本地目录里迟早会出问题——版本不一致、改了没人同步、新成员不知道去哪找。Registry mode 做的是把 Skill 放进 Nacos AI Registry 这个统一入口可视化控制台里浏览、搜索、查看 Skill不用再翻目录版本治理草稿、审核、发布、回滚、label——个人能追踪每个 Skill 的状态团队能把高频 Skill 沉淀成稳定版本跨设备同步家里电脑和公司电脑从同一个 Registry 拉 Skill新设备接入不用再手动整理双向流通远端的可以同步到本地本地沉淀的也能推上去不会只留在某一个人的电脑上一句话Skill 从本地配置文件变成了可追溯、可共享、可管理的 Registry 资产。Local mode把本机 Skill 收拢成一份Local mode 更轻量——无需接入 Nacos AI Registry仅在本地构建中心仓库并默认以软链接方式关联各 Agent 的 Skill 目录。其核心目标是消除多 Agent 环境下的 Skill 冗余与版本不一致问题。当同一份 Skill 在 Codex、Claude、Qoder、Cursor、Kiro、Lingma 等工具中存在多个副本时Local mode 将其收敛为单一信源确保修改一处即可全局生效。目前会自动发现 Codex、Claude、Qoder、QoderWork、Cursor、Kiro、Lingma、CoPaw、OpenClaw以及通用的~/.agents/skills和~/.skills其他目录也可以通过skill-sync agent add手动加入。已经散落在各 Agent 目录里的 Skill 也可以逐步纳入中心仓库。处理单个 Skill 时执行skill-sync add skillCLI 会检查各 Agent 目录里的同名内容并在有差异时让你选择来源如果想批量扫描已有目录确认范围后再执行skill-sync add --all。内容一致的会直接统一不一致的会停下来让你选择以哪一份为准。反过来如果某个 Skill 不想再由 Skill Sync 管理执行skill-sync remove skill想一次性取消全部同步可以用skill-sync remove --all。这个操作不会删除 Agent 里的 Skill而是先把中心仓库内容复制回各 Agent再移除同步状态。Local mode 也可以自然升级到 Registry mode。将来想升级到跨设备或团队协作不用重新整理绑定一个 profile 就能接入远端。快速上手方式一Agent 自驱动推荐我们提供了一份标准的SKILL.md其中完整描述了nacos-skill-sync的使用规范与交互流程。只需将下方指令发送给 Agent它便会自动读取该 Skill、检查本地环境并执行同步遇到模式选择或内容冲突等需人工决策的节点时会主动暂停并向你确认。阅读下面的 Skill使用它来同步我本地的 Skill https://nacos.io/skill-sync/SKILL.md方式二CLI 手动操作若希望自行控制同步流程可通过 CLI 完成。Registry mode跨设备 / 团队协作# 1. 准备 CLI二选一curl-fsSLhttps://nacos.io/nacos-installer.sh|bash-s----cli# 或者直接使用 npxnpx nacos-group/clilatest skill-sync--help# 2. 配置 CLI profilenpx nacos-group/clilatest profile edittest# 3. 添加 Skill启动同步查看状态npx nacos-group/clilatest--profiletestskill-syncaddpdf npx nacos-group/clilatest--profiletestskill-sync start npx nacos-group/clilatest--profiletestskill-sync statusLocal mode单机轻量同步无需 profilenpx nacos-group/cli skill-syncaddpdf npx nacos-group/cli skill-sync start npx nacos-group/cli skill-sync status使用案例下面两个例子分别对应 Local mode 和 Registry mode一个从个人本机开始把高频工作流先收拢起来另一个面向跨设备和团队协作把共同规范放进 Registry。案例一记录工作内容生成周报 Skill很多人每天都会在多个 Agent 里处理不同任务用 Codex 改代码用 Claude Code 查日志用 Cursor 补测试。任务做完后工作记录也跟着散在不同对话里。到周五再回头整理常常要翻聊天、补背景、合并重复事项最后写出来的周报还容易变成流水账。这个问题可以先从本机解决把每天怎么记录、周报怎么合并这些习惯沉淀成一个biweekly-work-reportSkill放在 Local mode 里给本机 Agent 共用。任务结束时记录结果和影响遇到同主题工作时合并更新生成周报时保留进展、风险和下周计划。使用 Skill Sync 将某个 Agent 创建的biweekly-work-report同步至所有的 Agent后续所有 Agent 都可以使用这个 SkillCodexClaude Code:这样做不需要先准备服务端也不用把私人工作记录同步出去。更关键的是这不是把 Skill 复制一次就结束后面在 Codex 里调整了周报字段Claude Code 和 Cursor 看到的也会是更新后的work-report。案例二文档统一格式 Skill团队文档的问题更典型。接口文档、技术方案、故障复盘可能由不同人、不同设备、不同 Agent 生成标题层级、参数表字段、风险说明和评审清单很容易各写各的。靠口头提醒不稳定复制模板又经常复制到旧版本。这类格式规范更适合放进 Registry mode。团队可以把技术方案结构、API 参数表字段顺序、术语写法、截图说明和评审检查项整理成一个doc-formatSkill。使用 Skill Sync 将 AI Registry 中的doc-format同步至所有多个设备的 Agent后续不同设备的 Agent 都可以使用这个 Skill设备 A Codex:设备 B Qoder:规范更新后只维护 Registry 里的这一份。公司电脑、家里电脑、新设备以及团队成员的 Agent 同步后都会继续使用同一套格式。日常维护看 status 就够了用起来之后日常只看一个命令的输出Mode: nacos Profile: team Sync daemon: running (pid: 12345) SKILL STATUS AGENTS NEXT pdf Synced codex,claude,qoder - review Local changes codex,claude,qoder auto-upload pending draft Uploaded codex,claude,qoder waiting publish block Upload blocked codex,claude,qoder Nacos draft exists; review/clear it, auto-upload will retry triage Conflict codex,claude,qoder skill-sync resolve triage每个 Skill 什么状态、覆盖了哪些 Agent、下一步该干什么——都在这了。状态意味着什么Synced一切正常不用管LinkedLocal mode 下已经链接到本地中心仓库Local changes本地有改动开启 auto-upload 时 daemon 会自动上传关闭时会保留在本地Uploaded已上传为草稿等待审核或发布Conflict本地和远端都改了需要你选一个版本Upload blocked远端已有草稿或审核中版本需要先在 Nacos 里处理处理后会自动重试遇到冲突也不用慌resolve命令可以选以远端 Registry、中心仓库还是某个 Agent 的版本为准。策略默认保守——不会擅自替你做选择你明确指定了来源才会执行。让 Skill 有一份可信来源多 Agent 并行会越来越常见真正需要管理的不只是用哪个 Agent而是这些 Agent 共同依赖的 Skill。更理想的方式是把 Skill 放进 Registry有统一入口有版本记录也能在多台设备和团队成员之间共享。Local mode 则提供了一个更轻的入口不需要先准备服务端也能先把本机散落的 Skill 收拢起来。无论从哪种方式开始目标都是一样的让 Skill 有一份可信来源。Agent 可以换Skill 不应该跟着散。欢迎大家使用 Nacos Skill Sync。如果在使用中发现任何问题或有更好的改进建议也欢迎随时反馈给我们。相关链接Nacos 开源地址github.com/alibaba/nacosNacos CLIhttps://github.com/nacos-group/nacos-cliNacos Skill Synchttps://nacos.io/skill-sync/SKILL.md