用途：为任务提供可脚本化的 AI 位图生成能力，基于用户的 Codex ChatGPT 登录，无需 OPENAI_API_KEY。适用于需要在项目或技能流程中按提示词产出图像的场景。
前提条件：只需 Python 3.10+，支持 macOS 和 Linux。需先执行 codex login 并选择 ChatGPT 认证，CLI 读取 $CODEX_HOME/auth.json 或 ~/.codex/auth.json；可用 scripts/imagegen auth-status 检查登录状态。
主要能力与用法： 生成图片： <skill-path>/scripts/imagegen generate --prompt "提示词" --out output/lake.png 带参考图生成（最多 5 张，用于风格/构图/主体指导）：--reference 可重复，仅支持本地 PNG/JPEG/WebP/GIF 路径。 参数：--prompt 或 --prompt-file 必填；--out 必填，缺省 .png 会补上；--quality 为 low|medium|high|auto，默认 auto；--size 为 auto 或 WIDTHxHEIGHT，需满足 gpt-image-2 约束（16 的倍数、最大边 3840、比例不超过 3:1、像素在 655,360 至 8,294,400 之间）；--force 覆盖已存在输出，默认自动加版本号 -v2、-v3；--timeout 默认 300 秒；--dry-run 只打印计划请求不调用后端。 输出：成功时 CLI 打印包含保存路径、尺寸和元数据的 JSON。使用前应读取/检查生成文件确认质量。输出路径约定：用户指定位置优先；项目绑定资源放入项目资源文件夹；无指定目标的草稿预览放入调用技能自己的 outputs/ 目录，否则用项目本地 output/imagegen/。
限制：使用私有 Codex 后端（/backend-api/codex/responses）与托管的 image_generation 工具，并非公开 OpenAI API，可能随时变化；生成会消耗 ChatGPT/Codex 使用额度（约为普通轮次的 3-5 倍）；gpt-image-2 不支持原生透明，如需透明可提示平坦的色键背景再本地去除；默认编排模型为 gpt-5.5，可用 --model 或 IMAGEGEN_MODEL 覆盖。收费与价格信息暂未提供。