sanky369/product-photography

プロダクトフォトグラフィ

商品説明を、コマースグレードの商品画像を生成するための一貫性のあるショットリストとプロンプト仕様に変換します。最重要ルール: 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 "高級腕時計" \
     --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ブロック）:

## ショット仕様 — [ショット名、例: hero-01]
- **ショットタイプ:** クリーン / ライフスタイル / ヒーロー / ディテール / フラットレイ
- **仕向け先:** [リスト / ランディングヒーロー / 広告 / ソーシャル]
- **被写体:** [商品、具体的に — 素材、色、向き]
- **設定 / 背景:** [白 / グラデーション X→Y / ライフスタイル設定 / テクスチャ]
- **ライティング:** [スタジオ / 自然なゴールデンアワー / ドラマチックリム / ハイキー]
- **構図:** [中央 / 三分割法 / ネガティブスペース / 真上]
- **ムード:** [2–3の形容詞、スタイルブロックから]
- **アスペクト比:** [比率] · **解像度:** [1K/2K/4K] · **フォーマット:** png
- **ネガティブ制約:** [透かしなし、発明されたラベルテキストなし、...]
- **プロンプト（最終、貼り付け準備完了）:**
  > [単一の流れるプロンプト]
- **バリエーション:** [n] — [何が変わるか]
- **ファイル命名:** assets/product-photography/<product-slug>/<product>_<n>_<timestamp>.png
- **生成コマンド:** `python docs/creative_cli.py product --product-name "..." --prompt "..." --aspect-ratio ... --resolution ... --num-images n`

セット概要で閉じます: 共有ライティング/パレット行、タイプ別ショット数、および（生成された場合）スロットごとに推奨される勝者と保存パス。

品質基準

• セット内のすべてのショットが1つのライティングスタイルとパレットを共有している（セットが1つのブランドとして読まれる）
• 各仕様がショットタイプ、背景、ライティング、構図、ムードを明示的に指定している
• アスペクト比が仕向け先に一致しており、惰性で 1:1 デフォルトになっていない
• 商品の詳細（素材、色）がユーザーの説明と一致している — 発明された機能、彫刻、ラベルテキストがない
• すべての仕様にネガティブ制約が存在する
• ヒーロー/クリーンショットには3つ以上のバリエーションがある。単一テイクで出荷されていない
• 実際の自動化パラメータのみが使用されている（モデルは fal-ai/nano-banana-pro; サイズ/ステップ/ガイダンスノブは存在しない）

厳禁: ユーザーが正確な文字列を提供していない限り、読み取り可能なブランド/ラベルテキストをレンダリングしない。プレミアムドラマチックライティングとカジュアルなスナップショットスタイルを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 — 完全なショットタイプテンプレート、ライティング/背景/構図プロンプト言語、修正フレーズ。仕様を書く前に読んでください。