用途：通过 IKunCode 的 Gemini 图像预览模型进行文生图与图生图，并把生成或编辑后的图片保存到本地文件。用于用户明确要求使用 IKunCode 生图、指定宽高比或分辨率、批量出图，或需要基于 IKunCode 文档落地生成脚本的场景。
主要能力：支持文生图、图生图（提供参考图时传 --input，脚本会自动转成 Base64 并放入 inlineData）、批量出图、指定宽高比与分辨率。默认模型为 gemini-3.1-flash-image-preview（速度优先），用户明确要求高质量终稿时使用 gemini-3-pro-image-preview。默认参数为 --aspect-ratio 1:1 --size 2K。常用宽高比包括 1:1、16:9、9:16、4:3、3:4；常用尺寸为 1K、2K、4K，默认推荐 2K。
使用方式：优先使用 scripts/generate_image.js，不要重复手写请求体。先在当前 shell 注入 API Key：export IKUNCODE_API_KEY='你的 API Key'。文生图示例：node skills/ikuncode-image-gen/scripts/generate_image.js --prompt '一只可爱的皮卡丘正在开心地吃生日蛋糕，明亮温馨插画风格' --output ./pikachu-cake.png。图生图示例：node skills/ikuncode-image-gen/scripts/generate_image.js --input ./source.png --prompt '把背景改成星空，保留主体姿态和配色' --output ./edited.png。输出文件落到用户要求的目录；用户未指定时保存在当前工作目录。需要更多参数或返回格式细节时，再读 references/api.md。使用前需确认用户要的是 IKunCode 生图，而非 OpenAI Images API。
限制与安全规则：只从环境变量 IKUNCODE_API_KEY 读取密钥，不要写入 SKILL.md、脚本、测试文件、终端历史示例或 git 提交；示例中一律写“你的 API Key”或引用环境变量，不展示真实值；若用户直接在对话中贴出 Key，可临时用于当前命令，但不要落盘。故障处理：Missing IKUNCODE_API_KEY 表示当前 shell 未注入环境变量；API 返回 4xx/5xx 时直接展示接口返回体，通常是模型名、鉴权或参数错误；返回里没有 inlineData 说明接口没有成功产图，先打印完整 JSON 再排查。若命令因网络或沙箱失败，申请执行权限，不要把失败归咎到脚本本身。