codex skill路径错误会导致技能不加载、无响应或报duplicate id错误，根本原因是找不到skill.yaml或读取错目录；需通过/debug skills确认实际扫描路径，再按cli或desktop场景分别修复config.toml、--skills-dir参数或appdata路径结构，并验证目录合法性和缓存清理。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Codex Skill 路径错误会导致技能完全不加载、指令无响应或报 duplicate skill ID 错误，根本原因是 Codex 找不到 skill.yaml 文件或读取了错误位置的技能目录。
确认当前生效的 Skill 路径
打开终端，进入你的项目根目录，执行 codex --debug 或直接输入 /debug skills（在 Codex 会话中），观察输出顶部的 skills directory: 行。它会明确显示 Codex 当前正在扫描哪个路径。
如果显示的是 ~/.codex/skills，但你的技能实际放在 D:\codex\skills，说明路径配置未生效；如果显示空或 none，代表 Skills 功能根本未启用。
修复路径配置（CLI 场景）
方法一：修改 config.toml 文件
找到全局配置文件位置：~/.codex/config.toml（Mac/Linux）或 %USERPROFILE%\.codex\config.toml（Windows）。用文本编辑器打开，确保包含以下内容：
[skills]enabled = truedirectory = "D:/codex/skills"（Windows 用正斜杠，路径末尾不要加斜杠）[features]skills = true
【directory 必须是绝对路径，且该路径下必须直接存在 skill 子文件夹，每个子文件夹内必须有 skill.yaml】
方法二：启动时强制指定路径（推荐临时验证）
在项目根目录下运行：codex --skills-dir ./skills。这会跳过 config.toml，直接加载当前目录下的 skills/ 子目录。如果此时 Skill 生效，说明问题出在 config.toml 的路径配置或权限上。
修复路径配置（Desktop 场景）
Codex Desktop 默认不读取 CLI 的 config.toml，它有自己的配置逻辑。
第一步：关闭 Codex Desktop 完全退出（右键托盘图标→退出，非仅关闭窗口）
第二步：手动创建标准路径结构
在 %USERPROFILE%\AppData\Roaming\Codex\skills（Windows）或 ~/Library/Application Support/Codex/skills（Mac）下，新建 skills 文件夹。把所有 Skill 文件夹（如 playwright、gh-fix-ci）直接复制进去，确保每个文件夹第一层含 skill.yaml 和 SKILL.md。
第三步：重启 Desktop 并输入 请问我现在有哪些 skills 可以使用？ 验证是否识别。
验证 Skill 目录结构是否合法
进入你配置的 skills 目录（例如 D:\codex\skills），运行：
Windows：dir /ad → 确认列出的是纯文件夹名，如 playwright、security-threat-model
Mac/Linux：ls -F | grep "/$" → 只应看到带斜杠的文件夹名
对任意一个 Skill 文件夹（如 playwright），执行：cat playwright/skill.yaml | head -n 3（Mac/Linux）或用记事本打开 playwright\skill.yaml，确认文件存在且非空，第一行是 name: 字段。
【文件夹名必须全英文小写，不能含空格、中文、下划线或短横线以外的符号；skill.yaml 必须在子目录第一层，不能套在 src/ 或 lib/ 里】
清除缓存并彻底重启
① 关闭所有 Codex 进程（包括后台服务）；
② 删除缓存：
Mac/Linux 执行：rm -rf ~/.codex/cache
Windows 执行：del /s /q "%USERPROFILE%\.codex\cache"
③ 重新从项目根目录启动：cd /your/project/root && codex；
④ 立即输入 /goal clear，再测试 Skill 指令。
