用途：为 Codex 创建并搭建插件目录，生成符合规范的插件清单与可选配套结构。
主要能力：始终创建 <parent-plugin-directory>/<plugin-name>/.codex-plugin/plugin.json（含完整 schema 形状、占位值和完整 interface 段）；可选用 --with-skills、--with-hooks、--with-scripts、--with-assets、--with-mcp、--with-apps 生成对应 skills/、hooks/、scripts/、assets/、.mcp.json、.app.json；用 --with-marketplace 创建或更新 marketplace 条目。插件名按 skill-creator 命名规则归一化为小写连字符，长度不超过 64 字符，外层文件夹与 plugin.json 的 name 始终一致。
用法：从仓库根运行 python3 .agents/skills/plugin-creator/scripts/create_basic_plugin.py <plugin-name>，默认在 ~/plugins/<plugin-name> 创建；加 --with-marketplace 生成个人 marketplace 条目，默认路径 ~/.agents/plugins/marketplace.json；团队/仓库场景用 --path ./plugins --marketplace-path ./.agents/plugins/marketplace.json。若当前仓库已有 .agents/plugins/marketplace.json 且未说明个人还是团队，应先询问。规范化插件名如 My Plugin → my-plugin。用户明确指定时才用 --force 覆盖。
适用场景：需要快速得到可填写骨架的 Codex 插件目录，或把插件登记到 Codex 界面渲染顺序中。
限制：生成的清单保持占位值，需人工或后续步骤填入；marketplace 条目默认 policy.installation 为 AVAILABLE、policy.authentication 为 ON_INSTALL，仅在用户显式指定其他允许值时才覆盖；policy.products 仅在明确要求时添加；source.path 保持相对 marketplace 根为 ./plugins/<plugin-name>；不得移除必需结构，保持 .codex-plugin/plugin.json 存在；保留已有 interface.displayName。marketplace 内 plugins[] 顺序即 Codex 渲染顺序，默认追加。创建或更新 marketplace 条目后，以 Codex 应用交接结尾，用 Markdown 链接给出 View 与 Share，深链格式为 codex://plugins/<plugin-name>?marketplacePath=<绝对路径>，Share 加 &mode=share，不添加 pluginName 或 hostId 参数；未创建或更新条目时不输出该链接。规范示例见 references/plugin-json-spec.md。编辑 SKILL.md 后运行 python3 <path-to-skill-creator>/scripts/quick_validate.py .agents/skills/plugin-creator 校验。