用途：通过 Codex CLI 的 $imagegen 技能生成专业插画风格的位图资产（吉祥物、主视觉图、logo、精灵图、产品样机等）。当资产需要看起来经过设计而非用 SVG/CSS/SwiftUI 手工拼形状时使用。架构图、流程图、时序图不属于本技能，应改用 docs-diagram。
主要能力：封装一次耗时数分钟、按额度计费的 Codex 运行；支持透明背景（内置 image_gen 无原生 alpha，先在纯色抠像背景上生成再本地去背）；支持批量资产与角色一致性（把完整共享设计简报放进每个提示，变体作为首张已批准图的编辑而非独立生成，批量串行执行）。
使用方式：先检查环境 codex --version，未安装则提示安装 Codex CLI（npm i -g @openai/codex 或 brew install codex，然后 codex login）。在目标仓库根目录运行，提示整体用单引号包裹，确保 $imagegen 原样传给 codex。示例：codex exec --approve-for-me -m gpt-6-sol -c model_reasoning_effort="high" -o /tmp/codex-imagegen-final.md '$imagegen using gpt-image-2.5-sunburst via the built-in image tool to create ...' > /tmp/codex-imagegen-run.log 2>&1 &。用 -o 捕获最终摘要，轮询日志查看进度，不要用 tail/head 管道（会缓冲）。进程退出后再确认目标路径文件存在。
适用场景：README 主视觉、应用吉祥物、图标集、精灵图、单张占位图等。批量、一致性关键或用户明确说“final/official”的资产，运行前需确认设计简报、模型、effort、输出路径与预计耗时。
限制：不要编造模型 ID；已知可用默认值为 gpt-6-sol（agent）与 gpt-image-2.5-sunburst（图像），被拒时查 codex --version / codex exec --help。Codex 无法报告后端实际使用的图像模型，只能称“请求了 Sunburst”。xhigh 消耗大量 token/额度，不要默认使用。不要仅凭 CLI 声称去背成功，必须打开 PNG 检查透明、边缘与色溢；粉色/洋红系主体不要传 --despill/--spill-cleanup。ChatGPT 账号认证会拒绝仅 API 模型。故障排查见 references/troubleshooting.md。