在 Codex 中创建 Skill 是将重复任务固化为可复用工作包,需按优先级路径存放、严格命名 SKILL.md 文件并填写 YAML 元数据,支持提示词或本地脚本执行逻辑,最后重启验证启用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在 Codex 中创建自己的 Skill,就是把反复做的某类任务流程固化成一个可复用的“工作包”,让 Codex 下次自动按你定的规则执行,不用再一句句解释步骤、规范和输出格式。
确认技能存放位置
Codex 默认从三个位置加载 Skill,优先级从高到低:项目目录下的 .codex/skills/ → 用户主目录下的 ~/.codex/skills/(Windows 是 C:\Users\用户名\.codex\skills\)→ 配置文件中 skills.directory 指定的路径。首次创建建议直接用全局路径,避免权限或路径拼写错误。
打开资源管理器,手动进入 C:\Users\你的用户名\.codex\skills。如果该路径不存在,请逐级新建:.codex → skills。注意:文件夹名必须是 【.codex】,开头带英文点号,大小写敏感,不可命名为 codex 或 Codex。
创建技能文件夹与 SKILL.md
在 .codex\skills 目录下,新建一个纯英文命名的文件夹,例如 cal_num(不能含空格、中文、特殊符号)。进入该文件夹,新建一个纯文本文件,命名为 【SKILL.md】(必须全大写、必须带 .md 后缀、不能叫 skill.md 或 Skill.md)。
用记事本或 VS Code 打开 SKILL.md,严格按以下格式书写——YAML 元数据块必须顶格、前后各空一行,且只允许 name 和 description 两个字段:
通过 Codex CLI 生成图片,支持尺寸控制和批量模式。依赖:codex (npm)。代理默认启用。用 generate.sh 生成单张,batch_generate.sh 批量生成游戏 UI 素材,gen_size.sh 指定尺寸。所有输出保存至 ~/.codex/generated_images/。
```yaml
---
name: cal_num
description: 执行基础四则运算,支持 + - * / 和括号,返回计算结果。
---
# 计算器技能
当用户输入含数字和运算符的表达式时,解析并返回精确数值结果。
```
编写技能核心逻辑
方法一:纯提示词驱动(适合简单任务)
在 SKILL.md 的 YAML 分隔线下方,用 Markdown 写清执行步骤。比如加一句:“1. 提取用户输入中的全部数字和运算符;2. 忽略所有非计算相关文字;3. 按数学优先级计算,保留小数点后两位;4. 输出纯数字,不加单位、不加说明。”
方法二:绑定本地脚本(推荐用于稳定逻辑)
在技能文件夹内新建 scripts/ 子目录,放入 main.py。内容示例:
import sys<br>print(eval(sys.argv[1]))
然后回到 SKILL.md,在正文末尾添加:
## 脚本调用<br>使用 scripts/main.py 执行计算,传入原始表达式作为唯一参数。
注意:若用 Python 脚本,Codex 必须能调用系统已安装的 Python 解释器,且脚本无依赖库。Windows 用户请确保 python 命令已加入环境变量 PATH。
验证与启用技能
第一步:重启 Codex 客户端,确保新技能被扫描加载。
第二步:在聊天框输入 /skills,回车。列表中应出现你刚创建的 cal_num 技能名称。
第三步:直接输入触发语,例如 “调用 cal_num 计算 (10+100)*2/5-30/5=?” —— Codex 会自动匹配技能并执行。
若未响应,检查 SKILL.md 文件是否保存为 UTF-8 编码,且无 BOM 头;也确认文件夹名与 name 字段完全一致(包括大小写)。

















