Codex Skills 安装与使用教程：创建、上传、调用和安全检查

官方参考：OpenAI Skills 概念 · Skills in ChatGPT · OpenAI Developers Plugin · MCP、Skills、Plugins 区别

Skill、AGENTS.md、MCP 和 Plugin 怎么区分？

官方文档明确区分：MCP 服务器负责数据、认证、授权和动作；Skill 负责如何组合工具、处理结果和输出内容。Skill 不一定需要 MCP，单纯的写作规范、代码审查或文件转换也可以做成 Skill。

Skill 的目录和 SKILL.md 怎么写？

最小可用结构如下：

my-skill/
├── SKILL.md
├── references/
│   └── style-guide.md
├── scripts/
│   └── check.sh
└── assets/
    └── report-template.md

SKILL.md 至少要有清楚的名称、触发描述和正文指令。描述应回答两件事：“这个 Skill 做什么”和“什么情况下应该考虑使用它”。详细步骤、输出格式和失败处理写在正文里，不要把所有背景资料塞到描述中。

---
name: seo-review
description: 审核网页的 SEO、结构化数据和内链；当用户要求发布前检查页面时使用。
---

# SEO Review

1. 读取页面源代码和 canonical。
2. 检查 title、description、H1/H2、JSON-LD 和内部链接。
3. 把失败项按严重程度列出，并给出可执行修复。
4. 没有实际验证时，不要声称检查通过。

怎么安装或让 Codex 使用 Skill？

入口会随产品和账号变化，先确认当前 Codex 版本是否支持 Skills。对已经打包在插件中的 Skill，通常先安装对应 Plugin；对工作区分享或上传的 Skill，则在支持该功能的 Skills/Plugins 入口中安装。OpenAI 帮助中心说明，Skills 的可用性、安装和同步会因产品和界面不同而变化。

1. 使用已有 Skill：打开 Codex 的插件或 Skills 入口，查看可用、已安装或共享的 Skill。
2. 上传 Skill：选择上传入口，提交包含 SKILL.md 的目录或压缩包；上传前先检查脚本和外部连接。
3. 安装 Plugin：在 Codex 中运行 /plugins，搜索目标 Plugin，选择安装；首次使用后按官方提示开始新会话。
4. 显式调用：在请求中说明“使用某个 Skill 完成这项任务”，或使用产品提供的调用入口。

以 OpenAI Developers Plugin 为例，官方 Codex 流程是运行 codex、执行 /plugins、搜索并安装插件，然后开始新对话。这个流程是插件安装示例，不代表所有第三方 Skill 都使用相同命令。

怎么判断 Skill 真的被调用了？

不要只看模型回答“我已经使用了”。可以用一个可验证的小任务测试：

1. 选择 Skill 描述中明确覆盖的输入，例如一份固定格式的 Markdown 文件。
2. 要求输出 Skill 规定的字段、检查结果或文件结构。
3. 查看会话是否显示 Skill/Plugin 被调用，以及脚本是否产生了预期文件。
4. 用一个不符合触发条件的请求测试，确认它不会无关触发。

官方 Skills 文档说明，模型首先看到名称和描述，匹配用户目标后才加载完整指令；所以描述写得太宽泛，可能导致误触发，写得太窄又可能完全不触发。

上传第三方 Skill 前的安全检查

官方帮助中心提醒：上传的 Skill 可能包含指令、支持文件和代码；平台会扫描上传内容，但扫描不能替代你对来源、权限和业务适用性的判断。任何 Skill 都不应要求你把 ChatGPT 密码、验证码、Session Cookie 或完整 API Key 写入文件。

常见故障怎么排查？

• 没有触发：检查 Skill 描述是否覆盖当前任务，先用显式调用测试，再缩小或改写触发条件。
• 输出不稳定：把输入格式、验收条件和失败处理写进 SKILL.md，重复测试真实案例。
• 工具调用失败：区分 Skill 指令错误和 MCP 认证/权限错误，不要只修改提示词。
• 上传后不可用：检查目录层级、SKILL.md front matter、工作区权限和扫描状态。
• 版本混乱：给 Skill 记录版本和变更说明，更新后用固定样例回归。

适合先做哪些 Skill？

优先选择输入稳定、验收明确、重复频率高的流程：SEO 发布检查、代码审查、周报生成、订单对账、客服话术整理和数据清洗。先做一个小 Skill，配三到五个真实样例，确认触发和输出稳定后再加入 MCP 或打包成 Plugin。

常见问题