教你如何把 Codex、Claude Code 的 skills 统一管理/内附提示词

很多人用多个 AI 工具写代码，同一个 skill 要维护好几份。改了一处忘了同步另外几处，出问题时排查半天才发现是版本不一致。

现在最麻烦的不是不会写 skills，而是 skills 越用越散。

同一个 skill，在 Codex 里有一份，Claude Code 里又存了一份。刚开始只是多几个文件夹，看起来没什么。

真正烦的是后面：改了一次 skill，忘了同步到另一个工具。结果同一个任务，在 Codex 里是一个表现，在 Claude Code 里又是另一个表现，排查半天也找不出原因。

我一开始也是每个工具各建一套 skills，想着反正内容差不多。直到有一次改了一个 prompt 逻辑，只改了 Claude Code 那份，Codex 读的还是旧版，查了半小时才反应过来是版本没同步。后来才下决心只维护一份。
不同工具各读各的，skills 就会越来越分散。

这篇文章要解决的，就是怎么只维护一份 skills，再让 Codex、Claude Code 都读到同一份 skill。

01｜只维护一份 skills

这套「AI 工作说明书」不应该散落在每个工具自己的文件夹里。

推荐做法是把 skills 放进一个统一文件夹，甚至单独放进一个 Git 仓库（可以理解成专门用来保存和追踪文件版本的文件夹），然后让 Codex、Claude Code 相关入口都去读这一份。

这里要用到一个东西叫软链接。你可以把它理解成一个指向源文件夹的入口：你点进去看到的是这里，真正的内容其实还在源文件夹里。它不是复制了一份文件，所以改源文件，所有入口看到的都会自动更新。

给你看一个脱敏后的目录结构，大致长这样：

~/ai-workspace/
  shared-skills/
    article-writing/
      SKILL.md
    note-capture/
      SKILL.md

  my-project/
    .agents/
      skills -> ../../shared-skills
    .claude/
      skills -> ../../shared-skills

shared-skills 是唯一存放源文件的地方。.agents/skills 和 .claude/skills 只是指向它的入口。

你改 shared-skills 里的内容，所有工具通过各自入口读到的，自然就是最新版本。

02｜直接让 AI 帮你整理

你不用自己判断哪些目录该合并、哪些路径该软链。

把下面这段提示词直接丢给 Codex 或 Claude Code，让 AI 先帮你盘点本地结构，再给出迁移方案：

请帮我整理当前电脑上的 AI 工具 skills 管理方式。

我不是技术人员，请你用简单的话解释，不要假设我懂文件系统、软链接或命令行。

目标：
1. 找出当前项目里 .agents/skills、.claude/skills 或其他可能存放 AI 工具规则和 skills 的目录。
2. 判断这些目录里哪些是真正需要维护的源文件，哪些只是复制出来的副本。
3. 帮我设计一个统一的 shared-skills 目录，用来集中维护 skills。
4. 给出软链接或统一引用方案，让 Codex、Claude Code 尽量读取同一份说明。
5. 输出前先列出你准备执行的命令，并解释每条命令是干什么的。
6. 不要直接删除、覆盖或移动任何文件，必须等我确认。
7. 所有涉及真实用户名、私人目录、仓库名的路径，在总结里用脱敏路径表示。

请按下面格式输出：

- 你发现了哪些 skills 或规则目录
- 哪个位置更适合作为唯一源目录
- 哪些位置适合改成软链接或统一引用
- 每一步会影响什么
- 需要我确认后再执行的命令
- 如果做错了，怎么退回去

AI 会先列出它发现了什么、建议怎么做、每一步影响什么，等你确认了再动手。

如果 skills 本来就在多个 Git 仓库里，统一目录也可以只作为一个聚合入口，继续用软链接挂到各个仓库的源文件。统一目录不一定要存放所有 skills 源码。

03｜项目规则文件也一起管

skills 之外，项目规则文件也有同样的问题。

有些工具读 AGENTS.md，有些读 CLAUDE.md。它们本质上都在回答同一个问题：这个项目里，AI 应该怎么干活。

如果这些文件内容本质一样，没必要维护多份。保留一份主文件，其他的用软链接指向它就行：

AGENTS.md
CLAUDE.md -> AGENTS.md

同样，你不用自己判断哪些该合并、哪些该保留差异。把这段提示词丢给 AI：

请帮我检查当前项目里的 AI 工具规则文件。

我不是技术人员，请你先用简单的话告诉我这些文件分别可能是干什么的，再给建议。

目标：
1. 找出项目根目录下是否存在 AGENTS.md、CLAUDE.md 或其他 AI 工具规则文件。
2. 判断这些文件是否内容重复、职责重叠，或者只有少量差异。
3. 如果它们可以共用一份内容，请建议我保留哪一个作为主文件，其他文件改成软链接或引用入口。
4. 如果某个工具确实需要保留单独规则，请说明差异应该放在哪里，不要强行合并。
5. 输出建议命令，并解释每条命令的作用。
6. 不要直接覆盖、删除或改名现有文件，必须先让我确认。
7. 总结时请脱敏所有本地路径。

请按下面格式输出：

- 当前发现的规则文件
- 每个文件大概负责什么
- 是否适合合并
- 建议保留的主文件
- 建议改成软链接或引用入口的文件
- 执行前需要备份的文件
- 建议执行的命令和作用说明

项目规则只写一次，不同 AI 工具都能读到同一份规范。这样能减少「我明明改了规则，但另一个工具没生效」这种问题。

04｜什么时候适合这样做

适合：
同时使用 Codex、Claude Code 等多个 AI 工具
多个工具都需要复用同一批 skills 或项目规则
经常修改 skills，不想手动复制
想把 skills 放进独立 Git 仓库管理
多个项目需要复用同一套工作流

不适合：
某个项目需要完全独立的一套 skills
团队成员不熟悉软链接，容易误删源目录
Windows 环境里没有配置好软链接相关权限
你用的某个工具官方文档明确说不支持软链接（不确定的话，丢给 AI 帮你查）
如果你不确定自己的情况适不适合，不要自己动手删文件。把上面的提示词丢给 AI，让它先列方案，你再确认。

05｜几个小提醒

软链接指向的是路径，不是复制文件。移动源目录后，软链接会失效。
团队协作时，尽量用相对路径（如 ../../shared-skills），少用本机绝对路径（如 /Users/xxx/...）。
如果 skills 仓库单独管理，记得把真正的源仓库提交到 Git，不要只提交项目里的软链接。