企业官网建设流程全解析

Codex 技能无响应？3 步搞定 skills 技能运行问题排查

【免费下载链接】skillsSkills Catalog for Codex项目地址: https://gitcode.com/GitHub_Trending/skills4/skills

skills4/skills（Skills Catalog for Codex）把常用任务打包成给 Codex 用的技能，装一个就能重复用。刚装完技能，一调用就没反应？别急，这篇带你把 skills 技能运行问题查清楚，顺路走一遍 Codex 技能排查思路。

技能"不对劲"长什么样？先对号入座

先回忆下你看到的现象，看看属于哪种。

装完重启后调用无反应：重启过 Codex，输入对应指令，界面上就是没有任何动静。

技能触发了，但输出和预期差很远：让它去处理评论内容，结果回你一段不沾边的文字。

技能静默跳过：流程走到一半，这一步直接被"忽略"了，下一环节照常进行。

不管卡在哪一步，下面三招都能帮你快速定位。

三招排查：从表象摸到根源

第一招｜🔍 盯安装命令的最后一行输出

说白了，技能安装失败怎么排查，第一步就是回看安装那一刻。比如你执行$skill-installer gh-address-comments，正常情况最后会蹦出一条安装成功的提示。如果这里没看到成功提示，说明技能压根没装好，后面的 Codex 技能无响应都是白排查。

第二招｜⚠️ 技能"不动"时，先确认它有没有被改过

其实道理很简单：技能很少凭空坏掉。回忆下最近几天你动过它的文件没有，不管是.system目录 里的自动安装技能，还是.experimental目录 里的实验技能，文件只要被挪过、改过，Codex 就可能直接找不到它，表现就是技能"无响应"。

第三招｜✅ 打开技能目录，对着文件逐个"过目"

打开出问题的那个技能目录，重点看两类文件：指令文件（SKILL.md）和脚本。指令文件里看路径有没有写错、要引用的资源还在不在；脚本里看是不是缺了必要的配置项。这套 skills 目录排查思路就是逐文件过目，看到哪不对，问题就在哪。

5 秒自查清单，照着勾就行

• 安装命令的最后一行输出是成功提示
• 技能目录里的指令文件和脚本都完整
• 最近没动过技能目录下的任何文件
• 装完技能后重启过 Codex

下次技能再闹脾气，按上面三招走一遍，再拿清单勾一遍，基本就能锁定问题在哪。

【免费下载链接】skillsSkills Catalog for Codex项目地址: https://gitcode.com/GitHub_Trending/skills4/skills