Codex 新增 Skill 后别急着全仓启用:先做一次最小触发演练
新建一个 Skill 后直接在全仓让它接管任务,最难排查的不是“它没触发”,而是触发条件、发现目录和任务本身同时变了。先在空白目录做一次最小演练,能把路由问题与业务问题拆开。
用一个低风险任务验证发现与触发
建立skills/release-note/SKILL.md,并写明它只处理“用户明确要求整理版本说明”的场景。然后在测试目录运行一次只读请求,例如:
任务:整理 CHANGELOG.md 的本周条目,不修改文件。 预期:说明是否命中 release-note;若命中,列出会读取的文件。接着改变任务动词为“检查仓库状态”。预期此时 Skill 不应触发;若两次都触发,优先缩窄描述里的任务条件,而不是在正文里追加一大段例外。
两个常见误判
Skill 被发现不代表其脚本已执行;反过来,没触发也可能是目录没有被加载。先记录测试路径、输入和实际响应,再去检查运行环境的 Skills 配置。OpenAI 的官方 Skills 文档将 Skill 描述为包含SKILL.md与支持文件的目录,并区分发现与执行;本文的演练是文档级操作示例,未在读者仓库执行。
想把一次冒烟演练升级为团队共享的触发合同,可关注「Codex 全速入门【持续更新中】【限时优惠】」。
事实核验日期:2026-10-24;一手来源:https://developers.openai.com/api/docs/guides/tools-skills