Codex技能包冲突问题一旦发生，AI逻辑会变得相当异常——本该按流程执行时却跳过检查，应当调用模板时却输出自由内容，甚至同名Skill反复加载并报错。归根结底，问题根源往往不是某个Skill本身有缺陷，而是多个技能在路径、命名、作用域上互相覆盖，导致控制权被抢占，这是最常见的Codex技能冲突原因。

具体表现为：该检查的环节不检查，该调模板的却自由发挥，同名Skill一加载就报错。冲突根源基本跑不出路径、命名、作用域这几类——要么路径撞上了，要么名字重复了，要么作用域互相覆盖，Codex根本分不清该听谁的指令。

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

如何判断是否存在冲突？最简单的办法——打开Codex终端，输入/debug skills命令并回车。观察输出中是否有重复的Skill名称、同一功能被多个路径同时注册，或者出现"duplicate skill ID"警告行。如果输出显示skills/rewrite和skills/code-rewrite都处于active状态，且功能高度重叠，那就是典型冲突——Codex无法判断该优先执行哪一个，自然会出现AI行为紊乱。

快速定位冲突源的三步排查法

找到冲突源头，三步就能搞定，这是高效的技能冲突排查流程。

第一步：进入项目根目录，运行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结尾的目录。后续需要时只需改回原名即可恢复，相当于一个软开关，进退自如，是处理Codex技能冲突的灵活方案。

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