codex skill 是将重复流程固化为可加载、可触发、可复用的标准作业说明书；它无需微调模型或训练数据，仅需 skill.md 等纯文本文件，存放于 ~/.codex/skills/ 下，通过三步验证即可生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让 Codex 不再每次都要重复解释“先看 diff、再写标题、分条写正文、别漏风险提示”，而是像一位熟手同事那样自动按你定好的规矩干活——这正是 Codex Skill 要解决的刚性需求，它把反复交代的流程固化成可加载、可触发、可复用的标准作业说明书。
理解 Skill 的本质定位
Skill 不是模型微调，也不需要 GPU 或训练数据。它是一份纯文本工作手册，由 Codex 在任务触发时按需读取并执行其中定义的流程。
SKILL.md 是唯一必需文件，其他如 scripts/、references/、assets/ 都按需添加。
所有 Skill 必须放在 ~/.codex/skills/ 目录下，Codex 启动时只扫描该路径下的子目录元数据，不会预加载全部内容。
创建一个最简可用的 Skill
第一步：在终端中进入技能根目录
mkdir -p ~/.codex/skills/my-first-skill
第二步：新建核心说明文件
cd ~/.codex/skills/my-first-skill && touch SKILL.md
第三步：用任意编辑器打开 SKILL.md，填入以下最小必要结构（必须包含 name 和 description）：
```markdown
name: 提交信息助手
description: 根据 git diff 自动生成符合团队规范的 commit message
## 执行步骤
1. 运行 `git diff --cached` 获取待提交变更
2. 提取修改的文件路径与关键改动行
3. 按“标题≤50字+空行+分条正文”格式组织输出
4. 若检测到 database/ 或 config/ 目录变更，末尾追加⚠️风险提示
```
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
这一步写完后，Codex 就能识别该 Skill 并在语义匹配时列出它。不写 name 或 description 会导致技能无法被发现。
为 Skill 添加可执行脚本
方法一：直接调用 shell 命令（适合轻量逻辑）
在 scripts/ 目录下新建 helper.sh，赋予可执行权限：
chmod +x ~/.codex/skills/my-first-skill/scripts/helper.sh
方法二：用 Python 写结构化处理（推荐用于含判断、解析、模板渲染的场景）
在 scripts/ 下新建 generate_commit.py，首行必须为 `#!/usr/bin/env python3`，且确保系统已安装 python3。
【注意】脚本路径必须相对于 Skill 根目录，Codex 不会自动补全或猜测路径。若写成 `./scripts/helper.sh` 却忘了创建 scripts/ 目录，执行将直接报错退出。
让 Skill 真正生效的三步验证
① 重启 Codex CLI 或刷新当前会话上下文，确保重新扫描 skills 目录
② 输入 `/skills list` 查看是否出现 “my-first-skill” 条目及其 description 描述
③ 输入 `/skill my-first-skill` 显式触发，观察模型是否开始按 SKILL.md 中的“执行步骤”逐条推理并调用工具
