多 AI 编程助手技能统一管理方案
多 AI 编程助手技能统一管理方案
多 AI 编程助手技能统一管理方案 多 AI 编程助手技能统一管理方案 Modified May 14 Code block Plain Text Copy 90 技能/ ├── 内容创作/ writer, ljg writes, legal briefing... ├── 视觉设计/ image, ljg card, magazine web ppt... ├── 认知工具/ ljg cognition, ljg paper, ljg word... ├── 数据采集/ ai digest, digest... ├── 开发工具/ mcp builder, skill creator, skill sync... ├── 飞书集成/ lark （25个官方技能） └── 办公文档/ docx, pdf, xlsx, pptx... 分类方式按自己的习惯来，Junction 不关心源目录的层级结构。 平台目录：全是 Junction Code block Plain Text Copy /.claude/skills/ ← Claude Code 全局 ├── writer → .../90 技能/内容创作/writer ├── image → .../90 技能/视觉设计/image ├── lark im → .../90 技能/飞书集成/lark im └── ...（每个技能一个 Junction） /.codex/skills/ ← Codex 全局 ├── writer → .../90 技能/内容创作/writer ├── image → .../90 技能/视觉设计/image └── ...（同样的 Junction） 搭建步骤 1. 创建源目录并分类 在项目中创建源目录（如 90 技能/），按自己的习惯建立分类子目录，将散落各处的技能实体文件移入对应分类。 2. 为每个平台创建链接 对每个技能，在各平台的全局技能目录下创建一个链接，指向源目录中该技能的实体位置。有几个平台就创建几个链接，但源文件始终只有一份。 📌 Windows：Junction（mklink /J） macOS / Linux：Symbolic Link（ln s） 3. 清理项目级技能 项目级技能目录不再需要——技能已经全局化。清空或删除它们。 4. 配置 .gitignore 只让 git 追踪源目录，所有包含链接的平台路径全部 gitignore。否则同一份文件会在多个路径下被 git 重复追踪。 Code block Plain Text Copy .gitignore /.claude/skills/ /.codex/ 日常操作 新增技能 1. 在源目录的对应分类下创建技能文件夹，写好 SKILL.md 2. 运行 /skill sync，自动为所有平台创建链接 3. 所有平台即时可用 修改技能 直接改源目录下的文件，所有平台即时生效，无需同步。 删除技能 1. 删除源目录下的技能文件夹 2. 运行 /skill sync，自动清理各平台的断链 安装社区技能 从技能市场或 GitHub 下载的技能，不要直接装到平台目录，而是放入源目录的对应分类，然后运行 /skill sync。 skill sync：自动同步工具 🔧 skill sync 是一个配合本方案的自动化技能，运行方式是对 AI 助手说"同步技能"、"skill sync" 或输入 /skill sync。它会自动完成以下工作： • 采集外部技能：自动发现并迁移通过 npx skills add 等方式安装到平台目录的技能，移入源目录统一管理 • 扫描与对比：遍历源目录所有分类，检查各平台链接是否齐全、是否断链 • 自动修复：补建缺失的链接、清理断链、替换错误指向 • 输出报告：显示同步结果，标注迁移、新建、跳过、异常等详情 有了 skill sync，日常的增删改操作完全不需要手动管理链接，AI 助手会自动帮你搞定一切。 Git 管理要点 💡 Symlink/Junction 对 git 的影响：git 会把链接当作普通目录，能读到底层的文件。如果 git 同时追踪源目录和链接路径，同一份文件会出现在多个路径下，造成重复。 解决方案：只让 git 追踪源目录，所有链接路径全部 gitignore。 📌 平台差异：macOS 上 git 默认不追踪 symlink 目标内容，只记录链接本身。Windows 上 git 会穿透 Junction 读取底层文件。因此 gitignore 策略对 Windows 尤其重要。 注意事项 1. 用绝对路径创建链接：最稳妥，避免相对路径导致的指向错误 2. 源目录不要轻易移动：链接绑定的是路径，移动源目录后链接会断 3. 删除链接不会删源文件：只删链接本身。但切勿对链接路径使用递归删除，否则可能误删源文件 4. Codex 全局目录下的 .system/ 不要动：这是 Codex 的内置技能 5. 可以让 AI 助手代劳：把本文档给 AI 助手看，它能自动完成所有搭建和日常操作，无需手动敲命令 验证清单 搭建完成后，逐项确认： 源目录按分类组织，每个技能有 SKILL.md /.claude/skills/ 下全是 Junction，SKILL.md 可达 /.codex/skills/ 下全是 Junction（保留 .system/），SKILL.md 可达 项目级 .claude/skills/ 和 .codex/skills/ 已清空或删除 .gitignore 忽略链接路径 git status 只显示源目录的变更 运行 /skill sync 确认所有平台同步正常 👋 所谓的"中年危机"，不过是另一场马拉松的起点。 现在的我没有包装精美的成品，只有最真实的实战记录。 每天朋友圈公开我的 AI 学习、一人公司建设、跑步进化 的所有细节。 欢迎加我微信，全方位围观。 用我踩坑的经验，帮你少走三年弯路。 👇 添加微信：qdrsw001，备注【围观】 分类方式按自己的习惯来，Junction 不关心源目录的层级结构。 平台目录：全是 Junction 搭建步骤 1. 创建源目录并分类 在项目中创建源目录（如 90 技能/），按自己的习惯建立分类子目录，将散落各处的技能实体文件移入对应分类。 2. 为每个平台创建链接 对每个技能，在各平台的全局技能目录下创建一个链接，指向源目录中该技能的实体位置。有几个平台就创建几个链接，但源文件始终只有一份。 📌 Windows：Junction（mklink /J） macOS / Linux：Symbolic Link（ln s） Windows：Junction（mklink /J） macOS / Linux：Symbolic Link（ln s） 3. 清理项目级技能 项目级技能目录不再需要——技能已经全局化。清空或删除它们。 4. 配置 .gitignore 只让 git 追踪源目录，所有包含链接的平台路径全部 gitignore。否则同一份文件会在多个路径下被 git 重复追踪。 日常操作 新增技能 1. 在源目录的对应分类下创建技能文件夹，写好 SKILL.md 2. 运行 /skill sync，自动为所有平台创建链接 3. 所有平台即时可用 修改技能 直接改源目录下的文件，所有平台即时生效，无需同步。 删除技能 1. 删除源目录下的技能文件夹 2. 运行 /skill sync，自动清理各平台的断链 安装社区技能 从技能市场或 GitHub 下载的技能，不要直接装到平台目录，而是放入源目录的对应分类，然后运行 /skill sync。 skill sync：自动同步工具 🔧 skill sync 是一个配合本方案的自动化技能，运行方式是对 AI 助手说"同步技能"、"skill sync" 或输入 /skill sync。它会自动完成以下工作： • 采集外部技能：自动发现并迁移通过 npx skills add 等方式安装到平台目录的技能，移入源目录统一管理 • 扫描与对比：遍历源目录所有分类，检查各平台链接是否齐全、是否断链 • 自动修复：补建缺失的链接、清理断链、替换错误指向 • 输出报告：显示同步结果，标注迁移、新建、跳过、异常等详情 skill sync 是一个配合本方案的自动化技能，运行方式是对 AI 助手说"同步技能"、"skill sync" 或输入 /skill sync。它会自动完成以下工作： • 采集外部技能：自动发现并迁移通过 npx skills add 等方式安装到平台目录的技能，移入源目录统一管理 • 扫描与对比：遍历源目录所有分类，检查各平台链接是否齐全、是否断链 • 自动修复：补建缺失的链接、清理断链、替换错误指向 • 输出报告：显示同步结果，标注迁移、新建、跳过、异常等详情 有了 skill sync，日常的增删改操作完全不需要手动管理链接，AI 助手会自动帮你搞定一切。 Git 管理要点 💡 Symlink/Junction 对 git 的影响：git 会把链接当作普通目录，能读到底层的文件。如果 git 同时追踪源目录和链接路径，同一份文件会出现在多个路径下，造成重复。 解决方案：只让 git 追踪源目录，所有链接路径全部 gitignore。 Symlink/Junction 对 git 的影响：git 会把链接当作普通目录，能读到底层的文件。如果 git 同时追踪源目录和链接路径，同一份文件会出现在多个路径下，造成重复。 解决方案：只让 git 追踪源目录，所有链接路径全部 gitignore。 📌 平台差异：macOS 上 git 默认不追踪 symlink 目标内容，只记录链接本身。Windows 上 git 会穿透 Junction 读取底层文件。因此 gitignore 策略对 Windows 尤其重要。 平台差异：macOS 上 git 默认不追踪 symlink 目标内容，只记录链接本身。Windows 上 git 会穿透 Junction 读取底层文件。因此 gitignore 策略对 Windows 尤其重要。 注意事项 1. 用绝对路径创建链接：最稳妥，避免相对路径导致的指向错误 2. 源目录不要轻易移动：链接绑定的是路径，移动源目录后链接会断 3. 删除链接不会删源文件：只删链接本身。但切勿对链接路径使用递归删除，否则可能误删源文件 4. Codex 全局目录下的 .system/ 不要动：这是 Codex 的内置技能 5. 可以让 AI 助手代劳：把本文档给 AI 助手看，它能自动完成所有搭建和日常操作，无需手动敲命令 验证清单 搭建完成后，逐项确认： 源目录按分类组织，每个技能有 SKILL.md /.claude/skills/ 下全是 Junction，SKILL.md 可达 /.codex/skills/ 下全是 Junction（保留 .system/），SKILL.md 可达 项目级 .claude/skills/ 和 .codex/skills/ 已清空或删除 .gitignore 忽略链接路径 git status 只显示源目录的变更 运行 /skill sync 确认所有平台同步正常 👋 所谓的"中年危机"，不过是另一场马拉松的起点。 现在的我没有包装精美的成品，只有最真实的实战记录。 每天朋友圈公开我的 AI 学习、一人公司建设、跑步进化 的所有细节。 欢迎加我微信，全方位围观。 用我踩坑的经验，帮你少走三年弯路。 👇 添加微信：qdrsw001，备注【围观】 所谓的"中年危机"，不过是另一场马拉松的起点。 现在的我没有包装精美的成品，只有最真实的实战记录。 每天朋友圈公开我的 AI 学习、一人公司建设、跑步进化 的所有细节。 欢迎加我微信，全方位围观。 用我踩坑的经验，帮你少走三年弯路。 👇 添加微信：qdrsw001，备注【围观】 💡 多个 AI 编程助手，技能怎么管不混乱？ 同时使用 Claude Code、Codex 等 AI 助手的人，一定踩过这个坑：同一份技能在不同平台改了又改，版本越改越分叉，最后自己都不知道哪个是最新的。新增一个技能要分别在 3 4 个平台目录下各创建一遍，稍有遗漏就是"这个 AI 怎么没有那个技能"。 本文分享一套「唯一源 + Symlink 农场」的轻量方案，利用操作系统原生的 Symlink / Junction 机制，让所有 AI 平台共享同一份技能实体。改一处，全平台即时生效。 多个 AI 编程助手，技能怎么管不混乱？ 同时使用 Claude Code、Codex 等 AI 助手的人，一定踩过这个坑：同一份技能在不同平台改了又改，版本越改越分叉，最后自己都不知道哪个是最新的。新增一个技能要分别在 3 4 个平台目录下各创建一遍，稍有遗漏就是"这个 AI 怎么没有那个技能"。 本文分享一套「唯一源 + Symlink 农场」的轻量方案，利用操作系统原生的 Symlink / Junction 机制，让所有 AI 平台共享同一份技能实体。改一处，全平台即时生效。 ✅ 方案优势： • 零额外依赖 — Windows Junction / macOS Symlink 均为系统原生能力 • 一改全生效 — 修改源文件，所有平台即时同步 • AI 可代劳 — 配合 skill sync 同步工具，增删改全自动 • 跨平台通用 — 适用于 Claude Code、Codex 及未来新平台 方案优势： • 零额外依赖 — Windows Junction / macOS Symlink 均为系统原生能力 • 一改全生效 — 修改源文件，所有平台即时同步 • AI 可代劳 — 配合 skill sync 同步工具，增删改全自动 • 跨平台通用 — 适用于 Claude Code、Codex 及未来新平台 痛点 当同时使用多个 AI 编程助手时，技能（Skills）往往散落在不同位置： 平台 技能路径 Claude Code 项目级 项目/.claude/skills/ Claude Code 全局级 /.claude/skills/ Codex 项目级 项目/.codex/skills/ Codex 全局级 /.codex/skills/ 平台 平台 技能路径 技能路径 Claude Code 项目级 Claude Code 项目级 项目/.claude/skills/ 项目/.claude/skills/ Claude Code 全局级 Claude Code 全局级 /.claude/skills/ /.claude/skills/ Codex 项目级 Codex 项目级 项目/.codex/skills/ 项目/.codex/skills/ Codex 全局级 Codex 全局级 /.codex/skills/ /.codex/skills/ 💡 同一份技能被复制多份，改一处忘另一处，版本逐渐分化。新增技能需要手动在多个平台重复操作。 同一份技能被复制多份，改一处忘另一处，版本逐渐分化。新增技能需要手动在多个平台重复操作。 核心思路：唯一源 + Symlink 农场 所有技能实体文件只存一份，放在一个按分类组织的源目录中。各平台的技能发现路径通过系统级链接指向这个唯一源。 Unable to load the board. Please refresh and try again.Copy ErrorRefresh Nothing on the board yet Symlink / Junction 是什么 两者都是文件系统级别的路径重定向，不是快捷方式。所有程序（终端、git、AI 工具）访问时都会透明地读到源目录的内容。 💡 关键理解：Symlink/Junction 是"透明传送门"。AI 工具访问链接路径时，操作系统自动读取目标目录的文件。你在链接路径下看到的文件，就是源目录的文件——同一份物理数据。 关键理解：Symlink/Junction 是"透明传送门"。AI 工具访问链接路径时，操作系统自动读取目标目录的文件。你在链接路径下看到的文件，就是源目录的文件——同一份物理数据。 特性 快捷方式 Junction (Win) Symlink (Mac/Linux) 创建命令 资源管理器右键 mklink /J ln s 谁能识别 仅资源管理器/Finder 所有程序 所有程序 AI 工具兼容 不兼容 完全兼容 完全兼容 需要权限 无 普通用户即可 普通用户即可 特性 特性 快捷方式 快捷方式 Junction (Win) Junction (Win) Symlink (Mac/Linux) Symlink (Mac/Linux) 创建命令 创建命令 资源管理器右键 资源管理器右键 mklink /J mklink /J ln s ln s 谁能识别 谁能识别 仅资源管理器/Finder 仅资源管理器/Finder 所有程序 所有程序 所有程序 所有程序 AI 工具兼容 AI 工具兼容 不兼容 不兼容 完全兼容 完全兼容 完全兼容 完全兼容 需要权限 需要权限 无 无 普通用户即可 普通用户即可 普通用户即可 普通用户即可 目录结构 源目录：按分类组织