Codex 图像生成与编辑
为项目生成和编辑可直接使用的栅格图像资产。
文档明确区分内置工具与用户显式选择的 CLI,限制自动回退,要求使用 OPENAI_API_KEY 环境变量且不得粘贴密钥,并规定项目文件非破坏性保存,体现了权限和恢复意识。扣分在于图像会发送至外部图像服务,数据流、隐私保留、费用确认和内容审核边界未完整说明;未见明确的逐次用户确认机制或可验证来源归属。
工作流、模式边界、输入图像角色、输出路径和多种错误提示均有说明,脚本包含参数校验、文件存在检查及部分重试逻辑。扣分在于本次仅静态阅读,未见针对关键路径的测试或 CI 证据;内置工具行为、依赖可用性和异常覆盖仍无法复现验证。
受众、适用场景、生成与编辑判定、非适用范围、参考图与编辑目标区分均较清晰,具备较好的语义触发条件。扣分在于未说明中文提示词和中文用户体验支持,也未说明中国大陆网络可达性;CLI 依赖外部 API,环境适配仍有限。
文档结构较完整,包含渐进式说明、模式规则、决策树、提示词规范、示例、限制、依赖和输出约定。扣分在于缺少明确版本号、变更日志、维护责任人或更新路径,许可证元数据未知;仓库 README 还标明仓库已弃用,增加治理不确定性。
技能明确覆盖生成、编辑、批量资产和多类图像用途,并规定直接输出图像及项目保存策略,核心任务价值清楚。扣分在于静态材料未提供代表性产物或第三方执行证据,图像质量、文字准确性、编辑保真度和相对人工方案的收益无法验证。
SKILL.md、参考文档和脚本提供了可审计的规则、参数与错误路径,且内容之间大体一致。扣分在于未见提交测试、CI、实际运行日志或第三方复核;结论主要依赖作者提供的静态材料,跨来源佐证有限。
- 图像生成和编辑涉及外部服务、潜在敏感图像与 API 费用;使用前应确认数据处理、费用和内容政策。
- 仓库 README 标明已弃用,当前技能的维护责任、版本状态和后续更新路径需要另行确认。
- 未提供中文支持或中国大陆网络可达性的证据,相关用户可能需要额外环境配置。
- 本评估未执行工具或脚本,未验证实际输出质量、依赖安装和异常行为。
它能做什么 & 适用场景
这是 openai/skills 仓库中的 imagegen 技能,专门处理照片、插画、纹理、精灵图、产品样机、UI 样机和透明背景切图等栅格图像任务。默认使用内置 image_gen 工具,不需要 OPENAI_API_KEY;只有用户明确选择 CLI 回退路径时,才使用 scripts/image_gen.py。它也提供生成、编辑、批量生成的工作流指导,并强调提示词结构、输入图像角色、非破坏性编辑和项目内保存。该仓库已弃用,当前 Codex 技能和插件示例应参考 OpenAI Plugins 仓库。
根据用户提示生成新的栅格图像,或编辑对话中可见的现有图像;对本地编辑目标,先使用 view_image 使其进入对话上下文。它可按生成或编辑意图、单个资产或多个变体选择流程,并使用预定义的图像用例分类和结构化提示词模板。明确选择 CLI 回退时,运行 scripts/image_gen.py 的 generate、edit 或 generate-batch 子命令,要求本地设置 OPENAI_API_KEY;生成的项目资产应复制到工作区。
- 网站或产品团队需要生成 landing page hero、产品摄影或包装样机时,使用该技能创建栅格视觉资产。
- 游戏开发者需要概念图、精灵图或多个资产变体时,使用其生成流程。
- 设计师需要制作应用或网站 UI 样机、线框图或信息图时,使用对应提示词结构。
- 用户需要替换背景、移除对象、调整天气光线或制作透明背景切图时,使用编辑模式。
- 用户需要保留人物身份、姿势或产品主体,仅改变指定视觉元素时,使用带不变量约束的编辑流程。
优缺点一览
- 覆盖生成、编辑和批量变体等常见栅格图像工作流。
- 内置工具是默认路径,不要求用户提供 OPENAI_API_KEY。
- 提供具体的编辑不变量、输入图像角色和结构化提示词指导。
- 明确区分适合栅格生成的任务与应使用 SVG、HTML/CSS 或原生代码完成的任务。
- 技能依赖 Codex 的 image_gen 和 view_image 等工具,移植到其他客户端可能需要适配。
- CLI 回退路径要求 OPENAI_API_KEY、Python、uv 和 openai Python 包。
- 未提供测试套件、支持平台清单或实际生成质量评估。
- 仓库 README 已声明该仓库弃用,当前维护方向转向 OpenAI Plugins 仓库。
如何安装
imagegen 位于 skills/.system/imagegen/。README 说明 .system 技能会随最新版本 Codex 自动安装,因此通常无需单独安装。该仓库已弃用;如需当前技能和插件示例,应转向 OpenAI Plugins 仓库。单个技能的许可证应在其目录中的 LICENSE.txt 查找,但本资料未提供该文件内容。
如何使用
直接提出图像生成或编辑请求,并说明用途、主体、风格、构图、光线、文字和限制条件;默认使用内置 image_gen 工具。若编辑本地文件,先让工具加载该文件;若要使用 CLI,必须明确要求 CLI 路径,并在本地设置 OPENAI_API_KEY,然后使用 scripts/image_gen.py 的 generate、edit 或 generate-batch 子命令。
对比同类
它明确将栅格图像生成与编辑同 SVG、矢量图标系统、HTML/CSS、canvas 及其他代码原生输出区分开来;若目标是可预测的矢量或代码原生结果,应选择这些替代方式。