codex-images 是一个用于批量生成位图图像的技能，依托 Codex CLI 及其内置的 image_gen 能力。它适合在需要一次生成多张图片、使用提示词数组、生成目录变体等场景下使用。
使用前提：需要安装并登录 Codex CLI，可通过 codex --version 检查。若未安装，需提示用户执行 npm i -g @openai/codex 安装，并运行一次 codex 完成登录。
安装方式：将捆绑的 CLI 安装到目标仓库根目录（scripts/image_gen 位于本技能文件夹内）。如果 .codex/scripts/image_gen 已存在，替换前应先检查。安装命令如下： mkdir -p .codex/scripts cp <this-skill-folder>/scripts/image_gen .codex/scripts/image_gen chmod +x .codex/scripts/image_gen
默认输出：.codex/scripts/output/<batch-name>-<timestamp>/，其中包含 NNN-clean-name.png、logs/job-NNN.log 以及 manifest.json（copied[] 记录 path、promptIndex、prompt、name）。建议使用 { "name", "prompt" } 对象以获得稳定的名称。
使用示例： .codex/scripts/image_gen --name hats --prompts '["prompt one", "prompt two"]' .codex/scripts/image_gen --out .codex/scripts/output/tshirts --prompts '[{"name":"men-white-crew-tee","prompt":"..."}]' .codex/scripts/image_gen --name catalog --prompts prompts.json --concurrency 3 .codex/scripts/image_gen --name cap-variants --prompt "..." --count 3 .codex/scripts/image_gen --prompts prompts.json --dry-run
--prompts 参数接受 JSON 字符串数组、{name,prompt} 数组、包含上述任一内容的文件，或换行分隔的提示词。
参考图像（缩略图、人脸、产品等）：保持源图像只读，先将需要的图像复制到本地。每个最终图像对应一个命名提示词对象；切勿将多个概念打包进一个任务或一个 --count。每个提示词必须列出绝对本地路径，并告知嵌套的 Codex 任务将其作为 referenced_image_paths 传递给 image_gen。先干跑，再运行；manifest.json 必须为每个提示词记录一次成功复制。
目录提示词：先检查应用的分类/筛选结构。除非明确要求，否则不要出现人物、人体模型、面部、文字、标志或棋盘格。闭合衬衫：正面全貌、闭合领口、无开襟。
上传/导入保持在目标仓库内。生成后，验证提示词数量等于复制图像数量、尺寸可用且哈希唯一。返回输出目录和 manifest.json 路径后停止。