Codex 插件打包前漏了什么?用目录树检查 Skill、MCP 和最小测试
插件在本机能跑、装到别处却找不到 Skill,通常不是模型问题,而是包内路径或声明不一致。发布前用目录树检查,可以先发现最便宜的错误;以下是本地文件检查,不涉及上传或安装。
先核对三份声明是否能互相指到
一个最小包可以长这样:
ops-helper/ ├── .codex-plugin/plugin.json ├── .mcp.json └── skills/incident-summary/SKILL.md检查plugin.json中的skills路径是否从插件根目录开始,SKILL.md是否实际存在,.mcp.json中服务器名称是否和文档提到的一致。预期是每个声明都落在包内真实文件,且没有..逃出根目录。
再跑一条不会写入的验收任务
安装前的试题应足够小,例如“读取本地示例日志,给出三行摘要”。它验证 Skill 能被发现、指令能解释工具调用顺序,却不会创建远程资源。若试题直接触发写操作,先修订 Skill 的前置条件和工具权限;不要把危险动作当作“连通性测试”。
三种常见失败的定位顺序
找不到 Skill,先查插件根和ski