重复函数会导致调用错误或代码覆盖，需通过/debug skills检查命名与ID重叠，定位后可用删除、停用或Apollo工具清理。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在Codex中反复生成相似功能的Python工具函数（比如多次让AI写“遍历目录找CSV文件”），这些函数会以skill形式沉淀下来，久而久之出现命名相近、逻辑重叠、版本混乱的情况——轻则调用时选错函数，重则执行冲突导致报错或覆盖原始代码。
确认重复函数是否存在
打开Codex终端，输入 /debug skills 并回车。重点查看输出中是否出现多个名称含 find_csv、list_files_by_ext、scan_dir 的skill，或同一ID被注册两次的警告行。
若看到 skills/file_utils_v1 和 skills/file_utils_v2 同时处于 active 状态，且描述都写着“递归查找指定后缀文件”，这就是典型重复——Codex无法自动判断该用哪个。
定位重复技能的物理位置
进入项目根目录，执行：
Windows用户运行：dir .cursor\skills\
Mac/Linux用户运行：ls -la .cursor/skills/
通过本地 MCP 桥接程序将 QQ 邮箱接入 Codex，配置所需的.env凭证信息、注册 MCP 服务端，并完成收件箱读取与邮件发送的全流程测试。适用场景：用户需要将 QQ 邮箱连接至 Codex、让 Codex 读取 / 发送 QQ 邮件、安装 / 修复qq_mail MCP 服务端，或是在 Windows 系统上排查 IMAP/SMTP 配置故障时，执行以上操作。
对每个疑似重复的子文件夹，打开其内部的 SKILL.md 文件，比对三处关键信息：【name】（是否语义重复）、【id】（是否完全一致）、【purpose】（是否覆盖相同场景）。比如 id: scan_dir 和 id: find_files 虽然名字不同，但 purpose 都是“返回所有.py路径”，就应视为重复。
安全卸载冗余技能
方法一：直接删除（仅限确认无引用）
进入对应技能路径，执行：
Windows：rmdir /s /q file_utils_v1
Mac/Linux：rm -rf file_utils_v1
【此操作不可逆，删除前请确保该skill未被其他agent或自动化流程调用】
方法二：停用而非删除（推荐首选）
将文件夹重命名为 file_utils_v1.disabled。Codex启动时自动跳过所有以 .disabled 结尾的目录，后续需要时只需改回原名即可恢复。
方法三：用Apollo Toolkit批量清理
先预览：apollo uninstall --dry-run | findstr "file_utils"（Windows）或 apollo uninstall --dry-run | grep file_utils（Mac/Linux）
确认无误后执行：apollo uninstall file_utils_v1。该命令会同步清除符号链接与残留配置。
