中文

构建插件

构建插件

为 ChatGPT 创建、测试和分发插件

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

构建并提交插件

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

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

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

使用 @plugin-creator 创建插件

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

ChatGPT 中的插件创建器技能
描述预期结果、要包含的技能或 MCP 服务器,以及是否需要 用于测试的本地市场条目。例如:
@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-creator 技能
完成后:
  1. 检查 .codex-plugin/plugin.json
  2. 检查 skills/ 下的每个捆绑技能。
  3. 刷新 ChatGPT 或 Codex,并从其本地市场 来源安装插件。
  4. 在新对话中使用有代表性的请求测试插件。

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

手动创建仅含技能的插件

最小插件包含一个清单和至少一个技能:

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

创建 .codex-plugin/plugin.json

{
  "name": "meeting-follow-up",
  "version": "1.0.0",
  "description": "Turn meeting notes into decisions and next steps",
  "skills": "./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 将文件夹添加到本地市场,然后先安装并 测试,再进行共享。

继续阅读构建器文档

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

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