ecom-details-image Skill

当用户需要视觉策略、图片 Prompt、商品主图、营销图、社媒图、广告图、电商 PDP 视觉，或要求直接 AI 生图时，使用这个 Skill。

这个 Skill 有两种模式：

1. Brief / Prompt 模式：只输出视觉简报和可执行图片 Prompt。
2. Generate 模式：当用户明确要求“生图、生成图片、出图、render image”时，先输出最终 Prompt，再按下方生图通道判断选择生成方式。

不要暴露、索要、写入、提交或回显真实 API key。使用者必须通过自己的环境变量配置 API。

---

生图通道判断（Generate 模式必读）

直接生图前必须先判断当前运行环境，选择对应通道：

通道 A：Codex 环境 → agent 内置 imagegen

判断方法：检查你自己（agent）当前会话中是否具备内置的 imagegen 工具。有，说明你在 Codex 环境。

执行方式：

1. 不要调用 scripts/generate_image.py，直接调用内置 imagegen 工具。
2. 把最终 Prompt（含 Campaign Style Lock）作为 prompt 传入；工具如支持比例/尺寸参数，传入对应比例。
3. 如果用户提供了参考产品图，按 imagegen 工具的参考图/编辑参数传入。
4. 把返回的图片文件记录为 Generated Files；建议将文件移动或复制到 generated-images/<产品slug>/ 目录，与本 Skill 的输出习惯保持一致。
5. imagegen 不可用或调用失败时，回退到通道 B。

通道 B：非 Codex 环境 → apiz CLI 脚本

claude code / OpenClaw 等其他环境使用 scripts/generate_image.py，脚本内部调用 apiz CLI（https://apiz.ai）提交生成任务并下载结果，不再直连任何 HTTP API。

前置条件（本机通常已就绪）：

1. 已安装 apiz CLI（apiz --version 可执行）。
2. 已登录：apiz auth login 保存过 API key，或设置了 APIZ_API_KEY 环境变量。认证完全由 CLI 处理，脚本不接触密钥。

可选配置（通过 .env 或环境变量，全部可省略）：

APIZ_IMAGE_MODEL=apiz/gpt-image-2.5-flare
# APIZ_API_KEY=sk-xxx        # 仅未使用 apiz auth login 时需要
# APIZ_BASE_URL=https://api.apiz.ai
# APIZ_BIN=C:\path\to\apiz.exe

• APIZ_IMAGE_MODEL：apiz 图片模型 id，默认 apiz/gpt-image-2.5-flare（GPT Image 2.5，支持参考图编辑、10 种比例、1K/2K/4K）。兼容旧别名 IMG_MODEL、OPENAI_IMAGE_MODEL、OPENAI_MODEL。
• 其他可用模型用 apiz models list 查看（category=image），如 fal-ai/nano-banana-pro、apiz/gpt-image-2.5-sunburst。
• 旧变量 IMG_API_KEY、IMG_BASE_URL 仍被兼容读取。

生图脚本：

python3 scripts/generate_image.py --prompt "clean product hero image..." --size 1:1
python3 scripts/generate_image.py --prompt-file prompt.txt --output-dir outputs
python3 scripts/generate_image.py --env-file .env --prompt-file prompt.txt

参考图片：如果用户提供了本地产品照片路径，使用 --image 参数传入；脚本会先 apiz upload 上传到 apiz CDN 换取公网 URL，再走图生图，这对保证产品外观准确非常有效。已有公网 URL 时用 --image-url 直接传入。