OpenAI Plugins：理解和构建 Codex 插件的官方示例集合
一分钟看懂
OpenAI Plugins 是 Codex 插件示例仓库。它展示插件的目录结构、必需清单文件和可选能力入口，帮助开发者了解如何把技能、应用连接、MCP 服务、Agent、命令、钩子与资源打包成可分发插件。
你可以用它做什么
- 查看 Codex 插件应包含的清单和目录结构。
- 参考 Figma、Notion、Web、iOS、macOS、Expo 等插件示例。
- 学习如何把技能、应用配置或 MCP 配置组合在同一插件中。
- 了解默认插件市场如何索引仓库内的插件目录。
- 以官方示例为起点开发或检查自己的插件包。
主要能力
每个示例位于 plugins/<name>/，必须包含 .codex-plugin/plugin.json。仓库展示了 skills/、.app.json、.mcp.json、插件级 agents/、commands/、hooks.json 和 assets/ 等可选表面，并通过 .agents/plugins/marketplace.json 提供默认市场索引。
适合哪些人
它适合准备开发 Codex 插件的工程师、希望审查插件结构的维护者，以及想了解技能、连接器和 MCP 如何组合的高级用户。普通 Codex 使用者通常只需安装所需插件，不必克隆整个仓库。
怎么开始使用
先浏览与目标场景接近的 plugins/ 子目录，再对照其 plugin.json 和配套文件理解结构。创建自己的插件时，应保留必需清单并只加入实际需要的能力目录；是否能直接安装某个示例，应以当前 Codex 的插件安装说明和仓库内对应插件配置为准。
使用前需要知道
该仓库定位为示例集合，不代表每个示例都具备相同成熟度、权限需求或运行依赖。插件可能连接第三方服务、读取本地资源或需要 API 凭据，安装前应逐项检查清单、权限和依赖。仓库首页当前未展示统一许可证说明，因此复用代码前应检查具体文件或子目录的授权信息。