别再复制 Skills 文件夹了,我做了一个叫 Kitestring 的小工具


我最近做了一个开源小工具,叫 Kitestring。

它解决的问题很小:当我同时使用 Claude Code、Codex、Copilot CLI、Gemini CLI 时,不想再把同一份 Skill 复制到多个目录里。

每个工具都有自己读取 Skill 的路径。为了让同一套工作流在不同工具中都能使用,最直觉的办法就是复制文件夹。Claude Code 需要一份,Codex 需要一份,Copilot CLI 需要一份,Gemini CLI 可能也需要一份。

但只要你真的开始持续使用和修改 Skill,复制文件夹很快就会失控。

Kitestring 做的事情很简单:保留一份真实的 Skill 源文件,然后用 symlink 把它分发到不同 AI 工具会读取的目录里。

就像放风筝。Skill 可以出现在不同工具的目录中,但线还在你手里,真正需要维护的文件始终只有一份。

为什么我需要这个工具

前段时间,我写过一篇介绍如何用 Claude Marketplace 管理 skills 的文章。

当时的出发点很明确:电脑里的 Skill 越来越多,我希望借助 Anthropic 官方提供的能力,把它们统一管理起来。这个初衷现在依然成立,但继续用了一段时间后,我发现 Claude Marketplace 只能解决 Claude Code 生态里的 Skill 管理问题。

我的日常使用场景已经超过 Claude Code。我会用 Codex、Copilot CLI、Gemini CLI,也会尝试其他 Agent 工具。它们各自有自己的目录约定,并不会主动读取 Claude Code 存放 Skill 的路径。

同时我自己也针对工作或创作场景,写了不少 skill,比如 article2ticktick、mp-article-writor、logging-session。

这些 skill 一开始都是为了解决我自己的真实工作流问题,不是为了上架某个市场而写的。它们里面可能包含我自己的路径约定、工作流习惯,甚至一些不适合公开的个人信息。为了管理它们而创建开源项目来上架 Claude Marketplace,对我来说并不合适。

还有一些开源项目也没有主动适配 Claude Marketplace,比如我下载过的 khazix-skills、magazine-web-ppt。我当然可以提交 Issue 甚至提交 PR 来帮助项目适配 Claude Marketplace,但最终是否接入,并不取决于我。

我希望自己能决定 Skill 放在哪里,也希望多个 AI 工具都能读取同一份 Skill。

直接复制不行吗?

直接复制一份,是最简单的解决办法。

Copilot CLI 从 ~/.copilot/skills/ 路径读取 skill,我就复制一份到那里。Codex 读 ~/.codex/skills/,我就再复制一份。

但随之而来的问题是数据不同步。

比如我在使用 mp-article-writor 时,经常会根据真实写作过程调整规则。今天发现文章开头容易虚,就加一条禁止教科书开头。明天发现标题太像产品说明书,就补一条标题风格规则。后天发现自检报告没有抓住 AI 味,又继续改审读标准。

如果我把这个 skill 复制到好几个工具目录里,那我每改一次,就要想起自己复制过哪些地方。漏掉一个目录,那个工具读到的就是旧版本。再过几周,我自己都不一定分得清哪个才是最新的。

从 Github 上下载的开源项目也是同理,作者更新后,我可以快速拉取最新的改动,但仍然需要手动一份份复制到其他工具目录中。目录越多,复制越容易漏。

还有一个更麻烦的问题:Skill 的迭代需求,最容易出现在日常使用过程中。

当我在某个项目里调用 Agent,发现某条规则不够准确时,最理想的方式是直接让当前 Agent 基于当下的上下文帮我修改 Skill。但如果 Skill 的真实存放路径和当前项目路径完全分离,我就需要先总结问题,再切换到保存 Skill 的目录里修改。

这一步看起来不大,但会明显打断工作流。我真正想要的状态是:无论在哪个工具、哪个项目中修改 Skill,最后改到的都应该是同一份源文件。

symlink 像风筝线,真实文件只有一份

更合适的方案是使用 symlink。

你可以把 symlink 近似理解成 Windows 上的「创建快捷方式」,或 macOS 上的「制作替身」。它看起来像一个文件夹,但真实内容存放在别的地方。

和普通快捷方式相比,symlink 对很多命令行工具更友好。大多数软件会直接把它当成真正的文件夹来处理。

这样一来,真实文件夹只需要保留一份,放在你真正想维护的位置。其他工具目录里放的不是复制品,而是指向源文件夹的 symlink。

我只需要修改 mp-article-writor 的源文件,Claude Code、Codex、Copilot CLI 顺着 symlink 读到的就是最新内容。

我不用再想自己复制过哪些目录,也不用担心某个工具还在使用上周的旧版本。

symlink 带来的另一个好处,是我可以把所有 Skill 统一保存在一个本地文件夹中,同时让不同工具读取同一份内容。这样既能保持文件管理清晰,也…

— 以上为试看内容(约 40%),开通会员后阅读全文 —