共用一份 skill,避免多份副本越改越不同
适用于 Claude Code、Codex 等目录有同一个 skill,或源目录移动后技能消失的情况。工具管理清点文件与引用,不会把 skill 自动翻译成每个 agent 的等价行为。
1. 修改前先检查
从侧栏扳手或 macOS ⌘K 打开工具管理,选择 Skills。筛选重复、绕路或死链并打开该项,核对 Content、References、Enabled in,不只看显示名。

| 发现 | 先确认什么 |
|---|---|
| 重复 | 内容相同,还是项目故意使用不同版本? |
| 绕路 | 最终目标存在吗,将绕过哪一个中间链接? |
| 死链 | 内容在别处,还是已经真的被删除? |
风险徽章只是提示值得检查的模式,不是安全认证。安装或运行陌生 skill 前阅读脚本与依赖。
2. 选择保留的内容
先比较副本。项目专用变体可能需要独立保留。选择 Move to main store 时逐项核对来源、目的地、移动与链接步骤,解决冲突后才确认。这会修改文件与链接,重要自定义内容应另留备份。

只启用计划使用的 agent。共用文件不代表各 agent 在相同作用域加载,或完全按同样方式执行。
3. 修复引用,不是找回被删内容
打开修复预览核对最终路径;绕路修复可直接指向正文目录。如果正文已不存在,修复可能清理死引用,但不能重新生成被删技能。不符合预期就取消。

删除不是归并:删除技能可能移除引用和副本。确认前阅读完整范围,详见技能管理总览。
4. 在目标 agent 验证
按该 agent 的加载方式刷新或重开,再检查能否发现技能。仍缺失时检查项目/全局作用域、根目录及当前系统的符号链接支持。真实加载由目标 agent 决定,这里不暗示已认证某个 CLI 版本。
找新技能见发现流程。安装可能启动外部命令、访问注册源;hooks 能执行真实脚本,都不是沙箱。分享路径与配置前看数据处理。
