如需构建或提交插件,请参阅 developers.openai.com 上的完整插件构建文档。
本页提供简要介绍。插件是一种可安装的软件包,可以包含技能、MCP 服务器,也可以同时包含两者。MCP 服务器还可以返回可选的用户界面。
ChatGPT 和 Codex 共用一个通用插件目录。公开插件只需发布一次,用户便可在两款产品受支持的界面中找到同一个插件条目。开发期间,请先通过本地市场测试软件包,再将其提交到通用目录。
如需通过 GitHub 在工作空间内分发插件,请参阅 插件管理。
如果您仍在迭代某个个人工作流程,请先从技能入手。如果您希望共享该工作流程、打包相关技能、连接外部服务或向团队分发稳定的能力,请构建插件。
使用 @plugin-creator 创建插件
如需以最快的方式完成设置,请在 ChatGPT Work 模式中使用内置的 @plugin-creator 技能,
或在 Codex 中使用 $plugin-creator。
请描述预期结果、要包含的技能或 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.json。
有关可选文件和目录,
请参阅脚手架布局。
完成后:
- 审查
.codex-plugin/plugin.json。 - 检查
skills/下随插件打包的每项技能。 - 刷新 ChatGPT 或 Codex,然后从插件的本地市场源安装插件。
- 在新对话中使用有代表性的请求测试插件。
如果插件包含 MCP 服务器,请先构建并测试该服务器,
然后向 @plugin-creator 提供已注册的连接详情。请按照完整的
MCP 服务器工作流程
完成工具、身份验证、部署和测试相关工作。
手动创建仅包含技能的插件
最小的可移植 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
请使用稳定的插件名称,采用小写单词以连字符分隔的命名方式。技能描述应足够具体,让 ChatGPT 和 Codex 能识别该工作流程的适用场景。
使用 @plugin-creator 将文件夹添加到本地市场,
然后安装并测试插件,再进行分享。
继续阅读插件构建文档
如需完整的插件构建文档,请参阅 插件文档。其中涵盖:
如需浏览、安装、启用或移除插件,请参阅使用 插件。