用途:为 Codex 生成并脚手架化插件目录,包含必需的 .codex-plugin/plugin.json 清单,以及可选的插件文件夹和文件;同时可生成或更新市场条目,便于插件在 Codex UI 中排序展示。
主要能力:通过 scripts/create_basic_plugin.py 创建插件骨架,插件名统一规范为小写连字符格式且不超过 64 字符,外层文件夹名与 plugin.json 名称始终一致;默认创建于 ~/plugins/<plugin-name>。支持按需生成 skills/、hooks/、scripts/、assets/、.mcp.json、.app.json 等可选伴随目录或文件。使用 --with-marketplace 写入默认个人市场文件 ~/.agents/plugins/marketplace.json;可用 --path 与 --marketplace-path 指定仓库/团队市场,但仅在用户明确要求时使用。市场条目包含 policy.installation、policy.authentication 和 category,默认分别为 AVAILABLE、ON_INSTALL、Productivity;policy.products 仅在用户明确要求时添加。
使用方式:从包含 SKILL.md 的技能根目录运行脚手架脚本,例如 python3 scripts/create_basic_plugin.py <plugin-name>;需要市场条目时加 --with-marketplace。生成后编辑 <plugin-path>/.codex-plugin/plugin.json 填写具体元数据,清单不得保留 [TODO: ...] 占位符。交付前运行 python3 scripts/validate_plugin.py <plugin-path> 校验。更新已有本地插件时使用 scripts/update_plugin_cachebuster.py,不要手工编辑市场配置。修改 SKILL.md 后运行 python3 ../skill-creator/scripts/quick_validate.py .。
限制:默认个人市场路径可隐式发现,其他市场路径需先通过 codex plugin marketplace add 安装后才能提供重装说明;--marketplace-name 仅用于默认个人市场名已被占用时新建市场文件,不能用于重命名已有文件;--force 仅在有意覆盖时使用。清单中应省略 validation 拒绝的字段(包括 hooks),未实际创建伴随文件时不要写入 apps 和 mcpServers。创建或更新市场条目后,最终回复需附 Codex 应用交接链接,包含 View 与 Share 两个 Markdown 链接,使用 codex://plugins/<normalized plugin name>?marketplacePath=<absolute marketplace.json path> 格式,Share 版本追加 &mode=share,不要添加 pluginName 或 hostId 参数;未创建市场条目时不得输出这些链接。