Ecom Details Image — AI skill for Claude Code

ecom-details-image Skill

一个面向 claude code / Codex / workbuddy 的跨境电商和国内电商通用视觉创作 Skill。GPT-Image-2 上线以来，电商圈已经被刷屏了。图像生成的边界，如今又被推了一大步。下面是我精选的 25个高质量案例，涵盖纯色底产品主图、场景化生活图、平铺图、电商详情图、真实场景等等，全部配完整提示词，都可以利用 GPT-Image-2 API生成最终效果。一键生成电商相关图片！一键生成电商相关图片！输入产品图片和需求描述，自动生成完整的电商主图、详情页图片、社媒推广图、直播间场景图等全套视觉素材。 与众不同之处是：Campaign Style Lock 机制 和 强推广和重视转化效果。

它可以做两件事：

• 生成可执行的视觉简报和 AI 生图 Prompt。
• 直接生成图片：Codex 环境使用 agent 内置 imagegen 工具；其他环境（claude code / workbuddy 等）通过 apiz CLI 生图。

未安装 apiz CLI 时，它仍然可以正常输出 Prompt；CLI 就绪后，可以直接出图。 建议请先安装[apiz](https://apiz.ai) 官方 CLI 。

适用场景

• 商品主图、详情页视觉、Amazon / Shopify / TikTok Shop 图片。
• 广告图、社媒图、活动 Banner、缩略图。
• 品牌视觉方向、创意概念、图像模型 Prompt。
• 跨境电商 PDP 转化视觉：诊断视觉驱动、痛点驱动、情感价值驱动。
• 电商整套图片包：默认规划 5 张主图 + 7-9 张详情页图片。

它的工作方式

1. Prompt / Brief 模式

当你只需要策略、视觉方向或 Prompt 时，Skill 会输出：

1. 视觉简报。
2. 最终图片 Prompt。
3. 负面约束。
4. 假设说明。

如果是商品或营销图，还会补充：

• 转化驱动力诊断。
• Campaign Style Lock，用来锁定整套图的色板、冷暖调、字体、背景、光线和布局。
• 主图 / 创意序列。
• PDP 详情页图片序列。
• 图片内文案建议。
• 测试优先级。

2. Generate 模式

当你明确要求“生图、生成图片、出图、render image”时，Skill 会：

1. 先生成最终 Prompt。
2. 如果是电商详情页或整套商品图，先建立 Campaign Style Lock。
3. 再拆成独立图片 Prompt，并把同一段 Campaign Style Lock 原样放进每张 Prompt。
4. 按生图通道判断出图：Codex 环境直接调用 agent 内置 imagegen；其他环境调用 scripts/generate_image.py（内部走 apiz CLI）。
5. 输出生成文件路径。

生图通道（Codex imagegen / apiz CLI）

这个 Skill 不内置任何 API，也不共享任何密钥。生图前先判断环境：

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

如果 agent 会话中具备内置 `imagegen` 工具（即 Codex 环境），直接调用它生成图片：

• 把最终 Prompt（含 Campaign Style Lock）作为 prompt 传入，工具支持比例参数时传入对应比例。
• 用户提供了参考产品图时，按 imagegen 工具的参考图/编辑参数传入。
• 不运行 Python 脚本。

通道 B：其他环境 → apiz CLI

claude code / workbuddy 等环境通过 `scripts/generate_image.py` 生图。脚本不直连 HTTP API，而是调用 [apiz](https://apiz.ai) 官方 CLI：

1. 本地参考图先经 apiz upload 上传到 apiz CDN 换取公网 URL。
2. apiz generate --model --aspect-ratio --wait --json 提交并等待任务完成。
3. 脚本解析任务 JSON，把 result.images[].url 下载到本地输出目录。

前置条件：

apiz --version     # 确认已安装
apiz auth login    # 登录并保存 API key（本机通常已就绪）
apiz accou