Codex 技能不触发怎么排查:description 写法和三条兜底

Codex 技能装了,任务也发了,它就是不用。这种情况,先看那句 description。

放大镜查看条件便签示意插画

匹配看描述,不看名字

Codex 判断这次任务该不该用某个技能,靠的是 description。

名字起得再好,描述写得含糊,它也认不出来。

描述要交代两件事

一是什么情况下该触发。二是什么情况下不该触发。

很多人只写前半句。写了用于处理文档,没写不处理表格,结果一遇到表格它也想上手。

关键用例放最前面

技能装得多的时候,Codex 会把描述缩短。description 被裁掉一截,前面那部分才留着。

所以把最要紧的用例和触发词放在开头。第一句就说明白,比后面堆十句都管用。

名字撞了也会出岔子

两个技能用同一个 name,Codex 不会合并它们,两个都进选择器。

列表里看到一对长得像的技能,里面很可能有一个是你早先装的版本。装之前先扫一眼名字。

三条兜底

第一条,点名调用。在提示词里写 $skill-name,或者用 /skills 选,绕开匹配这一步。

第二条,重启。Codex 会自动检测技能变更,改完没反应就重启一次,它会重扫目录。

第三条,查目录。技能放在哪,直接决定它能不能被读到。仓库级和用户级的位置放错一层,等于白装。

写完自己测一遍

拿真实提示词去测那句描述。该触发的时候触发,不该触发的时候保持沉默,两头都要试。

只试一半,等于没测。