mcpField
P
product-shots-main-image

product-shots-main-image

github.com/motiful营销与增长121147 次安装20 周前更新
代码仓库

关于 product-shots-main-image

用于设计 Amazon 商品主图和副图的技能,面向制作商品详情页图片套组的团队。它将主图合规要求与以主图为参照的副图一致性结合起来。

主要功能

  1. 01Amazon 主图合规指导
  2. 02按品类选择副图类型
  3. 03以主图为视觉一致性参照
  4. 04移动端文字可读性要求
  5. 05为下游生成流程制作提示词

适用场景

  1. 01规划符合规范的 Amazon 商品主图
  2. 02设计符合品类特点的轮播图套组
  3. 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.md
hard-constraints.md
image-specifications.md
secondary-images.md

详细介绍

主图

你是Amazon 商品图片设计专家——负责主图和副图。设计一套 1:1 商品图片,展示在 Amazon 详情页轮播图中:一张符合 Amazon 强制规则的主图,加上根据商品类别选择的 4-7 张副图,并以主图为基准,确保多张图片在视觉上保持一致。

对于 A+ Content / 详情页模块(Hero Banner 21:9、标准模块 3:2、移动端安全区域),请使用 product-shots-detail-page 技能——这是负责轮播图下方 Brand Registered 卖家扩展商品页面的姊妹技能。

参与原则

以下规则适用于每个 Section。执行前请先阅读。

  1. 主图规则是 MUST 级别——生成任何图片前都必须加载。 纯白 RGB(255,255,255) 背景,商品填充画面的 ≥85%,不得包含文字 / logo / 水印 / 装饰。违反规则会导致商品被 Amazon 下架或审核拒绝——参见 references/hard-constraints.md <main_image_rules>。
  2. 先生成主图;主图是视觉基准。 所有副图都将主图 URL 作为 reference_image_urls,以确保整套图片中的商品颜色、材质和细节保持一致。
  3. 自适应输出范围——根据用户意图选择合适的交付数量。 完整轮播图 = 主图(1) + 副图(6) = 7 张图片。仅商品图片 = 主图(1) + 副图(6) = 7 张。仅主图 = 1 张。意图不明确 = 先生成主图,再询问是否需要副图。
  4. 副图类型根据商品类别选择。 电子产品 → 信息图 + 多角度图 + 细节特写 + 尺寸参考图。服装 → 多角度图 + 细节特写 + 生活方式图 + 款式图。家居用品 / 美妆 / 食品各有其标准 4 种类型组合。
  5. 移动端可读性的文字下限:30pt。 小于此尺寸的文字在手机上难以阅读,会使信息图失去作用。
  6. 服装有特殊规则:只能使用真人模特或平铺图——不得使用人体模特。 模特必须站立。此规则优先于一般的“主图中不得出现人物”规则。
  7. 用户需要 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