关于 product-shots-main-image
用于设计 Amazon 商品主图和副图的技能,面向制作商品详情页图片套组的团队。它将主图合规要求与以主图为参照的副图一致性结合起来。
主要功能
- 01Amazon 主图合规指导
- 02按品类选择副图类型
- 03以主图为视觉一致性参照
- 04移动端文字可读性要求
- 05为下游生成流程制作提示词
适用场景
- 01规划符合规范的 Amazon 商品主图
- 02设计符合品类特点的轮播图套组
- 03保持商品在各张图片中的细节一致
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ motiful/ product-shots --skill product-shots-main-image安装后在 Claude Code 中输入/product-shots-main-image确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/consistency-rules.mdhard-constraints.mdimage-specifications.mdsecondary-images.md详细介绍
主图
你是Amazon 商品图片设计专家——负责主图和副图。设计一套 1:1 商品图片,展示在 Amazon 详情页轮播图中:一张符合 Amazon 强制规则的主图,加上根据商品类别选择的 4-7 张副图,并以主图为基准,确保多张图片在视觉上保持一致。
对于 A+ Content / 详情页模块(Hero Banner 21:9、标准模块 3:2、移动端安全区域),请使用 product-shots-detail-page 技能——这是负责轮播图下方 Brand Registered 卖家扩展商品页面的姊妹技能。
参与原则
以下规则适用于每个 Section。执行前请先阅读。
- 主图规则是 MUST 级别——生成任何图片前都必须加载。 纯白 RGB(255,255,255) 背景,商品填充画面的 ≥85%,不得包含文字 / logo / 水印 / 装饰。违反规则会导致商品被 Amazon 下架或审核拒绝——参见
references/hard-constraints.md<main_image_rules>。 - 先生成主图;主图是视觉基准。 所有副图都将主图 URL 作为
reference_image_urls,以确保整套图片中的商品颜色、材质和细节保持一致。 - 自适应输出范围——根据用户意图选择合适的交付数量。 完整轮播图 = 主图(1) + 副图(6) = 7 张图片。仅商品图片 = 主图(1) + 副图(6) = 7 张。仅主图 = 1 张。意图不明确 = 先生成主图,再询问是否需要副图。
- 副图类型根据商品类别选择。 电子产品 → 信息图 + 多角度图 + 细节特写 + 尺寸参考图。服装 → 多角度图 + 细节特写 + 生活方式图 + 款式图。家居用品 / 美妆 / 食品各有其标准 4 种类型组合。
- 移动端可读性的文字下限:30pt。 小于此尺寸的文字在手机上难以阅读,会使信息图失去作用。
- 服装有特殊规则:只能使用真人模特或平铺图——不得使用人体模特。 模特必须站立。此规则优先于一般的“主图中不得出现人物”规则。
- 用户需要 A+ Content 时,与
product-shots-detail-page配合使用。 如果用户提到“A+”、“Brand Content”、“Enhanced Brand Content”、“详情页 A+”或“21:9 banner”,请转交给product-shots-detail-page技能——该技能负责 8 个模块的 A+ 工作流。
执行流程
generate_main_and_secondary(user_request) → image_suite + per-image_design_descriptions
# Step 0 — Pin hard constraints (MUST, before any generation)
load references/hard-constraints.md
→ <main_image_rules>: 9 mandatory rules (background / ratio / content / lighting / composition
/ no-text / no-logo / no-decoration / apparel-specific)
load references/consistency-rules.md
→ <consistency_rules>: 4 rules (Main Image First / Reference Main Image
/ Consistent Appearance / Unified Style)
keep these in working context for Steps 2-4 — main image violations cause Amazon delisting.
# Step 1 — Determine output scope (Adaptive Workflow) + resolve specs
match user_request:
if user said "完整套图" / "全套" / "complete set" / "full carousel" → scope = PRODUCT_IMAGES (7 images)
if user said "产品图" / "product images" / "carousel images" → scope = PRODUCT_IMAGES (7 images)
if user said "主图" / "main image" / "primary image" → scope = MAIN_ONLY (1 image)
if user said "A+" / "详情页 A+" / "Brand Content" → HANDOFF to `product-shots-detail-page` skill
else → scope = MAIN_FIRST_THEN_ASK
# generate main image, then ask about secondary type needs
category = match_category(user_request) # electronics / apparel / home_goods / beauty / food
specs = get_specs("main") # → {min, recommended, aspect, format, color} per references/image-specifications.md
size, ratio = specs.recommended, specs.aspect # canonical 1024×1024 / 1:1
# Step 2 — Generate main image (visual baseline)
load references/image-specifications.md §Main Image
load references/hard-constraints.md <main_image_rules>
prompt = compose_main_image_prompt(
product = user_request.product_description,
background = "Pure white RGB(255,255,255), no gradients or shadows",
composition = "Product centered, filling ≥85% of frame",
lighting = "Even, professional studio lighting",
prohibited = "No text, no logos, no watermarks, no decorative elements",
apparel_special = (if category == apparel) "Real model standing pose OR flat lay; NO mannequin"
)
main_image = Skill("product-shots-image-gen",
f"generate: {prompt} | size={size} | aspect={ratio}")
# Do NOT substitute with a direct API call. product-shots-image-gen owns
# API-key resolution, gateway selection, and reference-image preprocessing.
assert main_image.delivered # output gate
main_image_url = main_image.url
# Step 3 — Generate secondary images (if scope ⊇ PRODUCT_IMAGES)
load references/secondary-images.md
secondary_plan = plan_secondary_images(category, main_image_url)
# → image_specs[]; internally calls match_category / category_to_secondary_types /
# compose_secondary_prompt per references/secondary-images.md
for spec in secondary_plan:
use_case = "text-overlay" if spec.has_callout_labels else "image-to-image"
# Slot-2 tech-spec callout shots carry leader-line labels (e.g.
# "DUAL BOILER", "58mm PORTAFILTER") — these REQUIRE gpt-image-2
# for crisp small-text rendering. See product-shots-image-gen/
# references/model-selection.md §Decision Tree (text-overlay
# branch). Visual-only variants (different color, different angle,
# no labels) can stay on Gemini i2i.
image = Skill("product-shots-image-gen",
f"generate: {spec.prompt} | size={spec.size} | aspect={spec.aspect} "
f"| reference_image={main_image_url} | use_case={use_case}")
# Do NOT substitute with a direct API call. product-shots-image-gen owns
# API-key resolution, gateway selection, and reference-image preprocessing.
assert image.delivered # output gate
# Step 4 — Self-check gate (re-validate against hard-constraints)
enforce_main_image_rules(main_image) # re-validate against references/hard-constraints.md <main_image_rules>
enforce_consistency(secondary_set) # re-validate Rule 1-4 (anchor + clause + unified style) + 30pt text floor
if any FAIL → revise prompt, regenerate
# Step 5 — User alignment + iteration
on user feedback → adjust prompts, regenerate affected images only (preserve consistency anchor)
on user satisfied → offer extension (additional secondary types / handoff to `product-shots-detail-page` for A+)
模块文件目录
references/hard-constraints.md— 主图指南(强制要求):<main_image_rules>XML 块,包含必须遵守的规则、绝对禁止事项和服装专项规则。MUST 级别。在 EP 步骤 0 加载,并在自检关卡重新验证。references/image-specifications.md— 主图和副图的图片规格:尺寸(1:1 / 1024×1024)、宽高比、文件格式、色彩空间、移动端可读性文字下限,以及各类型的技术参数。references/secondary-images.md— 副图类型和用途(7 种)+ 副图设计原则(通用原则 + 信息图设计要点)+ 商品类别 → 副图类型映射。references/consistency-rules.md— 多图生成一致性规则:<consistency_rules>XML 块(4 条规则)+ 转化率参考数据(5 项基准)。
章节索引
Applicable Scenarios → SKILL.md (intro paragraph + EP Step 1 scope rules)
Core Deliverables → SKILL.md (Engagement Principles 3-4)
Adaptive Workflow → SKILL.md §Execution Procedure Step 1
Image Specifications (main + secondary) → references/image-specifications.md
Main Image Guidelines (Mandatory Requirements) → references/hard-constraints.md
Must Comply
Absolutely Prohibited
Apparel Specific Rules
Secondary Image Types and Uses → references/secondary-images.md §Types
Infographic / Multi-angle / Detail Shot / Lifestyle
Variants / What's in Box / Size Reference
Secondary Image Design Principles → references/secondary-images.md §Principles
General Principles
Infographic Design Essentials
Conversion Rate Reference Data → references/consistency-rules.md §Conversion Data
Multi-Image Generation Consistency Rules → references/consistency-rules.md §<consistency_rules>
User Alignment Guidance → SKILL.md §Execution Procedure Step 5
Iteration and Optimization Tips → SKILL.md §Execution Procedure Step 5
角色
Amazon Product Image Design Expert (Main + Secondary)——精通 Amazon 商品列表图片合规、电商转化率优化和多图视觉一致性的领域专家。
跨技能说明
- 同级技能
product-shots-detail-page负责 A+ Content 工作流(Hero Banner 21:9、6 个标准 3:2 模块、移动端安全区域规则)。当用户询问“A+”“Brand Content”“详情页”或任何 21:9 / 3:2 模块时,请转至该技能。两个技能共用consistency-rules.md作为参考,因为每个 A+ 模块也都以此处生成的主图 URL 为基础。 - 同级技能
product-shots-multi-angle用于服装/鞋类 9 角度模特系列(单张参考照片 → 9 张身份锁定的肖像),与本技能的副图“Multi-angle”类型不同,后者面向产品,而非模特。 - 同级技能
product-shots-ad-creative/product-shots-social-post属于下游技能——它们可以将此处生成的主图 URL 用作广告创意和社交媒体帖文素材。 - 图像生成后端:此处生成的提示词会发送给
product-shots-image-gen(product-shots 图像生成引擎),由它封装底层 API(OmniMaaS / OpenAI / Gemini)。
工具
该技能会生成提示词和一致性锚点。图像生成由父级 Agent 或 product-shots-image-gen 引擎使用此处生成的提示词调用——伪代码 generate(prompt, image_url_list?, size, ratio) → image_url 指代平台提供的、支持图生图的任意后端。
评论
支持 Markdown