Codex 插件脚手架技能（Plugin Creator）

技能简介

Plugin Creator 是 OpenAI 官方为 Codex 生态提供的 Agent Skill，用于把手工编写插件的过程标准化：手动搭建 Codex 插件时，常因清单（manifest）字段不规范而导致插件无法加载，或个人/仓库市场（marketplace）条目不一致。本技能能按校验要求归一化插件名称、生成合规清单，按需创建技能、hooks、脚本、资产、MCP 与 app 结构，并自动维护个人与仓库级别的市场条目，让开发者把精力放在插件逻辑而非配置细节上。来源 GitHub 官方仓库 openai/codex 的 codex-rs/skills 示例资产，MIT 许可，Skillstore 质量分 83，属金级（gold）。

核心能力

1. 名称归一化：按校验规则规范插件名称，生成可直接通过校验的插件清单。
2. 组件按需创建：可选生成 skills、hooks、scripts、assets、MCP 与 app 等插件伴随结构。
3. 市场条目管理：创建或更新个人与仓库级市场条目，并写入必需的政策字段。
4. 全面校验：校验插件清单、技能元数据、伴随文件、URL、资产与语义化版本号。
5. 版本刷新：用一次 Codex cachebuster 后缀刷新本地插件版本，避免缓存问题。
6. 市场读取：从个人或仓库市场文件中读取市场名称，保证条目归属正确。

安装配置

1. 通过 Skillstore CLI 一键安装：npx skillstore add openai/plugin-creator。
2. 也可直接从 GitHub 仓库 openai/codex 的 codex-rs/skills/src/assets/samples/plugin-creator 目录获取组件。
3. 该技能适配 Claude、Codex 与 Claude Code，风险因素涉及网络、文件系统与外部命令，安装后无需额外密钥。
4. 建议在目标仓库根目录运行，以便正确读取与写入市场文件与插件目录。

使用步骤

1. 确定插件归属：是个人插件还是团队仓库插件，并确认市场文件位置。
2. 向技能提出请求，例如「在我的个人市场创建一个名为 xxx 的本地插件，使用默认清单值并校验结果」。
3. 如需附加能力，追加说明要生成 skills、scripts、assets、MCP 或 app 等伴随文件及父路径。
4. 技能生成脚手架并写入市场条目，随后自动校验清单、元数据、文件、URL 与版本号。
5. 查看校验结论，修正问题后使用 cachebuster 刷新本地版本，再加载测试插件。

适用场景

1. 个人插件开发：快速搭建个人插件脚手架并注册到默认 Codex 市场。
2. 团队脚手架标准化：创建含技能、hooks、脚本、资产、MCP 与 app 文件的仓库插件。
3. 本地插件维护：在本地开发中校验清单并刷新 cachebuster 版本。
4. 插件市场治理：统一团队与个人市场的条目格式与政策字段。
5. 插件包发布前检查：在分发给他人前完成一次完整校验。

适用人群

• 开发 Codex 插件的工程师与技术爱好者。
• 维护团队插件市场与脚手架的平台团队。
• 需要规范化插件结构的开源维护者。
• 希望批量管理本地插件版本的开发者。

工作原理

技能围绕「脚手架 + 校验」两条主线工作：先归一化插件名称、确定市场归属与目标路径，再按需创建清单与伴随组件，并写入个人或仓库市场条目；随后逐项校验清单字段、技能元数据、伴随文件、URL、资产引用与语义化版本，发现问题即给出修正指引；最后可用 cachebuster 后缀刷新本地版本，确保 Codex 缓存正确加载最新构建。全过程不依赖私有密钥，仅需读写本地文件与市场配置。

注意事项

• 需在目标仓库或市场文件所在目录运行，路径错误会导致条目写入失败。
• 校验会读取本地文件与网络引用，离线环境可能部分失败。
• 生成的脚手架为标准结构，插件业务逻辑仍需开发者自行实现。
• cachebuster 仅刷新本地缓存标识，不改变插件功能。
• 涉及团队市场修改时，请遵循仓库既定的贡献规范。

官方链接

• 技能主页：https://skillstore.io/skills/plugin-creator
• 源码仓库：https://github.com/openai/codex
• 许可协议：MIT