Codex 中可通过三种方式触发 Skill:一是设置触发词,需在 Skills 管理页或 SKILL.md 文件中配置 trigger 字段;二是用 $.skill-name 显式调用;三是通过自然语言描述+开启 Auto-trigger mode 实现隐式匹配。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你想让 Codex 在输入某个词时立刻调用特定 Skill,而不是每次手动点卡片或输完整路径——这需要精确设置触发词,否则 Codex 根本认不出你在喊它干活。
在 Skills 管理页直接设触发词
打开 Codex App → 左侧点击「插件」图标 → 找到「Skills」板块 → 在已启用的 Skill 行末尾点击「编辑」按钮。
进入编辑页后,找到「Trigger Keywords」字段(不是 Description,也不是 Name),在这里填入你打算用的词,比如 【yeet】、【debug-now】 或 【git-commit】。一个 Skill 可支持多个触发词,用英文逗号隔开,不要加空格。
填完必须点右上角「保存设置」——漏掉这步,刚输的词不会注册进系统,输入后毫无反应。
通过 SKILL.md 文件手动定义触发词
方法一:修改本地 Skill 目录下的 SKILL.md 文件
找到你的 Skill 项目目录(如 C:\Users\用户名\.codex\skills\git-commit-generator),用文本编辑器打开 SKILL.md。
在文件开头的元数据区(两行横线之间的 YAML 区域)添加一行:trigger: ["commit", "pr-msg", "git-log"]。注意格式必须是 YAML 数组写法,引号不能少,方括号不能漏。
改完保存,然后在 Codex 中新建一个对话框——旧对话框缓存不刷新,新对话才能识别你刚加的 trigger。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像,然后保存
方法二:用 $ 前缀显式调用(无需预设触发词)
只要 Skill 已启用,任何时候都能直接输入 【$.skill-name】 调用,比如 $.git-commit-generator。这个方式不依赖 Description 匹配,也不吃 trigger 字段,强制走指定 Skill。
注意:skill-name 必须和该 Skill 目录名完全一致(区分大小写,不含空格和特殊符号),否则会报错“Skill not found”。
让 Codex 自动匹配触发词(隐式调用)
第一步:确保 Skill 的 Description 写得像人话,而不是“生成提交信息”这种模糊描述。
第二步:把用户可能说的口语化表达揉进 Description,例如:“当你让我‘写个提交消息’‘整理 PR 描述’‘看看这次改了啥文件’时,请自动运行此 Skill”。Codex 会基于这段文字做语义匹配,不是关键词硬匹配。
第三步:关闭「仅限显式触发」开关——进入 Codex 设置 → Skills → 找到「Auto-trigger mode」,选「Enabled」。否则哪怕 Description 写得再准,Codex 也只会干看着不动手。
这一步没开,所有隐式匹配都失效,别怪它不聪明,是根本没给它睁眼的机会。

















