Codex 技能避坑指南从命令反馈到目录核对3 步定位技能运行问题【免费下载链接】skillsSkills Catalog for Codex项目地址: https://gitcode.com/GitHub_Trending/skills4/skills做技能日志分析时多数人以为要先找到日志文件其实对新手更实用的思路是把命令输出 运行表现 目录结构当作三份日志来读。这篇文章带你用这套方法在 Skills Catalog for CodexCodex 技能目录为 Codex 收录可重复执行的技能包中快速完成 Codex 技能排障。装完没反应先看这 3 个命令反馈信号 以最常见的困惑开场你执行了安装命令界面没有任何报错技能却像没装过。别急着怀疑 Codex先看命令行输出里的三个信号列表是否符合预期用$skill-installer列出可装技能时输出应形如 Skills from {repo}: 1. skill-1 ...。列表为空或报路径错误多半是仓库或分支不对。是否出现 (already installed) 标记出现说明目标技能早已装过本次命令什么也不会改变——技能没变化往往不是故障。安装结束后的回执$skill-installer的成功反馈会提示技能在下一轮next turn才生效。没有任何成功提示或出现脚本异常都属于安装未完成后面一切免谈。$skill-installer gh-address-comments$skill-installer install https://github.com/openai/skills/tree/main/skills/.experimental/create-plan前者安装 skills/.curated/ 里的精选技能按名字即可后者演示从 GitHub 路径安装skills/.system/ 下的技能则随新版 Codex 自动安装无需手动执行。重启后技能仍不可用用 2 种方法验证⚠️ 依据 README 的明确说明安装后必须重启 Codex 才能拾取新技能。所以装完立刻测得出的结论都是无效的。验证分两步重启后开一个新会话确认技能已出现在可用技能列表里在 Codex 里执行ls $CODEX_HOME/skills。$skill-installer的脚本见 skills/.system/skill-installer/ 下的scripts/会把技能装进$CODEX_HOME/skills目录里没有对应文件夹就是安装实际没成功。核对 skills 目录结构分清没装上还是本身就有问题打开仓库里对应技能的目录结构是固定的SKILL.md技能描述与执行步骤、scripts/脚本、agents/、LICENSE.txt。以 skills/.curated/gh-address-comments/ 为例它的SKILL.md写明需要先gh auth login并完成认证——这类前置依赖缺失时技能表现为无响应但根因在外部工具而非安装。对照顺序仓库里目录结构完整 → 再看本地$CODEX_HOME/skills是否生成了同构目录 → 结构完整却不工作最后才考虑向技能维护者反馈。一份可复用的排查清单命令输出里找成功提示与 (already installed) 标记重启 Codex 后在新会话确认技能出现在列表中ls $CODEX_HOME/skills核实技能文件夹已生成对照仓库中技能目录的SKILL.md、scripts/确认结构完整、前置依赖如 CLI 工具可用【免费下载链接】skillsSkills Catalog for Codex项目地址: https://gitcode.com/GitHub_Trending/skills4/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考