mcpField
P
product-photography

product-photography

github.com/sanky369クリエイティブ・メディア3193 回インストール16 週間前に更新
リポジトリ

product-photography について

商品説明を、統一感のあるショットリストと画像生成用プロンプト仕様に変換するクリエイティブスキルです。セット内のビジュアルを揃え、FAL の認証情報が設定されていれば生成コマンドも提示します。

主な機能

  1. 01商品画像のショット計画
  2. 02セット全体の照明と配色の統一
  3. 03ショット別プロンプトの作成
  4. 04ヒーロー画像とクリーンショットのバリエーション作成
  5. 05設定済みの場合の画像生成コマンド提示

活用シーン

  1. 01EC 商品一覧用の画像準備
  2. 02ランディングページ用商品画像セットの計画
  3. 03広告やソーシャル向け商品画像の統一

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/sanky369/vibe-building-skills --skill product-photography

インストール後、Claude Code で/product-photographyを入力して読み込まれたか確認します。

同梱ファイルreferences/shot-library.md

詳細

製品写真

製品の説明文から、コマース品質の製品画像を生成するプロンプト仕様の、一貫したショットリストを作成します。最重要ルール:1 製品、1 ビジュアルワールド。 セット内のすべてのショットはブランドのライティング、パレット、処理を共有し、リスティング、ランディングページ、ソーシャル投稿が 1 つのブランドとして読めるようにします。見事なヒーローショットの隣にミスマッチなライフスタイルショットが並ぶのは、平均的なマッチングショットが 2 つあるよりも悪いことです。

使うべきとき/使うべきでないとき

被写体が製品であるあらゆる画像に使用します:E コマースのリスティング、ランディングページのヒーロー、マーケティングショット、ディテールのクローズアップ。以下の場合は代わりに引き継ぎます:

  • そのアセットが、製品についてのプラットフォームサイズの投稿(テキストオーバーレイ、プロモレイアウト)である → skills/creative/social-graphics
  • ユーザーがロゴ/アイコン/パターンを必要としている → skills/creative/brand-asset
  • 製品の被写体がない一般的な画像である → skills/creative/image-generation
  • ビジュアルディレクションが存在せず、複数のアセットが予定されている → まず skills/creative/creative-strategist。ここでそのスタイルブロックを利用します
  • 製品が動くべきものである → skills/creative/product-video(このスキルによるスチルがそのソースフレームです)

ヒアリング

不足しているものだけを、一度にまとめて尋ねます:

  1. 製品 — 正確には何ですか? 素材、色、特徴的なディテール。 (実物の写真があれば、正確さのための参照として依頼します。)
  2. 配信先 — リスティング、ランディングページ、広告、ソーシャル?(ショットの種類とアスペクト比を決めます)
  3. ポジショニング — プレミアム/ラグジュアリー、親しみやすい、遊び心がある、テクニカル?
  4. スタイルの基準 — クリエイティブディレクションブリーフ/スタイルブロック、またはブランドカラー?
  5. 自動化 — FAL_API_KEY が設定済みか、それとも仕様のみを納品するか?

尋ねずに推測する:配信先からアスペクト比を(リスティング → 1:1、ランディングヒーロー → 16:9、ソーシャルフィード → 4:5);解像度はデフォルトで 2K、ヒーローは 4K。 止まらないこと: 製品 + 配信先が判明していれば、残りは仮定し、それを明示して、進めます。

