2025年Codex技能包冲突？三步排查与卸载方法

Codex技能包冲突一旦触发，AI行为便会异常紊乱——本该执行流程时跳过校验、需调用模板时擅自自由发挥、同名Skill反复加载抛出报错。复盘症结，往往不是单一Skill存在缺陷，而是多个技能在路径、命名、作用域上相互覆盖，争夺控制权。

典型表现：应检查的不检查、需调模板的却自由输出、同名Skill一加载就报错。根因不外乎路径冲突、命名重复、作用域互相覆盖——Codex无法判断该听从哪条指令。

确认技能冲突是否真实存在

如何判断是否冲突？最直接的方法：打开Codex终端，输入/debug skills命令并回车。观察输出中是否有重复的Skill名称、同一功能被多个路径同时注册、或出现"duplicate skill ID"警告行。若输出显示skills/rewrite与skills/code-rewrite均处于active状态且功能高度重叠，这就是典型冲突——Codex无法判定优先级，必然引发混乱。

三步法快速定位冲突源

定位冲突源头，三步即可完成。

第一步：进入项目根目录，执行ls -la .cursor/skills/（Mac/Linux）或dir .cursorskills（Windows），检查所有子文件夹名称。

第二步：对每个子文件夹运行cat SKILL.md | grep -E "name|id|purpose"（Mac/Linux）或用记事本打开SKILL.md，重点比对id字段是否重复、purpose是否语义重叠（例如都描述“重构函数”“优化代码结构”）。一旦发现两个技能职责相似，冲突嫌疑立即升高。

第三步：临时重命名疑似冲突的文件夹，例如将code-rewrite-v2改为code-rewrite-v2.off，然后重启Codex验证行为是否恢复正常。此操作可快速验证因果关系，避免误删核心技能——停用远比比删除安全。

两种安全方式卸载冗余技能

确定干扰技能后，清理方式有三种，按需选用：

方法一：直接删除（适用于明确无用的技能）
进入技能所在路径，执行rm -rf your-skill-name（Mac/Linux）或rmdir /s /q your-skill-name（Windows）。注意：此操作不可逆，删除前务必确认该技能未被其他项目引用，否则其他项目将一同停摆。

方法二：停用而非删除（推荐用于不确定依赖关系时）
将技能文件夹重命名为your-skill-name.disabled，Codex启动时会自动忽略以.disabled结尾的目录。后续需要时改回原名即可恢复，相当于软开关，进退灵活。

方法三：使用Apollo Toolkit统一清理（适合多环境/团队场景）
在终端执行apollo uninstall --dry-run预览将被移除的技能列表；确认无误后运行apollo uninstall code-rewrite-v2。该命令会同步清理符号链接、残留配置及关联依赖，杜绝手工遗漏。