- name
SKILL.md
The skill file stays in the publisher's repository.
Paste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add liangdabiao/ecom-details-image -a cursor -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add liangdabiao/ecom-details-image -a claude-code -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add liangdabiao/ecom-details-image -a codex -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add liangdabiao/ecom-details-image -a grok -ySend the copied message in a Grok Bot chat. The Bot fetches this SKILL.md from GitHub and adds it to the skills all your Bots share.
Install this skill: https://github.com/liangdabiao/ecom-details-imageFrom the publisher
当用户需要视觉策略、图片 Prompt、商品主图、营销图、社媒图、广告图、电商 PDP 视觉,或要求直接 AI 生图时,使用这个 Skill。
这个 Skill 有两种模式:
不要暴露、索要、写入、提交或回显真实 API key。使用者必须通过自己的环境变量配置 API。
直接生图前必须先判断当前运行环境,选择对应通道:
判断方法:检查你自己(agent)当前会话中是否具备内置的 imagegen 工具。有,说明你在 Codex 环境。
执行方式:
scripts/generate_image.py,直接调用内置 imagegen 工具。prompt 传入;工具如支持比例/尺寸参数,传入对应比例。generated-images/<产品slug>/ 目录,与本 Skill 的输出习惯保持一致。claude code / OpenClaw 等其他环境使用 scripts/generate_image.py,默认(--channel auto)优先走即梦通道:脚本转交 scripts/generate_image_dreamina.py,内部调用 dreamina-canvas CLI 在即梦画布内生成,默认模型 Seedream 5.5。
前置条件(本机通常已就绪):
dreamina-canvas --version 可执行)。dreamina-canvas auth login 完成 OAuth。认证完全由 CLI 处理,脚本不接触密钥。可选配置(通过 .env 或环境变量,全部可省略):
DREAMINA_IMAGE_MODEL=seedream_5.5
# DREAMINA_CANVAS_ID=<画布UUID> # 不设置时用当前画布或自动创建 ecom-details-image 画布
DREAMINA_RESOLUTION=2K
DREAMINA_CREDIT_CEILING=10
# DREAMINA_BIN=C:\path\to\dreamina-canvas.exe
能力要点:
dreamina-canvas model list --type image 实时查询;Seedream 5.5 支持文生图/图生图、1:1/3:4/4:3/16:9/9:16/2:3/3:2/21:9、1.5K/2K、单节点 1-8 张、参考图最多 10 张、Prompt 上限 5000 字符。4:5 脚本会自动换算到最接近的支持比例(3:4)并说明。--image 传入(最多 10 张),产品一致性显著更好。dreamina-canvas auth account 查余额)。批量出图前先报预计积分消耗并经用户确认。dreamina-canvas auth login 指引。即梦 CLI 不可用,或显式 --channel apiz / ECOM_IMAGE_CHANNEL=apiz 时,脚本内部调用 apiz CLI(https://apiz.ai)提交生成任务并下载结果,不再直连任何 HTTP API。
前置条件(本机通常已就绪):
apiz --version 可执行)。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 直接传入。
注意:生图会消耗 apiz 账户积分(apiz account balance 查看)。批量出图前先把 Image Pack Plan 报给用户确认。
如果 apiz CLI 未安装或未登录,不要阻塞:返回完整 Prompt 包,并给出安装/登录指引(apiz auth login),方便用户稍后自行运行。
references/templates/ 匹配对应模板,读取 prompt_template、variants、category_tips 作为 Prompt 基础结构。scripts/generate_image.py(默认即梦 Seedream 5.5,回退 apiz)。用户提供了参考产品图时,Codex 传给 imagegen,脚本通道传 --image(即梦支持多张 --image 重复传入)。任何视觉任务都优先确认这些信息:
如果缺少非关键字段,明确假设后继续,不要无谓阻塞。
默认用英文写 Prompt,除非用户要求其他语言。
Prompt 按这个结构组织:
Prompt 要足够具体,可以直接执行;也不要过度规定无关细节,避免和用户目标冲突。
以下规则来自大量实战验证,每条 Prompt 都必须逐条检查。
"白底"出来是淡灰,"金色"出来有 8 种金。必须写 hex:
#FFFFFF#2D2D2D#D4AF37#F5F1E8#1A3A2E不同图型的产品占比黄金区间:
不写留白,AI 一定把画面填满。每张图必须写:
留白至少 45%留白至少 50%留白 50%+每条 Prompt 结尾必须加负面约束,写具体禁止项而不是笼统的"不要多余的":
不要添加:道具、手、水印、假 logo、额外文字、装饰元素、渐变背景
国内电商主图必须预留:
顶部中央 200×100 区域留空(平台价格叠加区) — 不写产品会把整个画面填满左上角 200×100 像素区域完全留白 — logo 区域(如需要)电商图内文字必须遵循:
一次批量出图,让 CTR 数据选风格,不要凭审美反复调参。
GPT-Image-2 在结构清晰、信息具体的 Prompt 下表现最佳。
色温 5500K)。--image 比文字描述更有效。references/templates/ 目录包含 25 个场景模板,每个模板提供 prompt_template、variants(风格变体)、category_tips(品类建议)、examples 和 anti_ai_tips。
无匹配 → 默认 01-hero-image.json。只读取匹配到的模板文件,不要一次性加载全部。
prompt_template 作为 Prompt 基础结构。{variables}。variants.<name>.overrides。category_tips.<category>。每个模板通常包含 3-4 个风格变体,常用变体类型:
生成 UGC、直播或社媒内容时,必须遵循以下规则让图片看起来真实:
iPhone 14 Pro、iPhone 15 Pro。NOT professional photography、NOT AI-generated look。Kodak Portra 400 color feel。NOT retouched, NOT smoothed。perfect、flawless、stunning、hyper-realistic。anti_ai_tips 字段,生成对应场景时必须遵循。当生成主图 + 详情页、PDP 图片包、广告组图、社媒组图或任何多张图片时,必须先定义一个 Campaign Style Lock。这是整套图的视觉合同,不是灵感描述。
如果用户没有给品牌规范,使用保守统一的电商视觉系统:
Campaign Style Lock: consistent premium ecommerce visual system across the entire image set; fixed palette of clean off-white background, deep charcoal text, one product-matched accent color, and one soft secondary accent; neutral-cool studio lighting; modern geometric sans-serif headline placeholders only; consistent rounded rectangular info labels; consistent thin-line icon style; clean high-end product photography mixed with minimal infographic elements; stable product scale and placement; generous whitespace; no color palette changes, no mixed fonts, no random backgrounds, no inconsistent lighting, no mismatched icon styles.
商品主图、电商图片、广告图和 PDP 视觉不要从固定模板开始,要先判断转化驱动力。
选择一个主要驱动力:
适用于购买决策依赖外观、风格匹配、光洁度、质感、前后对比或礼品属性的产品。
重点:
适用于买家有明确摩擦、风险、时间损失、不适或反复烦恼的产品。
强制顺序:
重点是具体问题、缓解机制、证据和风险逆转。
适用于购买和身份、信心、归属、地位、关怀、快乐、新奇或冲动相关的产品。
重点:
当用户提到“详情页、PDP、Amazon A+、Shopify 商品页、主图堆栈、整套商品图、商品详情图片”时,不要只停留在 5 张主图。必须追加详情页图片序列,并把每一屏都写成可单独生图的 Prompt。
详情页图片用于移动端纵向浏览,默认每张图独立成屏,尺寸优先使用 2:3 或平台指定竖版比例。除非用户明确只要文案,否则每个模块都要输出对应图片 Prompt。
#2D2D2D,浅灰标注 #888888,金色强调 #D4AF37。连续多张图的背景色不能完全一样,否则消费者视觉疲劳。多图任务必须交替使用 2-3 种背景色:
#FFFFFF#F5F1E8(浅米色)#1A3A2E)全套图片绝不能全部使用同一个拍摄角度。 AI 生图默认倾向生成正面 3/4 角度,如果不显式指定镜头角度,整套图会看起来千篇一律。多图任务必须在 Prompt 中为每张图分配不同的镜头角度和景别。
side profile、from above、low angle),不要假设模型会自动变换角度。在每张图片 Prompt 的「构图、镜头和取景」段落中,直接嵌入角度描述:
# 俯视图
Bird's eye top-down view. The [product] photographed directly from above at a 90-degree overhead angle, showing the full layout [specific details visible from above]. Deep even lighting from directly above minimizing shadows.
# 侧视图
Side profile view. The [product] photographed from a clean 90-degree side profile, showing [what's visible from side]. Strong side lighting from the left creating dramatic depth.
# 仰视图
Dramatic low-angle hero shot. The [product] photographed from a very low angle looking upward, making [tower/building] appear tall and imposing. Strong upward lighting creating heroic dramatic shadows.
# 微距特写
Extreme close-up macro shot. Tight zoom on the [specific detail], showing [texture/mechanism/individual elements]. Shallow depth of field with the foreground in sharp focus and background slightly blurred. Warm directional side lighting highlighting surface texture.
# 后侧角度
Rear angled view. The [product] photographed from behind at a 45-degree rear angle, revealing [back details not visible from front]. This angle shows construction details not visible from the front.
详情页图片 ≠ 多角度产品照片。 详情页图片必须是电商信息图格式,包含卖点文案、图标、标签、对比、步骤、信任徽章等信息图元素,产品在不同信息图中展示不同角度。多角度是为信息图服务的展示手段,不是目的。
# 错误:这只是"同一产品换个角度拍",缺少电商转化元素
Prompt: Side profile view of the product on white background. Product occupies 38%. Whitespace 50%+.
# 正确:有标题、卖点图标、标签、信息图布局,产品在其中展示特定角度
E-commerce infographic benefits screen on #FAF7F2 background.
Top headline in #2D2D2D at 28pt reading 「Core Benefits」.
Left side: the product shown from an elevated overhead angle.
Right side: four benefit rows stacked vertically with thin-line icons:
(1) icon + 「Feature One」 in #7A9E7E
(2) icon + 「Feature Two」 in #8B6F47
(3) icon + 「Feature Three」 in #7A9E7E
(4) icon + 「Feature Four」 in #8B6F47
Clean two-column layout. Product occupies 35%. Whitespace 48%+.
e-commerce infographic, structured grid layout, two-column layout, three-row layout, timeline, comparison layoutheadline in #2D2D2D at 28pt reading 「...」, label in #7A9E7E at 14pt reading 「...」feature callout icons, thin connecting lines, numbered circles, trust badges, CTA button placeholderE-commerce infographic [screen type] 开头,而不是 Close-up shot 或 Side view当用户要求直接生成整套电商图片:
1:1;详情页图片默认 2:3,适合移动端纵向浏览。generated-images/laundry-detergent-pods-pdp/。当用户要求生成图片:
scripts/generate_image.py(默认走即梦 Seedream 5.5,回退 apiz)。--prompt,长 Prompt 用 --prompt-file。--size(比例格式),没有要求时默认 1:1。--output-dir,否则使用 generated-images/。apiz account balance),经用户确认再执行。命令形状(非 Codex 环境):
python3 scripts/generate_image.py --prompt "..." --size 1:1
脚本支持(即梦 / apiz 通用):
--channel:auto / dreamina / apiz,默认 auto(优先即梦,回退 apiz;可用 ECOM_IMAGE_CHANNEL 覆盖)--prompt / --prompt-file--output-dir--size:比例格式(1:1、16:9、2:3 等,兼容 1024x1024 像素写法;即梦不支持的比例自动换算)--model:即梦默认 seedream_5.5,apiz 默认 apiz/gpt-image-2.5-flare--image:本地参考产品图片路径(即梦可重复传入最多 10 张);apiz 另支持 --image-url--timeout:单任务等待上限秒数,默认即梦 600 / apiz 420--format:保存格式的默认扩展名,默认 png--count(单节点 1-8 张)、--resolution(1.5K/2K)、--canvas-id、--credit-ceiling最终输出前确认:
prompt_template 组装。anti_ai_tips 字段)。scripts/generate_image.py(默认即梦,回退 apiz)。--image / --image-url 参数。E-commerce infographic 开头。Brief / Prompt 模式返回:
商品或营销任务追加:
Generate 模式返回:
Create visual concepts, image-generation prompts, and optional AI-generated images for product hero images, marketing creatives, social posts, ads, ecommerce PDP visuals, and general visual design tas
---name: ecom-details-imagedescription: Create visual concepts, image-generation prompts, and optional AI-generated images for product hero images…---# SKILL.mdOverview
Create visual concepts, image-generation prompts, and optional AI-generated images for product hero images, marketing creatives, social posts, ads, ecommerce PDP visuals, and general visual design tasks. Use when the user asks for visual strategy, image prompt writing, product/marketing image direction, or direct text-to-image generation. In Codex environments use the built-in imagegen tool; elsewhere use the bundled script, which prefers the dreamina-canvas CLI (Seedream 5.5) and falls back to the apiz CLI.
FAQ
Download SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
The publisher keeps it at https://github.com/liangdabiao/ecom-details-image.
Claude, Cursor, Codex, and Grok Build can read a SKILL.md you add from the publisher's repository. Grok Bot installs it when you send the skill's GitHub folder link in a chat.
| 运动, 健身, sports, fitness |
25-sports-campaign.json |