用途:为 Codex 创建插件脚手架,生成插件目录及必需清单 .codex-plugin/plugin.json,并可生成个人 marketplace 条目与可选伴随目录。该技能也可在 Claude Code 或 GitHub Copilot 中使用,但仅用于产出或校验面向 Codex 的插件;面向 Claude Code 的插件需改用其官方插件格式,不得把 .codex-plugin/plugin.json、marketplace、cachebuster、重装与 deeplink 规则当作这些宿主机的原生格式。
主要能力:运行 python3 scripts/create_basic_plugin.py <plugin-name> 创建插件,插件名会规范为小写连字符形式且不超过 64 字符,外层文件夹名与 plugin.json 的 name 始终一致,默认创建于 ~/plugins/<plugin-name>。可加 --with-marketplace 生成个人 marketplace 条目(默认 ~/.agents/plugins/marketplace.json)。可用 --with-skills、--with-hooks、--with-scripts、--with-assets、--with-mcp、--with-apps 生成可选目录或文件。仅当默认个人 marketplace 名被占用时使用 --marketplace-name;仅在用户明确要求时使用仓库/团队 marketplace(--path 与 --marketplace-path)。生成后运行 python3 scripts/validate_plugin.py <plugin-path> 校验;更新已有本地插件时用 python3 scripts/update_plugin_cachebuster.py <plugin-path>,不要手改 marketplace 配置。
marketplace 条目须包含 policy.installation、policy.authentication 与 category,默认分别为 AVAILABLE、ON_INSTALL;policy.products 仅在用户明确要求时添加。插件在 plugins[] 中的顺序即 Codex 渲染顺序,新增条目默认追加。若目标 marketplace 文件不存在,需先创建含顶层 name、interface.displayName 与 plugins 数组的根对象。当创建或更新了 marketplace 条目时,回复末尾给 Codex 应用移交说明,并提供 View 与 Share 的 Markdown 链接,URL 使用 codex://plugins/<normalized plugin name>?marketplacePath=<absolute marketplace.json path>,Share 加 &mode=share;未创建或更新 marketplace 条目的不输出这些链接。
限制:不要手工留下 [TODO: ...] 占位符;保留 .codex-plugin/plugin.json;除非伴随文件实际创建,否则不要在 plugin.json 中保留 apps 与 mcpServers;省略校验会拒绝的字段(包括 hooks);仅在有意覆盖时用 --force。默认个人 marketplace 流程不要提示运行 codex plugin marketplace add,该命令仅用于非默认 marketplace 配置。若宿主无法验证 Codex 插件元数据,应本地生成并明确报告未验证的步骤,不得声称使用了未暴露的 MCP 操作。
适用场景:需要为 Codex 创建或更新本地插件、生成插件清单与 marketplace 条目、进行插件校验与迭代重装时使用。跨客户端可移植说明:Codex 中可同步至 $CODEX_HOME/skills/plugin-creator 并在大改后重启 Codex;Claude Code 与 GitHub Copilot 需放入其可见技能路径,但只能产出 Codex 目标插件。关于精确规范样例见 references/plugin-json-spec.md,更新与重装指引见 references/installing-and-updating.md。具体收费、价格与平台支持等资料暂未提供。