Codex Skills：选择并使用可复用工作流

适用场景

这篇手册适合已经会使用 Codex，但发现自己经常重复输入同一套流程的用户。比如“每次写文档都按固定检查表”“每次审查前端都要跑同一组视觉检查”“每次处理表格都要按公司模板输出”。

OpenAI 官方文档说明，Skills 是给 Codex 增加任务专长和可复用工作流的方式。一个 Skill 可以包含说明、参考资料、脚本和资源，让 Codex 在相关任务中稳定执行同一套流程。

步骤 1：先判断任务是否适合做成 Skill

不要把所有提示词都做成 Skill。适合 Skill 的任务通常有三个特征：

• 会重复出现。
• 有固定步骤或检查清单。
• 需要引用固定资料、脚本或模板。

不适合 Skill 的任务是一次性问题，例如“解释这个函数”或“帮我想一个标题”。这些直接写提示词就够了。

步骤 2：在 Codex App 中查看 Skills

截图中展示的是 Codex App 中的 Skills picker。你可以在 App 里打开 Skills，查看当前可用的工作流。

Skills 可以来自本地项目、全局配置，也可以由插件提供。打开列表时，先看 Skill 名称和描述，判断它是否和当前任务匹配。

步骤 3：在提示词中明确触发 Skill

如果你知道要用哪个 Skill，可以在提示词里明确点名：

请使用 $content-editor 检查这篇 MDX 教程。
重点看标题、SEO 描述、步骤是否清楚、截图说明是否符合规范。

明确触发的好处是减少误判。Codex 不需要猜测该不该调用某个 Skill。

步骤 4：让 Codex 自动选择 Skill

官方文档也说明，Codex 可以根据 Skill 的 description 自动判断是否使用。要让自动选择更可靠，Skill 描述必须具体。

好的 Skill 描述应该说明：

• 它解决什么任务。
• 什么时候应该使用。
• 输出应该遵守什么标准。

如果描述太泛，比如“帮助写东西”，Codex 很难判断何时该用。

步骤 5：把 Skill 和插件区分开

Skills 是工作流的作者格式；Plugins 是可安装和分发的单位。你可以先写 Skill，等它稳定后再打包进 Plugin，分享给团队或工作区成员。

简单理解：

• Skill：让 Codex 学会一套做事方法。
• Plugin：把 Skill、工具、MCP 或应用集成打包安装。

常见错误

不要把临时偏好写成 Skill。一次性要求放在当前提示词里就好。

不要让 Skill 描述过长或过泛。Codex 先看到的是名称和描述，描述越清楚，触发越准确。

不要把敏感密钥、私有客户数据写进 Skill 文件。Skill 会成为可复用上下文，应该只放稳定规则和脱敏资料。

小结

Skills 适合把重复工作流沉淀下来。先从一个常用流程开始，写清触发条件和执行步骤，再在 Codex App 或提示词中使用它。等流程稳定后，再考虑通过 Plugin 分发。