Hello,大家好,我是CoffeeTea。
我日常干活主力用三个工具:Claude Code、Codex、Antigravity。但是一个skill如何让它能同时在多个工具中被发现并使用呢?
说实话这个问题我纠结了挺久。装在工作区里吧,你会发现跟AI聊的时候,它经常发现不了,哪怕你的工作区写明了一些规则(比如调用这个skill),它还是偶尔会发现不了,而且skill一多你的系统规则就要变多。换个思路,装到AI工具自己的目录里,这下能发现了,但三个工具就得装三遍。你改了其中一份,另外两份还是老样子,越往后维护越费劲。
两条路,看着都能走,走一段全堵死。后来我干脆换了个玩法:真身只留一份,剩下的全用软链接指过去。
AI 为什么找不到它
这跟AI工具本身的机制有关,是每个工具只在自己规定的地方找。
Claude Code 会去看两个位置:你电脑用户目录下的 ~/.claude/skills,还有当前项目里的 .claude/skills。Codex 认的是 ~/.codex/skills。Antigravity 也是同样的路数,各家规定各家的位置。
你在自己的工作区里新建了一个目录,起名叫 skills,把 Skill 都放进去——工具根本不往那儿看。它不是不认识你的文件,是它压根没打算去那个位置找。
那既然它只认自己的目录,那我就装到它的目录里?
装进工具目录差在哪
装三遍、改三遍这个麻烦,前面已经说了,这活儿干过一次就不想干第二次。
但真正让我改主意的是另一层:这些 Skill 跟我的工作区脱钩了。
我的 Skill 本来就是工作区的一部分,它和我的规则文件、业务文档、项目笔记是长在一起的。一旦搬进工具的私有目录,等于把自己工作区的一块东西寄存在了别的地方。
工作区在同步、在备份、甚至在版本管理里,而它不在。哪天我换台电脑,工作区整个搬过去,Skill 一个都没跟过来。
那到底该放在哪
我现在是这么放的:

真身(只有这一份)└── <你的工作区>/skills/<技能名>/挂载(全是软链接)├── <你的工作区>/.claude/skills/<技能名> Claude Code 在项目里找的位置├── ~/.codex/skills/<技能名> Codex 在全局找的位置└── ~/.claude/skills/<技能名> Claude Code 在全局找的位置这些链接不用你自己敲命令去建,下面这段话直接抄走,丢给 AI 就行:
把我工作区 skills/ 下的每个技能,用软链接挂到/.claude/skills/、/.codex/skills/ 和当前工作区的 .claude/skills/ 里。真身不要移动也不要复制,工作区内部的链接用相对路径。建完帮我确认一遍有没有断链。
它会一个个建好,几秒钟的事。以后每加一个新 Skill,把这句话再丢一遍。
这段话里有两处别省。一处是"不要移动也不要复制",不然 AI 可能真会热心地帮你把文件搬过去或者复制一份,那就又回到几份副本的老路上了。另一处是"工作区内部用相对路径",这样你整个工作区改个名、挪个位置、甚至换台电脑,链接都还连着。
建完之后,改的时候只改真身那一份,三个工具同时生效,链接你就不用管了。
几个要记住的坑
工具的目录里永远只放链接,不放真身。 工具会升级、会重装、会清缓存,你要是把唯一一份 Skill 放在它的目录里,哪天它清理自身的一些内容,你的东西就跟着没了。真身放在你自己的工作区,工具那边随便折腾。
得有一份清单。 登记每个 Skill 是干什么用的、从哪来的、现在还有没有在用。听起来有点啰嗦,但没有这份清单,攒到二十来个之后你会不敢删任何一个——万一哪个流程还在调它呢?
我照着清单清过一轮,一口气退役了 7 个:有的带着 Cookie 和历史运行文件,有的里面写死了早就不存在的旧路径,还有的和现有能力重复。没清单之前,这些东西就一直在那儿占着位置。
改名和搬家会让链接全断。 你把真身目录重命名,或者挪个位置,所有指向它的链接就一起失效了,而且断得悄无声息——AI 只会跟你说找不到这个技能,不会告诉你是链接断了,你还以为是它又犯傻。所以真身的名字和位置,一开始就想好;真要动,记得把链接重建一遍。
最后说一句
工具的更替速度,比我们攒能力的速度快多了。
你花时间打磨的那些 Skill 是自己的东西,没必要跟着某个工具走。真身放在自己手上,换工具的时候重建一层链接就行。
共勉。
我是 CoffeeTea,一个在供应链行业做 B 端产品的 PM,平时用 AI 折腾工作,也折腾生活。这个号会持续分享,聊 AI 实战、聊产品经理的成长,偶尔也聊聊生活里想明白的事。
如果这篇对你有用,点个赞或在看;想第一时间看到下一篇,关注就行。
夜雨聆风