构建插件

要构建或提交插件，请参阅 developers.openai.com 上的完整构建器文档。

构建并提交插件

本页提供简要介绍。插件是一种可安装的软件包， 其中可以包含技能、MCP server，或两者兼有。MCP server还可以返回 可选 UI。

ChatGPT 和 Codex 共用一个通用插件目录。只需发布一次公共插件， 即可让同一条目在两款产品所支持的界面中都可被发现。在开发期间，请先使用本地市场测试软件包， 再将其提交到通用目录。

有关通过 GitHub 在工作区中分发插件的信息，请参阅 插件管理。

如果你仍在迭代某个个人工作流，请从技能开始。 如果你想共享该工作流、打包相关技能、 连接外部服务，或向团队分发稳定的能力，请构建插件。

使用 @plugin-creator 创建插件

若要以最快的方式完成设置，请在 ChatGPT Work 模式中使用内置的 @plugin-creator 技能，或在 Codex 中使用 $plugin-creator。

@plugin-creator Create a plugin named meeting-follow-up.
Include a skill that turns meeting notes into decisions, owners, and next steps.
Add it to a personal marketplace so I can test it locally.

该技能会创建受支持的 .codex-plugin/plugin.json 兼容性 清单，整理插件文件夹，并可将插件添加到本地 市场。此脚手架与手动示例中使用的可移植根目录 plugin.json 格式 有所不同。有关可选文件和目录，请参阅脚手架布局 。

1. 检查 .codex-plugin/plugin.json。
2. 根据 指令遵循指南检查 skills/ 下捆绑的每个技能。
3. 刷新 ChatGPT 或 Codex，然后从其本地市场 来源安装插件。
4. 在新对话中使用有代表性的请求测试插件。

如果插件包含 MCP server，请先构建并测试该服务器，然后 向 @plugin-creator 提供已注册的连接详细信息。有关工具、身份验证、部署和测试，请遵循完整的 MCP server工作流。

手动创建仅含技能的插件

一个最小的可移植 Agent Plugins 包包含根目录下的清单和至少 一个技能：

meeting-follow-up/
├── plugin.json
└── skills/
    └── meeting-follow-up/
        └── SKILL.md

在插件根目录下创建 plugin.json：

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "meeting-follow-up",
  "version": "1.0.0",
  "description": "Turn meeting notes into decisions and next steps"
}

可移植包会自动发现 skills/ 中的技能。添加 skills/meeting-follow-up/SKILL.md：

---
name: meeting-follow-up
description: Extract decisions, owners, and next steps from meeting notes.
---

Review the meeting notes. Return:

1. Decisions
2. Action items with owners
3. Open questions

使用稳定的 kebab case 插件名称。技能描述应足够具体， 以便 ChatGPT 和 Codex 能够识别该工作流的适用场景。

使用 @plugin-creator 将文件夹添加到本地市场，然后先安装并 测试，再进行共享。

继续阅读构建器文档

有关完整的构建器文档，请参阅 插件文档。其中涵盖：

• 插件架构
• 构建技能
• 构建 MCP server
• 添加可选 UI
• 打包插件
• 测试插件
• 提交和发布

若要浏览、安装、启用或移除插件，请参阅使用 插件。