codex skill 的 skill.md 文件必须包含 yaml frontmatter（含必填 name 和 description 字段）与 markdown 正文（含明确编号执行步骤），缺一不可，否则无法加载触发。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要为 Codex 编写一个可被识别、触发并执行的 Skill 配置文件，核心就是 SKILL.md 文件，它必须包含 YAML frontmatter 和结构化执行步骤，缺一不可，否则 Codex 启动时无法加载该 Skill。
SKILL.md 文件结构规范
第一步：在技能目录下新建纯文本文件，命名为 SKILL.md（注意大小写和扩展名，不能是 .markdown 或 .txt）。
第二步：文件开头必须用三连短横线 --- 包裹 YAML frontmatter，且 name 和 description 字段不可省略，Codex 仅靠这两项做触发匹配。
第三步：frontmatter 之后空一行，接着写 Markdown 格式的正文，推荐使用 ## 执行步骤 作为主标题，下面用带编号的列表明确每一步动作。不要写“请”“建议”“可以”，直接写指令句，例如“读取用户输入的 JSON 字符串”而非“你可以读取……”。
第四步：每个步骤末尾不加句号，保持风格统一；若某步需调用外部工具（如 Bash、Read、Write），必须提前在 frontmatter 的 allowed-tools 中声明，否则运行时会卡住或报错权限拒绝。
YAML frontmatter 必填字段详解
方法一：最简可用配置（仅含 name + description）
---<br>name: json-validator<br>description: 验证用户提供的 JSON 字符串是否合法，并返回格式化后的结果。当用户说“检查这段 JSON”或“验证 JSON 格式”时触发。<br>---
方法二：带参数提示与工具限制的生产级配置
---<br>name: api-generator<br>description: 生成符合团队规范的 RESTful API 接口代码。当用户需要创建新的 API 接口时自动触发。<br>argument-hint: [模块名] [接口描述]<br>allowed-tools: Read, Write, Bash(npm*)<br>disable-model-invocation: false<br>---
【allowed-tools 必须精确到工具名及通配符】 比如 Bash(npm*) 表示允许所有以 npm 开头的命令（npm init、npm install），但 Bash(python*) 不在此列，不会被放行。
执行步骤书写要点
第一步：用二级标题明确任务目标，例如 ## 任务目标，一句话说明本 Skill 要达成什么效果，不展开、不解释。
第二步：执行步骤从 ## 执行步骤 开始，每条步骤前加数字序号 + 英文句点 + 空格，例如 1. 提取用户输入中的 URL 字段。
第三步：关键操作必须写明输入源和输出目标。比如“从剪贴板读取内容 → 解析为 JSON 对象 → 检查 key 是否包含 id、name、email”比“解析 JSON 并校验”更可靠，后者会让 Codex 自由发挥，容易漏判。
第四步：涉及错误处理的步骤，要指定失败时的响应格式。例如“若解析失败，返回标准错误对象：{ "error": true, "message": "Invalid JSON syntax at line X" }”，不写则默认抛原始异常，前端可能崩溃。
