一条命令,所有AI工具的skill全同步了

有一段时间，我同时在用 Claude Code、Codex 和 Trae 三个工具干活。

这三个工具各有擅长，我也给每个工具都配了一套 skill，用来约束它们怎么帮我写文章、怎么处理数据、怎么回复格式。

然后有一天，我想更新一下自己写作 skill 里的某个提示词逻辑。

我打开 Trae 改了一版，觉得还行。

过了几天，在 Claude Code 里用的时候发现效果差了一点，于是又调整了一遍。

再过两周，回头一看，Trae 里的版本和 Claude Code 里的版本已经不一样了。

哪个是最新的？不知道。哪次改动更合理？不记得了。

可能这几个月以来我已经习惯了，但这其实是一种低级但很真实的内耗。

终于在今天，我想找个工具来解决这个问题。

01你以为自己在用「同一套 skill」，其实不是

很多人用多个 AI 工具，但没意识到这个问题，skill 文件是分散存的。

Claude Code 的 skill

在 ~/.claude/skills/ 下，

而Codex 的在 ~/.codex/skills/ 下，

Trae 的又是另一个路径。每个工具各管各的，它们之间没有任何同步机制。

你在一个工具里改了 skill，另外两个毫不知情。时间一长，三套 skill 各走各的路，你自己也成了最大的版本管理混乱源。

这不是因为你懒，是因为这本来就是一个没有被设计好的问题。

02找解法这件事，我让 AI 先帮我搜了一圈

我当时是直接把需求甩给我的AI浏览器Tabbit，说我想要「一处维护，多 Agent 共享」，让它帮我找有没有现成的开源项目能解决这个问题。

它直接上网搜了一圈给了我几个方向，其中有一个项目叫 skillshare，slogan 就是「One source of truth for AI CLI skills」，而且也有2k多star，一眼就对上了我的需求。

GitHub 地址：

https://github.com/runkids/skillshare

支持 Claude Code、Codex、Trae、Kiro 等主流工具，Windows 下用 NTFS Junction（解释下就是软连接，如图红框有个快捷键头这样的形式）实现同步，不需要管理员权限。

核心逻辑是把所有 skill 放在一个统一的源目录，然后一条 skillshare sync 分发到所有 AI 工具里去。

设计思路没毛病，符合我想要的效果，我就想着先装上试试，反正如果不行的话，到时候再换其他的

03我把安装过程全记录下来了，因为每一步都值得讲

这块我要重点说，因为我安装的时候全程在跟 Claude Opus 4.8 对话，每一步的交互界面都会截图发过去问，它帮我分析该选哪个、为什么，踩的每个坑我都记下来了。

下面的内容，就是把这段陪跑经历提炼成的「照着走就能装好」版本。

第一步，安装

打开 PowerShell，粘贴这一行命令回车：

irm https://raw.githubusercontent.com/runkids/skillshare/main/install.ps1 | iex

装完关掉 PowerShell，重新开一个新窗口，输入：

skillshare --version

看到版本号就说明装好了，比如 v0.20.4。如果报错「无法识别命令」，多半是 PATH 没刷新，重启电脑再来。

第二步，初始化（这里有几个坑要说清楚）

运行：

skillshare init

init 过程是交互式的，会一路问你几个问题，很多人卡在这里不知道该选啥。我来帮你挨个过一遍。

❶ 问你要不要自定义源目录路径

Customize source path? [y/N]

直接回车，用默认路径 C:\Users\你的用户名\AppData\Roaming\skillshare\skills。

最好不要改，Win系统下这个路径权限最稳，自定义反而容易踩路径带空格或中文的坑（当然mac系统的是另一个路径，建议也直接用默认的）。

PS：末尾的 [y/N] 里大写的 N 就是默认选项，意思是只要你直接敲回车，就等同于选了大写的N（哪个大写就代表哪个是回车时的默认选项）。

❷ 问你要从哪个工具的 skill 目录作为初始内容

这里会列出它检测到的所有工具，以及各自目录里已有多少 skill，比如：

[2] Copy from warp (119 skills)[3] Copy from witsy (119 skills)[7] Start fresh (empty source)

