通过 Codex CLI 生成图片，支持尺寸控制和批量模式。依赖：codex (npm)。代理默认启用。用 generate.sh 生成单张，batch_generate.sh 批量生成游戏 UI 素材，gen_size.sh 指定尺寸。所有输出保存至 ~/.codex/generated_images/。
Codex 图片生成
功能概述
Codex 图片生成是一项面向实际任务的技能，主要用于⚠️ 美术必读 — 尺寸限制 ：Codex CLI 最大输出约 1.57MP（1254×1254 级别），所有尺寸都会被卡在这个上限内；4K/FHD/2K 都会降级 ，不会真的输出那些尺寸；
核心要点
- 详见下方安全尺寸表；
- ⏱️ 超时注意 ：Codex CLI 生图耗时较长（约 30~90 秒），调用时 timeout 应设不低于 180 秒 ，避免 agent 误判为失。
- 它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
使用与执行
从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。
结果检查与注意事项
执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。
Codex 图片生成
⚠️ 美术必读 — 尺寸限制：Codex CLI 最大输出约 1.57MP（1254×1254 级别），所有尺寸都会被卡在这个上限内。4K/FHD/2K 都会降级，不会真的输出那些尺寸。详见下方安全尺寸表。
⏱️ 超时注意：Codex CLI 生图耗时较长（约 30~90 秒），调用时 timeout 应设不低于 180 秒，避免 agent 误判为失败而中断重试。
注意事项
完成后看一眼生成的图对不对：Codex CLI 报错信息不一定准——报“failed N times with a server error”不一定真没生成。Agent 有视觉能力就调一下 image 工具看一眼生成的图是否对需求；没生成或内容不对，重试即可。
尺寸限制速查
| 用途 | 推荐尺寸 | 实际输出 | 风险 |
|---|---|---|---|
| 方图素材（安全） | 1K / 1:1 / square |
1254×1254 | ✅ 无缩放 |
| 横版大图（安全） | 1536x1024 |
1536×1024 | ✅ 无缩放（唯一精确大尺寸） |
| 竖版素材（安全） | 9:16 |
941×1672 | ✅ 无缩放 |
| 横版4:3（安全） | 4:3 |
1448×1086 | ✅ 无缩放 |
| 16:9 横版 | 2K / FHD / 16:9 |
1672×941 | ⚠️ 实际只有 HD 级 |
| 4K / 1080p / 720p | ❌ 勿用 | 全部降级至 1672×941 | ❌ 严重缩水 |
| 小图如 512×512 | ❌ 勿用 | 膨胀至 1254×1254 | ❌ 严重放大 |
结论：游戏 UI 素材推荐用 1K（方图）或 1536x1024（横版），不要用 FHD/4K/720p 等标识。
快速参考
| 任务 | 命令 |
|---|---|
| 单张图片 | bash ~/.openclaw/skills/codex-imggen/scripts/generate.sh " |
| 指定尺寸 | bash ~/.openclaw/skills/codex-imggen/scripts/gen_size.sh |
| 批量游戏 UI | bash ~/.openclaw/skills/codex-imggen/scripts/batch_generate.sh " |