用户正在解决什么问题

一个插件本地能运行，不代表已经满足提交要求；提交进入审核，也不代表插件已经公开发布。

适合哪些用户

第一次评估插件开发的普通用户、产品经理、开发者和交付负责人。

核心结论

当指令、示例或打包资源足以指导现有工具完成工作流时，可选择 Skills only；需要实时数据、认证、受控工具或自有基础设施时使用 MCP server；视觉交互确有价值时再增加 UI。开发、提交、审核通过和发布是不同阶段。

判断流程与操作步骤

  1. 先写清用例、用户、输入输出、所需数据、外部动作和成功标准，再选择 Skills only、MCP server 或两者组合
  2. 按官方结构打包插件；核心入口是 .codex-plugin/plugin.json，并根据形态加入 skills、MCP 配置或可选 UI 资源
  3. 通过本地 marketplace 或开发模式安装，在新对话中测试代表性请求、边界条件和失败行为
  4. 准备提交权限和身份：当前官方要求 Apps Management 的 Write 权限，并完成开发者或企业身份验证
  5. 准备 listing、MCP 服务器/域名/认证与工具信息、准确的工具注解、最终 Skill bundle、starter prompts、可用范围、release notes 和政策声明
  6. 按当前官方要求准备至少 5 个 positive cases 与 3 个 negative cases，并让说明与真实行为一致
  7. 提交后等待审核；提交只会启动审核，审核通过后仍由开发者选择何时发布

权限、限制和容易踩坑的地方

本页只列当前关键阶段，不复制维护完整 manifest、hooks、MCP 或 marketplace 技术手册。提交字段、限制和审核政策可能更新，实施时必须逐项对照官方 submission 与 submission-errors 页面。

如何验证最终结果

分别验证：本地安装成功、新对话能完成代表性请求、权限和工具注解符合实际、正反测试可复现、提交状态可见。不要把“已提交”“审核通过”和“已发布”合并成一个状态。

参考来源

最后核验日期：2026-07-30