liangdabiao/ecom-details-image

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

ecom‑details‑image 技能

是什么 – 这是一个指令列驱动的“技能”，协助您建立电子商务产品页面所需的全套视觉资产（主产品照、详情页图像、社群媒体横幅、直播背景等）。它适用于 Claude Code、Codex 或 WorkBuddy 环境，并与 apiz 图像生成服务（或 Codex 内建的 imagegen 工具）对接。此技能可以：

产生视觉简报与现成的提示词供图像模型使用，或
直接呼叫图像模型并储存产生的图片。

关键概念

概念	含义
提示词 / 简报模式	技能会回传结构化的简报（目标、风格、转换驱动因素等）以及最终提示词与任何负面约束。除非您已安装 apiz CLI，否则不会产生图像。
生成模式	当您要求“渲染图像”时，技能会建立最终提示词，产生一个 Campaign Style Lock（一段强制色彩、灯光、字体、布局等在整组中保持一致的文字区块），然后呼叫 Codex `imagegen` 工具或执行使用 apiz CLI 的 `scripts/generate_image.py`。
Campaign Style Lock	一种可重复使用的风格描述，会被注入到每个图像提示词中，使整个组合看起来具有连贯性。
apiz CLI	一个第三方指令列客户端，用于上传参考图像、提交生成请求给 AI 图像模型（预设为 `apiz/gpt-image-2.5-flare`）、等待任务完成并下载结果。
图像包规则	预设情况下，该技能会输出完整的电子商务套件：5 张主产品照与 7‑9 张详情页图像，每张都有对应的提示词档案。

如何使用

安装 apiz CLI（如果您想要自动图像生成）：

apiz --version   # 验证安装
apiz auth login  # 储存您的 API 金钥

复制存储库并导航至根目录。
执行技能（通过您的 AI 助理环境）并要求简报或完整图像包。您可以向助理发送的范例提示词： “Generate a visual brief and prompt for a premium‑look Amazon main image of a self‑heating eye mask.” “Render the full image pack for a laundry pod product, using the configured API.”
如果您要求生成，技能将会：
- 建立最终提示词。
- 建立 Campaign Style Lock。
- 呼叫 imagegen (Codex) 或执行 python3 scripts/generate_image.py … (apiz)。
- 将图像储存在 generated-images/（或您指定的资料夹）下并回传档案路径。

指令列辅助工具 (`scripts/generate_image.py`)

选项	描述
`--prompt "…"`	直接在指令列输入提示词字串。
`--prompt-file FILE`	从文字档读取提示词。
`--output-dir DIR`	储存生成图片的位置（预设 `generated-images/`）。
`--size RATIO`	长宽比（`1:1`、`4:5`、`16:9` 等）– 也接受像素格式如 `1024x1024`。
`--model MODEL_ID`	要使用的图像模型（预设 `apiz/gpt-image-2.5-flare`）。
`--image PATH`	本地参考产品照片 – 将先上传至 apiz CDN。
`--image-url URL`	参考图像的公开 URL（优先于 `--image`）。
`--timeout SEC`	等待 apiz 任务的最长秒数（预设 420）。
`--format EXT`	储存图像的副档名（预设 `png`）。
`--env-file FILE`	从自订的 `.env` 档案载入环境变量。

典型呼叫：

python3 scripts/generate_image.py \
  --prompt-file prompt.txt \
  --size 4:5 \
  --model apiz/gpt-image-2.5-flare \
  --image data/product.jpg \
  --output-dir outputs

限制与安全注意事项

成本 – 每张图像会消耗 apiz 点数（每张约 30‑90 秒）。在大批处理前，请使用 apiz account balance 检查余额。
非同步生成 – CLI 会等待 (--wait) 任务完成，但底层 URL 是暂时的；指令码会将档案下载到本地。
无机密泄漏 – 存储库绝不储存 API 金钥；必须通过 apiz CLI 登入或环境变量提供。
内容政策 – 技能会增加负面约束（例如“无可读文字”），并警告您不要在视觉文案中捏造认证或测试结果。
模型依赖解析度 – 输出像素尺寸取决于所选模型（预设支援最高 4K）。

谁会觉得这很有用？

电子商务商家，需要快速为 Amazon、Shopify、TikTok Shop 等制作一致的产品图像套件。
营销团队，寻找 AI 生成的广告横幅、社群媒体图形或直播背景。
AI 助理机器人开发者，希望嵌入现成的图像生成技能，而无需编写自己的整合代码。

快速入门检查清单

安装 apiz CLI 并登入。
复制存储库。
在您的 AI 助理中，要求简报或完整图像包。
如果您要求生成，请在 generated-images/ 下找到档案。
审阅视觉简报，必要时调整提示词，并对产出的资产进行 A/B 测试。