Codex 插件创建器
为 Codex 快速生成规范的插件目录、清单与 marketplace 配置。
证据显示主要执行本地目录创建、JSON写入和可选市场配置更新,并要求对覆盖操作使用--force;但未说明最小路径范围、回滚机制、敏感数据处理或写入前确认,因此扣11分。
文档、脚本和候选Skill版本存在明显不一致:提供的脚本默认写入当前仓库并生成TODO占位符,缺少候选版本所引用的多个脚本和参数;未见测试或异常输入覆盖,因此扣14分。
目标用户、插件脚手架、个人与团队市场及可选目录结构较明确,也说明了部分非适用边界;但触发条件、输入输出契约和环境兼容证据不足,未明确中文支持,因此扣7分。
文档有快速开始、工作流、字段规则、参考资料和验证章节,结构较清晰;但版本、变更记录、明确维护责任、许可证和完整依赖说明不足,且引用文件未全部提供,因此扣8分。
核心目标是生成插件骨架和市场条目,预期输出较直接;但候选文档与脚本行为不一致,验证脚本和更新脚本不可由给定材料确认存在,生成结果仍需人工修订或验证,因此扣10分。
脚本源码和规范样例提供了一定可审计依据,但没有提交测试套件、CI覆盖或第三方执行证据,且关键引用文件缺失,因此扣7分。
- 给定材料包含互相冲突的Skill与脚本版本;在实际使用前应核对目标修订中的脚本、参数和引用文件。
- 脚本会写入本地目录并支持--force覆盖,但未提供事务性更新、备份或恢复机制。
- 不要将生成的占位或未经验证的manifest直接发布;应先完成元数据并运行可获得的验证工具。
- 未提供许可证文件或明确版本维护信息,许可证元数据应视为未知。
它能做什么 & 适用场景
该技能用于创建和维护 Codex 插件的基础目录结构。它会生成必需的 `.codex-plugin/plugin.json`,并可按需创建技能、钩子、脚本、资源、MCP 和应用配置目录或文件。它还可生成或更新仓库级 `marketplace.json`,用于插件排序和可用性元数据。插件名称会被规范化为不超过 64 个字符的小写连字符格式。
运行 create_basic_plugin.py,根据插件名称创建插件目录和 plugin.json,填入完整结构及占位值;可选创建 skills/、hooks/、scripts/、assets/、.mcp.json 和 .app.json;使用 --with-marketplace 时创建或更新 .agents/plugins/marketplace.json,写入插件来源、安装策略、认证策略和分类。
- 需要为 Codex 开始开发本地插件的软件开发者,可用它生成初始目录和清单。
- 需要为插件补充脚本、资源或 MCP 配置的开发者,可一次启用多个可选目录或文件。
- 希望让插件出现在 Codex UI 排序中的仓库维护者,可生成 marketplace 条目。
- 管理 home-local 插件的用户,可指定插件目录和 marketplace 文件路径。
优缺点一览
- 生成必需的插件清单和基础目录结构。
- 支持插件名称规范化和多个可选组件。
- 可维护 marketplace 中的安装、认证、分类和顺序信息。
- 面向 Codex 插件格式,移植到其他平台可能需要调整。
- 生成的清单保留占位值,需要人工补全。
- 源材料没有提供测试套件、平台兼容性测试或失败处理细节。
- 仓库 README 明确说明该仓库已弃用。
如何安装
README 说明 .system 下的技能会随最新 Codex 自动安装;该仓库整体已弃用,当前示例应参考 OpenAI Plugins 仓库。源材料没有提供单独安装此技能的命令。
如何使用
在仓库根目录运行 python3 .agents/skills/plugin-creator/scripts/create_basic_plugin.py <plugin-name>,然后编辑生成的 .codex-plugin/plugin.json。需要 marketplace 条目时添加 --with-marketplace;需要可选结构时添加 --with-skills、--with-hooks、--with-scripts、--with-assets、--with-mcp 或 --with-apps。如果插件位置未明确,应先选择 repo-local 或 home-local。