skills4/skills:Codex 技能排查指南,3步定位“装了没反应“的根因

发布时间:2026/9/5 16:41:51
skills4/skills:Codex 技能排查指南,3步定位“装了没反应“的根因 skills4/skillsCodex 技能排查指南3步定位装了没反应的根因【免费下载链接】skillsSkills Catalog for Codex项目地址: https://gitcode.com/GitHub_Trending/skills4/skillsskills4/skills 是 Codex 的技能目录把可重复使用的任务打包成技能装进 Codex 后就能按需调用。本文教你做 Codex 技能日志分析不翻日志只靠命令回显、SKILL.md 和脚本源码3 步查清装不上、没响应的根因。装完技能重启 Codex开口却让 AI 半天不动这个场景几乎每个新手都会撞见照着 README.md 装好 gh-address-comments重启 CodexOpenAI 出的 AI 编程助手后照着文档开口界面却像没听懂。先别怀疑人生——这个项目本身不提供日志文件线索散落在命令回显和技能目录的文件里。下面的排查链路就是教你去哪找它们。盯安装回显成功的只有一种长相先看结论用$skill-installer装技能时成功必在末尾打印Installed 技能名 to 安装路径失败则是一行Error:开头的话。回显里没有这两种字样说明根本没跑完。卡住无输出脚本要联网拉取技能仓库网络不通就会一直挂着Destination already exists安装目录~/.codex/skills下已有同名文件夹换个技能名或换台干净环境重装Skills path not found技能名拼错了去 skills/ 目录核对真实名称装上了却不被调用先查 SKILL.md技能就是一个文件夹SKILL.md是它的说明书。文件开头的description字段是 Codex 判断该不该用这个技能的依据。你的说法和它描述得太远技能就静默不响应——这不是 bug是匹配没命中。拿 gh-address-comments 举例描述写的是处理当前分支 PR 的评论。你说帮我总结一下 PR它大概率不接话。这类技能还常带前置条件比如要求gh命令已登录没登录时它会先提示你跑gh auth login。跑到一半卡住去 scripts/ 里找答案每个技能自带脚本放在scripts/目录例如 gh-address-comments 用 fetch_comments.py 拉取 PR 评论。卡住时常见两种原因依赖没装脚本要 Python 或 gh CLI缺了会直接抛报错网络超时脚本要请求远端接口慢网环境会停在第一步把对应脚本从头读一遍报错从哪一行抛出问题基本就在哪。对号入座排查速查清单现象先看什么去哪找安装命令无回显网络与Error:行install-skill-from-github.py提示目录已存在~/.codex/skills里的同名文件夹换技能名重装装完不被调用SKILL.md 的description对照你的说法调整措辞跑一半停住scripts/里的脚本源码看报错抛出的位置提示找不到技能是否重启了 Codex重启后再试接下来可以做的三件事克隆仓库git clone https://gitcode.com/GitHub_Trending/skills4/skills对着目录结构逐一核对技能文件是否完整手动跑一遍技能自带脚本确认依赖和网络都通参考 skills/.system 内置技能的目录写法理解一个正常技能的完整结构【免费下载链接】skillsSkills Catalog for Codex项目地址: https://gitcode.com/GitHub_Trending/skills4/skills创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考