多Agent环境下Skill管理难题，三份副本与单源真相之争

随着 AI Agent 在开发场景中的普及，skill 管理正成为多 Agent 环境下的重要课题。近期，一台同时运行 Claude Code 和 Codex 的开发机暴露了 skill 管理的四大核心问题，这些问题不仅影响开发效率，更可能导致模型行为不一致。

技能副本漂移：三个目录的三份内容

在该开发机上，技能文件被分别存储于 ~/.claude/skills、~/.codex/skills 和 ~/.agents/skills 三个目录中。尽管这些目录存放着同名技能（如 my-skill），但实际内容却存在显著差异。例如，一个名为 my-skill 的技能在不同目录中的修改时间分别为 10-06、08-05 和未更新状态，且两处内容相差多达 58 行代码。这种多副本现象源于各 Agent 对技能版本记录方式的不同：Claude Code 使用 installed_plugins.json 记录 git commit，Codex 依赖软链接追踪本地 clone，而通用目录则采用 hash 值记录路径信息。

版本管理混乱：五个来源的版本记录差异

进一步分析发现，机器上的技能有五个独立的版本记录来源，每个来源都采用不同的记录方式：Claude Code 插件市场使用 installed_plugins.json 记录 git commit；公司内部技能市场仅记录安装时间；手动 git clone 后软链接依赖本地 git log；自行编写的技能没有版本记录；而 ~/.agents 目录则通过 .skill-lock.json 记录源仓库和目录 hash。这种分散的版本管理导致无法通过单一命令完成技能升级，甚至无法准确判断哪些技能已落后。

触发冲突与效果评估：工具覆盖盲区

除了内容一致性问题，技能之间的触发冲突和效果评估也成为管理难点。例如，两个发布类技能仍在调用已停用的接口，另一个选题类技能指向无法启动的脚本。这类问题因格式校验无法识别业务规则而难以发现。此外，21 个常驻技能约占用 3,200 个 token，当多个功能相近的技能共存时，触发词重叠可能导致不稳定的结果。

工具对比：vercel-labs/skills 与 skills-manager

针对上述问题，两款开源工具提供了部分解决方案。vercel-labs/skills 通过 symlink 实现正本统一存储，解决了副本漂移问题；skills-manager 则结合 adopt 收编机制，对 plugin 进行 check/update。然而，这两款工具均未能处理技能间的触发冲突和效果评估，这部分仍需依赖 Claude Code 自带的 /skill-doctor 和 claude plugin eval 工具。

单源真相：未来管理方向

从技术实现角度看，解决 skill 管理问题的关键在于建立"单源真相"（Single Source of Truth）。这意味着需要一个统一的管理平台，能够集中存储和同步所有技能内容，并提供版本控制、冲突检测和效果评估功能。未来的 skill 管理工具应具备以下特性：

• 自动化版本比对与冲突检测
• 统一的技能生命周期管理
• 内容质量评估与优化建议
• 跨 Agent 的实时同步机制

当前的解决方案虽然提供了部分基础能力，但距离完整的 skill 管理体系仍有较大差距。开发者需要在现有工具基础上，结合模型自带功能，构建适合自身需求的管理流程。