ワークフロー

  1. ショットリストを構築します。 配信先 → ショットの種類をマッピングします(判断ルール):

    • E コマースリスティング → クリーンショット 1 点 + ディテールショット 1〜2 点(+プラットフォームがギャラリー画像を許可する場合はライフスタイル 1 点)
    • ランディングページ → ヒーローショット 1 点 + ライフスタイル 1 点 + ディテール 1 点
    • ソーシャル/広告 → ライフスタイル 1〜2 点 + フラットレイ 1 点(製品ファミリー)またはヒーロー
    • 「画像 1 枚だけ」→ 記載された用途に適した単一の種類を選び、その理由を述べます
  2. 共有の処理を固定します。 スタイルブロックからセット全体で 1 つのライティングスタイルとパレットを選びます(またはポジショニングから推測:プレミアム → ドラマチックまたはスタジオ;親しみやすい → 自然なゴールデンアワー;ミニマルなブランド → ハイキー)。セット内のすべての仕様がこれを使用します。

  3. ショットごとに 1 つのプロンプト仕様を書きます — references/shot-library.md のテンプレートを使用します。今すぐ読んでください。5 つのショットタイプのテンプレートに加えて、ライティング/背景/構図のプロンプト言語が載っています。色は言葉と 16 進数で指定します。必ず、表示してはならないもの(ウォーターマーク、正確なテキストが提供されていない限り捏造されたロゴやラベルテキスト、雑然とした要素は禁止)を明記します。

  4. バリアント。 ヒーローとクリーンショットには 3〜4 のバリアント(--num-images 3、または構図/背景を変えた別々の仕様);ディテールとライフスタイルショットには 2。ユーザーが採用作品を選びます。

  5. 生成または納品。 FAL_API_KEY(または FAL_KEY)が設定されている場合:

    python docs/creative_cli.py product \
      --product-name "Luxury Watch" \
      --prompt "<full prompt>" \
      --aspect-ratio 1:1 --resolution 2K --num-images 3
    

    画像は assets/product-photography/<product-slug>/ に <product>_<n>_<timestamp>.png として保存されます。キーがない場合は、仕様と正確なコマンドを納品します — 生成が行われたと決して主張しないでください。完全なパラメータリファレンス: skills/creative/image-generation/references/automation.md。

  6. 品質基準に照らしてレビューし、references/shot-library.md の修正用フレーズで不備を直し(反復は 1 ラウンド)、ファイルパスとスロットごとの 1 行の推奨を添えて採用作品を提示します。

必須の出力形式

次のブロックからなるショットリストを納品します(ショットごとに 1 つ):

## Shot Spec — [shot name, e.g. hero-01]
- **Shot type:** clean / lifestyle / hero / detail / flat lay
- **Destination:** [listing / landing hero / ad / social]
- **Subject:** [product, concretely — materials, colors, orientation]
- **Setting / background:** [white / gradient X→Y / lifestyle setting / textured]
- **Lighting:** [studio / natural golden hour / dramatic rim / high-key]
- **Composition:** [centered / rule of thirds / negative space / overhead]
- **Mood:** [2–3 adjectives, from the style block]
- **Aspect ratio:** [ratio] · **Resolution:** [1K/2K/4K] · **Format:** png
- **Negative constraints:** [no watermark, no invented label text, ...]
- **Prompt (final, paste-ready):**
  > [single flowing prompt]
- **Variants:** [n] — [what varies]
- **File naming:** assets/product-photography/<product-slug>/<product>_<n>_<timestamp>.png
- **Generate with:** `python docs/creative_cli.py product --product-name "..." --prompt "..." --aspect-ratio ... --resolution ... --num-images n`

最後にセット概要で締めくくります:共有のライティング/パレットの行、種類ごとのショット数、(生成した場合は)スロットごとの推奨採用作品と保存パス。

品質基準

  • セット内のすべてのショットが同一のライティングスタイルとパレットを共有している(セット全体が1つのブランドとして読める)
  • 各仕様がショットタイプ、背景、ライティング、構図、ムードを明示的に指定している
  • アスペクト比が、慣性で既定の 1:1 ではなく、配信先に一致している
  • 製品の詳細(素材、色)がユーザーの説明と一致している — 機能、刻印、ラベルテキストを捏造していない
  • すべての仕様にネガティブ制約が含まれている
  • ヒーロー/クリーンショットに3つ以上のバリエーションがある。単発のテイクで納品されたものはない
  • 実際の自動化パラメータのみを使用している(モデルは fal-ai/nano-banana-pro。size/steps/guidance ノブは存在しない)

厳守すべき禁止事項: ユーザーが正確な文字列を提供していない限り、読めるブランド/ラベルテキストを決してレンダリングしない。1つのセットにプレミアムでドラマチックなライティングとカジュアルなスナップショットスタイルを決して混在させない。AIショットをユーザーの実機の実写真として決して提示しない — 正確な物理的製品への忠実性が重要な場合は、その旨を伝え、コンポジットまたは参照写真ワークフローを推奨する。

連携

  • skills/creative/creative-strategist → 上流。そのスタイルブロックがこのセットのライティング、パレット、ムードのフィールドを設定します。
  • skills/creative/image-generation → 共有される自動化とプロンプトの規律。skills/creative/image-generation/references/automation.md がパラメータの信頼できる情報源です。
  • skills/creative/social-graphics → 選ばれたショットをプラットフォーム投稿の素材として消費します。
  • skills/creative/product-video → ヒーロー/ライフスタイルのスチルをフレームとアートディレクションとして消費します。
  • references/shot-library.md — ショットタイプの完全なテンプレート、ライティング/背景/構図のプロンプト言語、修正フレーズ。仕様を書く前に読んでください。

コメント