详解skills和插件的区别

在 Codex 中，**Skill（技能）**和 **Plugin（插件）**都用于扩展能力，但层级不同：

Skill 是一套“做事的方法和规范”；Plugin 是一个可安装的“功能扩展包”。

一、Skill 是什么

Skill 是存放在本地目录中的一组任务说明。核心文件通常是：

my-skill/├── SKILL.md├── references/├── scripts/└── assets/

其中，SKILL.md 会描述：

- 什么情况下使用该技能

- 任务应该按什么步骤执行

- 有哪些限制和注意事项

- 应该读取哪些参考资料

- 可以调用哪些脚本或工具

- 最终交付物需要满足什么标准

例如，一个“Word 文档制作”Skill 可以规定：

1. 读取用户提供的内容2. 创建 DOCX 文件3. 设置标题、目录和页码4. 将 DOCX 渲染成图片5. 检查分页和排版6. 修复布局问题后再交付

Skill 的重点是让 Codex 按照稳定、专业、可重复的流程工作。

二、Plugin 是什么

Plugin 是一个可以安装和分发的完整扩展包，通常带有插件清单：

my-plugin/├── .codex-plugin/│ └── plugin.json├── skills/├── agents/├── commands/└── mcp/

具体目录取决于插件类型和当前版本支持的功能。

一个 Plugin 可以包含：

- 一个或多个 Skills

- MCP 服务配置

- 外部系统连接能力

- 专用 Agent

- 命令或工作流

- 插件元数据

- 安装和版本信息

- 权限或认证配置

例如，一个“项目管理插件”可能同时包含：

- “需求分析”Skill

- “生成迭代报告”Skill

- Jira MCP 服务

- 项目查询命令

- 团队统一配置

因此，Plugin 更强调 能力的打包、安装、升级和分发。

三、两者之间的关系

它们不是互斥关系，而是包含关系：

Plugin├── Skill A├── Skill B├── MCP 工具├── Agent└── 插件配置

也就是说：

- 一个 Skill 可以独立存在。

- 一个 Plugin 可以包含多个 Skills。

- Skill 负责“怎么做”。

- MCP 或其他工具负责“能操作什么”。

- Plugin 负责把这些能力组合并分发出去。

举例说明

用户提出：

根据销售数据生成 Excel，并插入柱状图。

四、只有 Skill

Excel Skill 会告诉 Codex：

- 如何清洗数据

- 如何创建工作簿

- 如何设置表格格式

- 如何插入图表

- 如何检查生成结果

但它主要提供的是工作流程和规范。

五、使用 Plugin

Excel Plugin 可能同时提供：

- Excel 数据处理 Skill

- 图表生成 Skill

- 企业数据源 MCP

- 文件上传工具

- 公司统一报表模板

- 身份认证配置

这样 Codex 不仅知道怎么生成报表，还可以直接查询企业数据并套用公司模板。

六、Skill、Plugin 和 MCP 的区别

这三个概念也容易混淆：

- Skill：告诉 Codex“应该怎么做”。

- MCP：为 Codex 提供“可以调用什么外部工具和数据”。

- Plugin：把 Skill、MCP 和其他配置“打包安装”。

例如：

“如何查询数据库并生成报告” → Skill“真正连接数据库并执行查询” → MCP“把数据库连接和报告流程一起安装” → Plugin

应该选择哪一种

以下情况适合创建 Skill：

- 固化团队编码规范

- 制定代码评审流程

- 规范 Word、Excel、PPT 的生成方式

- 保存某个业务领域的操作知识

- 不需要安装复杂外部工具

以下情况适合创建 Plugin：

- 需要同时安装多个 Skills

- 需要接入企业系统或外部服务

- 需要 MCP、Agent 和配置协同工作

- 需要版本管理和统一分发

- 希望团队成员一键安装整套能力

一句话总结：

Skill 是能力单元，Plugin 是能力集合与分发载体。

官方参考：- Skills：https://developers.openai.com/codex/skills/- Plugins：https://developers.openai.com/codex/plugins/