如果你之前已经在某个工具里积累了 skill，选数量最多的那个作为起点，把现有内容接管过来。如果你想从零开始，选 7。

我当时选的 3，把 119 个 skill 都复制进来了。

❸ 选择要同步到哪些工具

界面会列出检测到的所有 AI 工具，用方向键移动，空格键勾选，a 键全选，回车确认。

直接按 a 全选，回车。理由是多选没有副作用，某个工具没装的话对应目录本来就是空的，同步过去也不影响任何东西。

⚠️ ❹ 选择同步模式，这里是最关键的一步

1) merge  - per-skill symlinks, preserves local skills2) copy   - copies files to each target3) symlink - symlinks entire directory

我建议选 1（merge），不要选 3（symlink）。

我当时选了 3，后来发现 Codex 原本系统自带的 image gen skill 没了，怎么找都找不到。后来 Claude 帮我分析才明白，symlink 是把整个目录整体替换，工具原来的本地 skill 会被干掉。

merge 模式是 per-skill 软链接，只把 skillshare 管理的 skill 叠加进去，不动工具自带的系统技能，互不干扰。

如果你像我一样当时选了 3 想改，运行这条命令切换就行：

skillshare config --mode mergeskillshare sync

或者也可以后期直接在UI界面上后台配置里改，第一个默认的合并就是merge模式：

❺ 后面几个问题

要不要初始化 Git，如果有安装Git，选 Y，给你的 skill 加一层版本保护，误删还能找回来。如果没有也不需要，就选n，问题也不大，毕竟Git还得电脑上安装配置好。

Git scope ：这里按需选择，我选择的 skills：只同步技能；如果是选 root（用方向键移过去按回车），就是一个仓库管所有配置，比只管 skills 目录扩展性好。

要不要设置 git remote，按回车选 N 跳过，本地用不需要。

最后一个问题，要不要安装内置的 skillshare skill，建议选择输入 y，装上它之后，你在 Claude Code 或 Trae 里说「帮我装一个新 skill」，AI 会直接知道怎么操作，不用你再手动查命令了。

全部走完，看到 Initialization complete 就成了。

第三步，同步

可以运行：

skillshare sync

你维护的 skill 就全部分发到所有工具里去了。以后每次改了源目录里的 skill，跑一下 sync，全部更新。

也可以运行：

skillshare ui

这样可以在本地运行服务打开后端配置界面：

04装完之后，我发现两个意外惊喜

惊喜一：你在 Claude Code 里加的系统 skill 不会丢

这个我上面说过了，merge 模式是叠加不是替换，Claude Code、Codex 各自系统自带的 skill 不受影响。只有你通过 skillshare 管理的那些才会被同步。

用下来感觉就是，每个工具的「个性」还在，只是我自己维护的那套统一了。

并且，我打开了ui后台，发现它还可以支持过滤，可以在右侧技能列处选择点击排除或是选中技能的同步，这样可定制程度就更高了，也支持用左侧的输入来过滤。

左侧这里的过滤我研究了一下，是用通配符形式去过滤的，我顺手输入几个内容测了一下，大概是这样用的：

操作很简单，分三步：

第一步，在「Skill 过滤规则」输入框里输入一条通配符匹配模式。比如你只想同步zsxq开头的skill，可以输入 zsxq*。

第二步，按回车键把这条规则添加进去。你可以重复这个动作添加多条规则（多条规则通常是"或"的关系，满足任意一条即被匹配）。

第三步，看右侧「实时预览」和底部计数确认结果。如果数字从 212/212 变成了类似 5/212，说明你的规则成功把范围缩小到了 5 个 skill。

确认无误后，点击上方的保存或 保存并返回 即可生效；不想保留改动就点取消。

总结下来大概有这4个模式，只要 skill 的名称符合你写的模式，就会被纳入同步范围：

符号	含义	示例	匹配结果
`*`	匹配任意数量的任意字符	`frontend*`	所有以 `frontend` 开头的 skill
`*`	放在中间或末尾均可	`*art`	所有以 `art` 结尾的，如 `algorithmic-art`
`?`	匹配单个任意字符	`skill?`	`skill1` 、`skillA` 等
完整名	精确匹配单个 skill	`brainstorming`	仅 `brainstorming` 这一个