Codex 入门：插件和 Skill 怎么用

Codex 不只是一个“能帮你写代码的聊天窗口”。更准确地说，它是一个可以读项目、执行命令、修改文件、运行测试，并且根据项目规则工作的编程代理。

真正用顺手之后，你会发现 Codex 的重点不只是模型本身，而是它周围的工作流：AGENTS.md、Skill、插件、MCP、审批和沙盒。这些东西决定了 Codex 能不能稳定地按你的习惯做事。

先理解几个概念

AGENTS.md

AGENTS.md 是给 Codex 的项目说明书。你可以把项目里的长期规则写进去，比如默认用中文回答、修改代码前先读上下文、不要主动重构、构建命令是什么、哪些操作需要确认。

它适合放“这个仓库长期有效”的约定。像我这个项目里，就把回答风格、安全边界和工程规范写进了 AGENTS.md，这样每次打开项目，Codex 都知道基本规则。

Skill

Skill 是可复用的任务工作流。它通常包含一份 SKILL.md，也可以带脚本、参考资料和模板。

比如你经常让 Codex 做“公司投资分析”，就可以写一个 Skill，规定分析顺序：先看商业模式，再看行业格局，再看护城河、估值和风险。以后只要触发这个 Skill，Codex 就会按固定流程执行。

Skill 有两种触发方式：

• 明确触发：在提示词里直接写 $skill-name
• 自动触发：任务描述刚好匹配 Skill 的 description，Codex 会自己判断是否使用

插件

插件是更大的分发单元。它可以打包一个或多个 Skill，也可以包含外部应用连接、MCP 服务、资源文件和工具配置。

简单理解：

• AGENTS.md：这个项目里长期遵守什么规则
• Skill：某类任务应该怎么做
• 插件：把 Skill、工具和外部服务打包起来，方便安装和分发
• MCP：给 Codex 提供额外工具或外部系统数据

我推荐先装这些插件

Browser

做前端项目时很有用。它可以打开本地页面、截图、点击、输入、检查页面是否真的渲染正常。修改 UI 后，不要只相信代码，最好让 Codex 用浏览器看一眼。

适合场景：

• 检查本地 localhost 页面
• 验证按钮、表单、路由是否可用
• 对比桌面端和移动端布局
• 排查页面空白、样式错位、元素遮挡

GitHub

如果你经常处理 PR、Issue、CI，GitHub 插件很实用。它可以读 PR 信息、看评论、检查失败的 CI，并协助提交修复。

适合场景：

• 总结 PR
• 处理 review comment
• 修 GitHub Actions 失败
• 推送分支并创建 PR

Gmail

适合邮箱工作流，比如总结邮件、筛选待回复内容、草拟回复。它属于会接触私人数据的插件，使用前要确认授权范围和操作意图。

适合场景：

• 总结某个邮件线程
• 找今天未读的重要邮件
• 提取待办事项
• 草拟回复，但发送前应人工确认

Documents、Spreadsheets、Presentations

这三个插件适合处理办公文件。相比直接让模型“想象”一个文档，它们更偏向实际创建、编辑和校验文件。

适合场景：

• 写 .docx 文档
• 处理 .xlsx 表格
• 制作 .pptx 演示文稿
• 渲染检查版式是否正常

HyperFrames

如果你想用 HTML、CSS、动画和素材做视频，这个插件很适合。它更像一个视频创作环境，可以做字幕、转场、配音、音频响应动画和页面转视频。

适合场景：

• 生成产品宣传视频
• 把网站做成短视频
• 制作动态图文、标题卡、字幕视频

我推荐先学这些 Skill

$skill-creator

这是创建 Skill 最值得先学的入口。你不用一开始就手写复杂结构，可以让它帮你明确 Skill 的触发条件、工作流程和文件结构。

适合你已经反复做某类任务时使用。比如：

$skill-installer

如果你想安装已有的 Skill，可以用它。它适合本地扩展，不需要马上上升到插件分发。

示例：

$openai-docs

当你问 OpenAI API、模型、Codex、Responses API 或官方文档相关问题时，这个 Skill 很有用。它会优先找官方资料，而不是只靠模型记忆。

适合场景：

• 查 Codex 的官方行为
• 查 OpenAI API 参数
• 判断某个模型或接口是否过时
• 写基于官方文档的技术文章

$imagegen

如果你需要生成博客配图、头像、封面、产品视觉稿，可以用它。它适合生成位图素材，不适合替代项目里的 SVG 图标系统。

你自己的专用 Skill

最值得长期积累的，其实是你自己的 Skill。比如：

• 公司投资分析
• 代码审查清单
• 产品竞品分析
• 博客写作流程
• SEO 内容检查
• 前端页面验收流程

一旦某个任务你做了三次以上，就可以考虑把它沉淀成 Skill。

如何使用插件和 Skill

直接描述任务

很多时候你不需要指定插件，直接说目标即可：

如果 Browser 插件可用，Codex 会判断是否需要使用它。

明确指定插件

当你希望 Codex 一定使用某个插件，可以用 @ 指定：

明确指定 Skill

当你希望 Codex 按某个固定流程做事，可以用 $ 指定：

或者：

什么时候该用哪一个

如果只是当前这一次任务，用普通提示词就够了。

如果是这个项目长期遵守的规则，写进 AGENTS.md。

如果是你反复执行的一类任务，做成 Skill。

如果这个工作流需要分发给别人、绑定外部应用、打包多个 Skill，做成插件。

如果 Codex 需要访问外部系统或私有数据，比如 GitHub、Gmail、Drive、Slack，就用插件或 MCP，并且注意授权和审批。

一个实用的开始方式

我建议先从三个动作开始：

1. 给常用项目写好 AGENTS.md
2. 学会用 @browser 和 @github
3. 把重复任务用 $skill-creator 做成自己的 Skill

Codex 真正强的地方，不是一次性帮你生成多少代码，而是它可以逐渐变成符合你工作习惯的代理。规则越清楚，工具越匹配，输出就越稳定。

参考资料：

• Codex Plugins
• Codex Agent Skills
• Custom instructions with AGENTS.md