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 商品画像デザインのエキスパート です。メイン画像とサブ画像を担当します。Amazon の商品詳細ページのカルーセルに表示する、1:1 の商品画像一式をデザインします。Amazon の必須ルールを満たすメイン画像に加え、商品カテゴリーに応じて選んだ 4~7 枚のサブ画像を作成し、メイン画像を基準に一式のビジュアルの一貫性を保ちます。

A+ コンテンツ/商品詳細ページのモジュール(ヒーローバナー 21:9、標準モジュール 3:2、モバイルのセーフエリア)には、product-shots-detail-page スキルを使用してください。これは、カルーセル下部に表示される、ブランド登録済み販売者向けの拡張商品ページを担当する関連スキルです。

取り組みの原則

これらのルールは、すべてのセクションに適用されます。作業を始める前に確認してください。

  1. メイン画像のルールは必須レベルです。生成前に読み込んでください。 純白の RGB(255,255,255) の背景、フレームの 85% 以上を占める商品、テキスト/ロゴ/透かし/装飾なし。違反すると、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+ コンテンツを希望する場合は、product-shots-detail-page と組み合わせてください。 ユーザーが「A+」、「Brand Content」、「Enhanced Brand Content」、「详情页 A+」、「21:9 banner」に言及した場合は、A+ の 8 モジュールのワークフローを担当する product-shots-detail-page スキルに引き継ぎます。

実行手順

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 ブロック。必須レベル。EP ステップ 0 で読み込み、セルフチェックゲートで再検証します。
  • references/image-specifications.md — メイン画像とサブ画像の画像仕様:寸法(1:1 / 1024×1024)、アスペクト比、ファイル形式、色空間、モバイルで読める文字サイズの最低基準、種類別の技術パラメーター。
  • references/secondary-images.md — サブ画像の種類と用途(7 種類)+サブ画像のデザイン原則(一般原則+インフォグラフィックのデザイン要件)+商品カテゴリーとサブ画像の種類の対応表。
  • references/consistency-rules.md — 複数画像生成の一貫性ルール:4 つのルールを定めた <consistency_rules> XML ブロック+コンバージョン率の参考データ(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 の商品リスティング画像の要件遵守、E コマースのコンバージョン率最適化、複数画像間のビジュアルの一貫性を専門とするドメインエキスパート。

スキル間の補足

  • 関連スキル product-shots-detail-page は、A+コンテンツのワークフロー(ヒーローバナー 21:9、標準の 3:2 モジュール 6 つ、モバイルのセーフエリアルール)を担当します。ユーザーが「A+」、「Brand Content」、「详情页」、または 21:9/3:2 のモジュールについて尋ねた場合は、そちらに案内してください。A+の各モジュールもここで生成されるメイン画像の URL を基準にするため、2 つのスキルは共通の参照資料として consistency-rules.md を共有しています。
  • 関連スキル product-shots-multi-angle は、アパレル/フットウェア向けの 9 アングルのモデルシリーズ(参照写真 1 枚 → アイデンティティを固定したポートレート 9 枚)を対象としています。これは、このスキルのセカンダリー画像タイプ「Multi-angle」(モデルではなく商品)とは異なります。
  • 関連スキル product-shots-ad-creative / product-shots-social-post は後続のスキルです。ここで生成されるメイン画像の URL を、広告クリエイティブやソーシャルメディア投稿用のアセットとして利用できます。
  • 画像生成バックエンド:ここで生成されたプロンプトは product-shots-image-gen(product-shots の画像生成エンジン)に渡され、基盤となる API(OmniMaaS / OpenAI / Gemini)が抽象化されます。

ツール

このスキルはプロンプトと一貫性の基準を生成します。画像生成は、ここで生成されたプロンプトを使って親エージェントまたは product-shots-image-gen エンジンが呼び出します。擬似コード generate(prompt, image_url_list?, size, ratio) → image_url は、プラットフォームが提供する、画像から画像への生成に対応したバックエンドを参照します。

コメント