ecom-details-image

ecom-details-image Skill

当用户需要视觉策略、图片 Prompt、商品主图、营销图、社媒图、广告图、电商 PDP 视觉，或要求直接 AI 生图时，使用这个 Skill。

这个 Skill 有两种模式：

1. Brief / Prompt 模式：只输出视觉简报和可执行图片 Prompt。
2. Generate 模式：当用户明确要求“生图、生成图片、出图、render image”时，先输出最终 Prompt，再按下方生图通道判断选择生成方式。

不要暴露、索要、写入、提交或回显真实 API key。使用者必须通过自己的环境变量配置 API。

---

生图通道判断（Generate 模式必读）

直接生图前必须先判断当前运行环境，选择对应通道：

通道 A：Codex 环境 → agent 内置 imagegen

判断方法：检查你自己（agent）当前会话中是否具备内置的 imagegen 工具。有，说明你在 Codex 环境。

执行方式：

1. 不要调用 scripts/generate_image.py，直接调用内置 imagegen 工具。
2. 把最终 Prompt（含 Campaign Style Lock）作为 prompt 传入；工具如支持比例/尺寸参数，传入对应比例。
3. 如果用户提供了参考产品图，按 imagegen 工具的参考图/编辑参数传入。
4. 把返回的图片文件记录为 Generated Files；建议将文件移动或复制到 generated-images/<产品slug>/ 目录，与本 Skill 的输出习惯保持一致。
5. imagegen 不可用或调用失败时，回退到通道 B。

通道 B：非 Codex 环境 → apiz CLI 脚本

claude code / OpenClaw 等其他环境使用 scripts/generate_image.py，脚本内部调用 apiz CLI（https://apiz.ai）提交生成任务并下载结果，不再直连任何 HTTP API。

前置条件（本机通常已就绪）：

1. 已安装 apiz CLI（apiz --version 可执行）。
2. 已登录：apiz auth login 保存过 API key，或设置了 APIZ_API_KEY 环境变量。认证完全由 CLI 处理，脚本不接触密钥。

可选配置（通过 .env 或环境变量，全部可省略）：

APIZ_IMAGE_MODEL=apiz/gpt-image-2.5-flare
# APIZ_API_KEY=sk-xxx        # 仅未使用 apiz auth login 时需要
# APIZ_BASE_URL=https://api.apiz.ai
# APIZ_BIN=C:\path\to\apiz.exe

• APIZ_IMAGE_MODEL：apiz 图片模型 id，默认 apiz/gpt-image-2.5-flare（GPT Image 2.5，支持参考图编辑、10 种比例、1K/2K/4K）。兼容旧别名 IMG_MODEL、OPENAI_IMAGE_MODEL、OPENAI_MODEL。
• 其他可用模型用 apiz models list 查看（category=image），如 fal-ai/nano-banana-pro、apiz/gpt-image-2.5-sunburst。
• 旧变量 IMG_API_KEY、IMG_BASE_URL 仍被兼容读取。

生图脚本：

python3 scripts/generate_image.py --prompt "clean product hero image..." --size 1:1
python3 scripts/generate_image.py --prompt-file prompt.txt --output-dir outputs
python3 scripts/generate_image.py --env-file .env --prompt-file prompt.txt

参考图片：如果用户提供了本地产品照片路径，使用 --image 参数传入；脚本会先 apiz upload 上传到 apiz CDN 换取公网 URL，再走图生图，这对保证产品外观准确非常有效。已有公网 URL 时用 --image-url 直接传入。

注意：生图会消耗 apiz 账户积分（apiz account balance 查看）。批量出图前先把 Image Pack Plan 报给用户确认。

如果 apiz CLI 未安装或未登录，不要阻塞：返回完整 Prompt 包，并给出安装/登录指引（apiz auth login），方便用户稍后自行运行。

---

核心流程

1. 判断视觉任务类型和场景（见下方场景模板系统）。
2. 从 references/templates/ 匹配对应模板，读取 prompt_template、variants、category_tips 作为 Prompt 基础结构。
3. 只收集会实质影响图片结果的缺失信息。
4. 构建视觉简报。
5. 如果任务包含多张图，先建立 Campaign Style Lock，锁定整套图的色板、冷暖调、字体、背景、光线、布局和图标风格。
6. 写出可执行图片 Prompt（保持简洁，见下方 Prompt 精简原则）；多图任务必须把同一段 Campaign Style Lock 原样放进每张 Prompt。
7. 如果任务是商品图、详情页图或营销图，先做转化驱动力诊断。
8. 如果用户要求电商详情页、PDP、主图堆栈或整套商品图，默认输出 5 张主图 + 7-9 张详情页图片 的图片包。
9. 如果用户要求直接出图，按生图通道判断执行：Codex 环境用内置 imagegen；其他环境调用 scripts/generate_image.py（apiz CLI）。用户提供了参考产品图时，Codex 传给 imagegen，脚本通道传 --image。
10. 返回 Prompt、生成文件路径和关键假设。

---

最小输入

任何视觉任务都优先确认这些信息：

• 目标：图片要达成什么效果。
• 用途：商品主图、广告图、社媒图、Banner、PDP 模块、缩略图、概念图等。
• 主体：产品、人物、场景、物体或抽象概念。
• 受众和使用语境。
• 风格：真实摄影、编辑部风格、高级棚拍、UGC、3D 渲染、插画等。
• 构图、比例、平台尺寸。
• 是否需要图片内文字。
• 负面约束：避免 logo、避免文字、避免杂乱、避免医疗承诺等。

如果缺少非关键字段，明确假设后继续，不要无谓阻塞。

---

通用图片 Prompt 结构

默认用英文写 Prompt，除非用户要求其他语言。

Prompt 按这个结构组织：

1. Campaign Style Lock，多图任务必填且每张图完全一致。
2. 主体和场景。
3. 图片目的和情绪意图。
4. 构图、镜头和取景。
5. 光线、颜色、材质和纹理。
6. 风格和真实感等级。
7. 平台限制和画幅比例。
8. 图片内文字处理。
9. 负面约束。

Prompt 要足够具体，可以直接执行；也不要过度规定无关细节，避免和用户目标冲突。

---

GPT-Image-2 Prompt 铁律（必须遵守）

以下规则来自大量实战验证，每条 Prompt 都必须逐条检查。

1. 颜色用 hex 码，不用形容词

"白底"出来是淡灰，"金色"出来有 8 种金。必须写 hex：

• 白底 → #FFFFFF
• 深灰文字 → #2D2D2D
• 金色强调 → #D4AF37
• 浅米色背景 → #F5F1E8
• 深绿背景 → #1A3A2E

2. 产品占比必须数字化

不同图型的产品占比黄金区间：

图型	产品占比	说明
白底主图	35-40%	太小显廉价，太大显拥挤
卖点副图	25-30%	左图右文布局，产品在左
场景氛围图	20-25%	场景图不是产品图，氛围才是主角
信息流广告	40%	环境干扰多，产品要更突出
搜索广告	45%	搜索图比信息流再大一点
SKU 多规格卡	60-70%（整体）	多个产品横排

3. 留白必须显式声明

不写留白，AI 一定把画面填满。每张图必须写：

• 白底主图 / 卖点副图 / 广告图：留白至少 45%
• 场景氛围图：留白至少 50%
• 详情页长图：留白 50%+

4. 否定清单不能省

每条 Prompt 结尾必须加负面约束，写具体禁止项而不是笼统的"不要多余的"：

不要添加：道具、手、水印、假 logo、额外文字、装饰元素、渐变背景

5. 平台预留空间

国内电商主图必须预留：

• 顶部中央 200×100 区域留空（平台价格叠加区） — 不写产品会把整个画面填满
• 左上角 200×100 像素区域完全留白 — logo 区域（如需要）

6. 3 层信息架构

电商图内文字必须遵循：

• 核心承诺 ≤15 字（主标题）
• 关键证据 2-3 个（图标 + 短标签）
• 行动指令 ≤8 字（CTA 按钮）

7. 批量出图优于反复调参

一次批量出图，让 CTR 数据选风格，不要凭审美反复调参。

---

プロンプトを簡潔にする原則

GPT-Image-2 は、構造が明確で具体的な情報を含むプロンプトで最も優れた性能を発揮します。

• 核心となる情報だけを含め、冗長な制約や重複した説明を取り除きます。
• キーワードを羅列するより、自然な言葉で表現します。
• 素材の質感を明確に説明します（すりガラス、ヘアライン加工の金属、マット仕上げ、シルクの光沢）。
• 光の方向と質を必ず含め、シーン画像では色温度を指定します（例：色温 5500K）。
• 1 つのプロンプトに、シーン、スタイル、雰囲気に関する要件を詰め込みすぎないでください。
• ユーザーが商品の参考画像を提供した場合は、文字による説明より --image に渡すほうが効果的です。
• 中国語の文字は「」で囲むと、英語の引用符を使う場合や引用符なしの場合より、レンダリング精度が明らかに高くなります。
• 複雑な画数の中国語の文字（赢、鬱、餮など）は、できるだけ簡単な同義語に置き換えます。精度 95% は 100% ではありません。

---

シーンテンプレートシステム

references/templates/ ディレクトリには 25 個のシーンテンプレートがあり、それぞれに prompt_template、variants（スタイルバリエーション）、category_tips（カテゴリー別のヒント）、examples、anti_ai_tips が含まれています。

テンプレート照合表

トリガーワード	テンプレートファイル
白背景画像、メイン画像、hero image、packshot	01-hero-image.json
シーン画像、ライフスタイル画像、lifestyle	02-lifestyle-scene.json
俯瞰画像、flat lay、俯瞰撮影	03-flat-lay.json
ディテール画像、マクロ、macro、クローズアップ	04-detail-macro.json
ポスター、poster、banner、プロモーション	05-poster-banner.json
ソーシャルメディア、小紅書、Instagram、TikTok	06-social-media.json
UGC、購入者レビュー、GRWM	07-ugc-style.json
モデル、model、人物紹介	08-model-showcase.json
比較、before after、前後	09-before-after.json
パッケージ、packaging、ギフトボックス	10-packaging.json
インフォグラフィック、A+、商品詳細ページ	11-infographic.json
クリエイティブ、コンセプト、creative	12-creative-concept.json
サイズ、仕様、使用手順	13-size-spec.json
セット、組み合わせ、bundle	14-multi-product.json
ライブ配信、livestream	15-livestream.json
試着、取り込み、try on	16-try-on-virtual.json
分解図、爆発図、exploded view	17-exploded-view.json
ゴーストマネキン、ghost mannequin、3D衣類	18-ghost-mannequin.json
マルチアングル、グリッド、grid、複数色の紹介	19-multi-angle-grid.json
雑誌、表紙、editorial、magazine	20-magazine-editorial.json
季節、四季、campaign、春夏秋冬	21-seasonal-campaign.json
ラグジュアリー、雰囲気、煙、luxury、atmospheric	22-luxury-atmospherics.json
デバイスモックアップ、インターフェース、mockup、SaaS、APP	23-device-mockup.json
店舗、店構え、空間、storefront、実店舗	24-storefront.json
スポーツ、フィットネス、sports、fitness	25-sports-campaign.json

一致するものがない場合 → デフォルトで 01-hero-image.json を使用します。一致したテンプレートファイルだけを読み込み、すべてを一度に読み込まないでください。

テンプレートの使い方

1. prompt_template をプロンプトの基本構造として使用します。
2. ユーザーの商品情報で {variables} を置き換えます。
3. ユーザーがスタイルバリエーションを指定した場合 → variants.<name>.overrides を適用します。
4. 商品カテゴリーがわかっている場合 → category_tips.<category> を適用します。
5. 簡潔にします。有効な値があるフィールドだけを残し、自然な言葉による簡潔なプロンプトを出力します。

スタイルバリエーション早見表

各テンプレートには通常、3～4 種類のスタイルバリエーションが含まれています。よく使われるバリエーションの種類：

• luxury — 高級感（レンブラントライティング、ゴールドのアクセント、暗色のグラデーション）
• minimal — モダンでミニマル（純白／明るい色、すっきりとした線、大きな余白）
• fresh — 爽やかで自然（明るい自然光、柔らかなパステルカラー、透明感）
• tech — テクノロジー感（ドラマチックなサイドライト、暗い背景、金属の質感）

---

AI らしさを抑えるテクニック（UGC／ライブ配信／ソーシャルメディアのシーン）

UGC、ライブ配信、ソーシャルメディアのコンテンツを生成する際は、画像を本物らしく見せるため、以下のルールに従ってください。

• 具体的なスマートフォンの機種を指定します：iPhone 14 Pro、iPhone 15 Pro。
• 目に見える不完全さを加えます：毛穴、わずかなノイズ、暖色への色ずれ、完璧ではない構図。
• 本物らしさを表す言葉を使います：NOT professional photography、NOT AI-generated look。
• 実際の環境を見せます：少し散らかった状態、実際に使われている物、水滴、使用済みのタオル。
• フィルム調の色合いを参考にします：Kodak Portra 400 color feel。
• 明確に指定します：NOT retouched, NOT smoothed。
• 典型的な AI 用語は避けます：perfect、flawless、stunning、hyper-realistic は使いません。
• 各テンプレートに anti_ai_tips フィールドがある場合、そのシーンの生成時には必ず従ってください。

---

画像一式のスタイル統一ルール

メイン画像と商品詳細ページの画像、PDP 画像セット、広告画像セット、ソーシャルメディア画像セット、または複数枚の画像を生成する場合は、最初に Campaign Style Lock を定義する必要があります。これは画像一式のビジュアル上の規約であり、インスピレーションの説明ではありません。

Campaign Style Lock の必須項目

1. ビジュアルの方向性：例：premium tech ecommerce、clean household care、warm gift editorial。
2. 固定カラーパレット：メインカラーを 2～3 色、アクセントカラーを 1 色に制限します。背景色、文字色、アクセントカラーを明記し、画像ごとに配色を変えないでください。
3. 暖色／寒色のトーン：warm／cool／neutral を明確に指定し、画像一式で統一します。
4. フォントシステム：modern geometric sans-serif など、フォントのスタイルを 1 種類に統一します。セリフ体、手書き風、レトロ、カートゥーン調のフォントを混在させないでください。
5. 背景システム：clean light gray studio background や deep navy premium tech background など、背景の素材、空間、明るさを統一します。
6. ライティングシステム：光源の方向、影の強さ、反射の質感、雰囲気を統一します。
7. レイアウトシステム：余白、角丸、段組み、ラベル、番号、インフォグラフィックのコンポーネントのスタイルを統一します。
8. アイコン／イラストシステム：アイコンを使用する場合は、線の太さ、形、色、複雑さを統一します。
9. 商品表示ルール：商品の角度、サイズ比、素材の表現、中央配置の有無を一定にします。
10. スタイルの逸脱を禁止する項目：changing color palette、mixed fonts、inconsistent lighting、random backgrounds、mismatched icon styles を明確に禁止します。

デフォルトの Style Lock テンプレート

ユーザーからブランドガイドラインが提示されていない場合は、無難で統一感のある EC 向けビジュアルシステムを使用します。

Campaign Style Lock: consistent premium ecommerce visual system across the entire image set; fixed palette of clean off-white background, deep charcoal text, one product-matched accent color, and one soft secondary accent; neutral-cool studio lighting; modern geometric sans-serif headline placeholders only; consistent rounded rectangular info labels; consistent thin-line icon style; clean high-end product photography mixed with minimal infographic elements; stable product scale and placement; generous whitespace; no color palette changes, no mixed fonts, no random backgrounds, no inconsistent lighting, no mismatched icon styles.

複数画像のプロンプトに関する必須ルール

• 各画像のプロンプトの最初の段落は、同一の Campaign Style Lock にします。書き換えたり、短縮したり、同義語に置き換えたりしてはいけません。
• 画像ごとに変更できるのは、画像の目的、被写体の動き、部分的な構図、短いコピーだけです。
• 画像ごとに変更してはいけないのは、カラーパレット、暖色／寒色のトーン、フォントスタイル、背景システム、ライティングシステム、アイコンスタイル、情報ラベルのスタイルです。
• ユーザーが画像のうち 1 枚の再生成を求めた場合は、元の Campaign Style Lock を再利用する必要があります。
• 生成済みの画像のスタイルが統一されていない場合は、画像ごとに場当たり的に説明を追加するのではなく、プロンプト一式を書き直すことを優先します。

---

商品とマーケティングのコンバージョンプロセス

商品のメイン画像、EC 画像、広告画像、PDP のビジュアルは、固定テンプレートから始めず、まずコンバージョンを促す要因を判断します。

主要な要因を 1 つ選びます。

A. ビジュアル訴求型

外観、スタイルとの相性、光沢、質感、使用前後の比較、またはギフトとしての特性が購入判断に影響する商品に適しています。

重点項目：

• ひと目で商品の魅力を伝えること。
• 質感、細部、仕上げ、品質を示す要素。
• 使用シーンと視覚的な階層。
• 簡潔なベネフィット。

B. 痛点主導型

購入者が明確な不便、リスク、時間の損失、不快感、繰り返し起こる悩みを抱えている製品に適しています。

必須の順序：

1. 痛点の掘り下げ／リスクの喚起。
2. メリット／解決策。
3. 信頼と証拠。
4. 特典＋CTA。

具体的な問題、軽減の仕組み、証拠、リスクの軽減を重視します。

C. 感情的価値主導型

購入が、アイデンティティ、自信、帰属意識、ステータス、思いやり、喜び、新しさ、衝動に結びついている製品に適しています。

重視する点：

• 感情に訴えるフック。
• アイデンティティや憧れ。
• 実現手段としての製品。
• ソーシャルプルーフと、行動に移す際の手間の少なさ。

---

商品画像シーケンステンプレート

ユーザーが「商品詳細ページ、PDP、Amazon A+、Shopify 商品ページ、メイン画像のセット、商品画像一式、商品詳細画像」に言及した場合、5枚のメイン画像だけで終わらせないでください。必ず商品詳細ページの画像シーケンスを追加し、各画面を個別に画像生成できる Prompt として記述してください。

ビジュアル主導型のメイン画像シーケンス

1. 一目で伝わるビジュアルメッセージ。
2. 主な機能または質感のクローズアップ。
3. 使用シーンとのマッチング。
4. 一般的な方法とアップグレード版の比較。
5. 特典、配送、保証、または CTA のビジュアル。

痛点主導型のメイン画像シーケンス

1. 問題のスナップショット。
2. 解決の仕組み。
3. メリットの証明。
4. 信頼を伝えるビジュアル。
5. 特典＋緊急性のある CTA。

感情的価値主導型のメイン画像シーケンス

1. 感情に訴えるシーンのフック。
2. アイデンティティ／価値観の表現。
3. 実現手段としての製品。
4. 帰属意識、ステータス、またはソーシャルシグナル。
5. 感情を強める特典＋CTA。

---

商品詳細ページの画像シーケンステンプレート

商品詳細ページの画像は、モバイルで縦方向に閲覧することを想定しています。デフォルトでは、各画像を個別の画面として構成し、サイズは 2:3 またはプラットフォーム指定の縦横比を優先します。ユーザーが文案のみを明示的に希望した場合を除き、各モジュールに対応する画像 Prompt を必ず出力してください。

汎用 PDP 商品詳細ページ画像シーケンス

1. ファーストビューの引き継ぎ：メイン画像の訴求点を引き継ぎ、誰のどのような問題を製品が解決するかを説明します。
2. 痛点の拡大：ユーザーが現在抱えている不便、損失、リスク、または繰り返し起こる悩みを示します。
3. 仕組みの説明：製品がどのように機能するかを視覚的な構造で説明し、証明できないデータの捏造を避けます。
4. 主なメリット：主なメリットを2～4点、ひと目で把握できるインフォグラフィックにまとめます。
5. 使用手順：3～4ステップで使い方を説明し、理解にかかる負担を軽減します。
6. シーンの網羅：典型的な使用シーン、対象ユーザー、または使用前後の状態を示します。
7. 比較と選択：一般的な方法と本製品を比較し、目に見える違いと体験の違いを際立たせます。
8. 信頼の裏付け：素材、パッケージ、品質検査、保証、実際の評価など、既存の証拠を示します。証拠がない場合は「proof placeholder」と記載し、認証を捏造しないでください。
9. FAQ／リスクの軽減／CTA：残る懸念、対象範囲、アフターサービス、セット割引など、購入直前の疑問に対応します。

購買動機への適応

• ビジュアル主導型：質感の詳細、サイズの比率、使用シーン、ギフトらしさを加えます。
• 痛点主導型：「問題の深刻さ → 解決の仕組み → メリットの証明 → 信頼 → CTA」の順序を厳守します。
• 感情的価値主導型：ライフスタイル、アイデンティティの表現、ソーシャルシーン、感情的な満足感を加えます。

画像内テキストのルール

• 商品詳細ページの画像に短いコピーを入れても構いませんが、短く、明確で、モバイルに適したものにしてください。
• 各画面のメイン見出しは、英語なら3～7語、中国語なら6～12字を目安にします。
• 説明文は2～4個の短いラベルにし、長い小文字のテキストを生成しないでください。
• 各画像のテキスト量は厳密に制限します。見出し＋副見出し＋小さな注記は50字以内にしてください。
• 中国語のテキストは「」で囲みます。例：「修護屏障」「72h 深層鎖水」。正確に描画されやすくなります。
• フォントサイズを指定します。見出しは28～48pt、副見出しは16～20pt、注記は10～14ptです。
• 色は hex コードで指定します。濃いグレーの見出し #2D2D2D、薄いグレーの注記 #888888、ゴールドの強調色 #D4AF37。
• モデルが文字化けしやすい場合は、Prompt に「clean layout with short readable headline placeholders, no dense body text」と明記します。
• 画像の生成後、200％に拡大して中国語の画の細部を一文字ずつ確認し、複雑な文字は簡単な同義語に置き換えます。

ビジュアルのリズムに関するルール（複数画像のタスク）

連続する複数の画像で、背景色をすべて同じにしないでください。そうすると消費者が視覚的に疲れてしまいます。複数画像のタスクでは、2～3種類の背景色を交互に使用してください。

• 白背景のメイン画像／訴求ポイントのサブ画像：#FFFFFF
• 成分解析／テクスチャの展示：#F5F1E8（薄いベージュ）
• ブランドのメインビジュアル／プロモーション画像：ブランドの濃色（例：#1A3A2E）

マルチアングル撮影のルール（複数画像のタスク）

画像一式で、撮影アングルをすべて同じにしてはいけません。 AI 画像生成ではデフォルトで正面の3/4アングルになりやすいため、撮影アングルを明示しないと、画像一式がどれも同じように見えてしまいます。複数画像のタスクでは、各画像の撮影アングルとショットサイズを Prompt で指定してください。

アングル一覧（用途に応じて4～6種類を組み合わせて選択）

アングル	Prompt の記述	適したシーン
正面3/4	at a slight 3/4 angle showing full front facade	メイン画像、最初の画像
真上からの俯瞰	photographed directly from above at a 90-degree overhead angle	レイアウト、内部構造、平置きの展示
真横90°	photographed from a clean 90-degree side profile	奥行き、層、側面の詳細の展示
後方45°	photographed from behind at a 45-degree rear angle	背面の詳細、舵、船尾の構造の展示
低い位置からの仰角	photographed from a very low angle looking upward	ヒーローショット、迫力、子どもの目線
高い位置からの俯角	photographed from a high 45-degree angle looking down	上面、全体の規模、テーブル目線の展示

ショットサイズ一覧（用途に応じて2～3種類を組み合わせて選択）

ショットサイズ	Prompt の記述	適したシーン
ロングショット	full product visible, product occupies 35-40%	メイン画像、シーン画像
ミディアムショット	showing the [section name] area, product occupies 45-50%	機能の展示、構造の説明
クローズアップ	tight zoom on [specific detail], product detail occupies 55-60%	素材の質感、加工の細部、ボタン／端子
マクロ	extreme close-up macro shot, shallow depth of field	生地の織り目、縫い目の加工、表面の質感
部分撮影	close-up detail shot focusing on [specific part]	灯台の標識、砲台、ファスナー、ラベル

マルチアングルの割り当て原則

1. メイン画像シーケンス（5枚）：3種類以上の異なるアングルを使用し、そのうち1枚は必ずクローズアップまたはマクロにします。
2. 商品詳細ページ画像シーケンス（7～9枚）：4種類以上の異なるアングルを使用し、そのうち2枚は必ずクローズアップ／マクロにします。
3. 同じアングルを3枚連続で使用してはいけません。そうすると消費者が視覚的に疲れてしまいます。
4. ロングショットは画像一式の40％以下にします。ミディアムショット、クローズアップ、マクロを織り交ぜ、リズム感を加えてください。
5. 仰角と俯角をそれぞれ最低1枚ずつ使用し、平行目線での撮影ばかりになるのを避けます。
6. 各画像の Prompt には、アングルのキーワード（side profile、from above、low angle など）を必ず明記してください。モデルが自動的にアングルを変えることを前提にしないでください。

アングル Prompt テンプレート

各画像 Prompt の「構図、レンズ、フレーミング」のセクションに、アングルの説明を直接入れます。

# 俯视图
Bird's eye top-down view. The [product] photographed directly from above at a 90-degree overhead angle, showing the full layout [specific details visible from above]. Deep even lighting from directly above minimizing shadows.

# 侧视图
Side profile view. The [product] photographed from a clean 90-degree side profile, showing [what's visible from side]. Strong side lighting from the left creating dramatic depth.

# 仰视图
Dramatic low-angle hero shot. The [product] photographed from a very low angle looking upward, making [tower/building] appear tall and imposing. Strong upward lighting creating heroic dramatic shadows.

# 微距特写
Extreme close-up macro shot. Tight zoom on the [specific detail], showing [texture/mechanism/individual elements]. Shallow depth of field with the foreground in sharp focus and background slightly blurred. Warm directional side lighting highlighting surface texture.

# 后侧角度
Rear angled view. The [product] photographed from behind at a 45-degree rear angle, revealing [back details not visible from front]. This angle shows construction details not visible from the front.

商品詳細ページのインフォグラフィック構成ルール（重要！）

商品詳細ページの画像 ≠ マルチアングルの商品写真。 商品詳細ページの画像は、訴求コピー、アイコン、ラベル、比較、手順、信頼バッジなどのインフォグラフィック要素を含む、EC向けインフォグラフィック形式でなければなりません。製品はインフォグラフィックごとに異なるアングルで表示します。マルチアングルはインフォグラフィックを補助するための展示手段であり、目的そのものではありません。

誤った方法（アングルを変えるだけで、インフォグラフィックの構成がない）

# 错误：这只是"同一产品换个角度拍"，缺少电商转化元素
Prompt: Side profile view of the product on white background. Product occupies 38%. Whitespace 50%+.

正しい方法（EC向けインフォグラフィック＋マルチアングルの商品展示）

# 正确：有标题、卖点图标、标签、信息图布局，产品在其中展示特定角度
E-commerce infographic benefits screen on #FAF7F2 background.
Top headline in #2D2D2D at 28pt reading 「Core Benefits」.
Left side: the product shown from an elevated overhead angle.
Right side: four benefit rows stacked vertically with thin-line icons:
  (1) icon + 「Feature One」 in #7A9E7E
  (2) icon + 「Feature Two」 in #8B6F47
  (3) icon + 「Feature Three」 in #7A9E7E
  (4) icon + 「Feature Four」 in #8B6F47
Clean two-column layout. Product occupies 35%. Whitespace 48%+.

商品詳細ページの各画面に必須のインフォグラフィック要素

画面	EC向け構成	インフォグラフィック要素	推奨する製品アングル
ファーストビューの引き継ぎ	見出し＋製品＋4つの特色アイコン＋副見出し	製品を囲むアイコン＋ラベル	正面3/4
痛点の比較	3つの痛点アイコン → 3つの解決策＋製品	上下の比較レイアウト	真横
主な特色	複数列で並べて表示＋各列にラベルと説明	グリッド／3列レイアウト	各要素を個別にクローズアップ
主なメリット	左に製品＋右にメリットの一覧（アイコン＋短いコピー）	2列のインフォグラフィック	高い位置からの俯瞰
使用手順	4ステップのタイムライン／番号付きの円＋完成品の展示	手順のフローチャート	低いアングル（完成時のイメージ）
シーンの網羅	3つのシーン写真＋シーンラベル	3段のシーンカード	使用環境ごとに異なるアングル
信頼／加工	マクロの詳細画像＋注釈付きの円＋信頼バッジ	詳細の注釈付き画像	マクロのクローズアップ
CTA／ギフト	見出し＋製品＋訴求バッジ＋CTA ボタン	コンバージョンを促す締めくくりのレイアウト	正面3/4

インフォグラフィック用プロンプトに必ず含める要素

1. レイアウトのキーワード：e-commerce infographic、structured grid layout、two-column layout、three-row layout、timeline、comparison layout
2. 見出しとコピー：headline in #2D2D2D at 28pt reading 「...」、label in #7A9E7E at 14pt reading 「...」
3. インフォグラフィックの要素：feature callout icons、thin connecting lines、numbered circles、trust badges、CTA button placeholder
4. 商品アングル：各インフォグラフィックで商品を異なる角度から見せますが、角度はインフォグラフィックの内容に役立つものにします。
5. EC 用プロンプトの冒頭：各 PDP 用プロンプトは E-commerce infographic [screen type] で始めます。Close-up shot や Side view では始めません。

フォントの組み合わせルール

• 見出しにはセリフ体（Didot など）、サブタイトルと本文にはサンセリフ体（SF Pro Display など）を使用します。
• これは高級ブランドのカタログで標準的な組み合わせで、上質な印象を与えます。
• 画像セット全体で使用できるフォントはこの 2 種類のみです。3 種類目のフォントとの併用は禁止です。

---

複数画像の生成ルール

ユーザーが EC 画像一式の直接生成を求めた場合：

1. まず Campaign Style Lock を作成し、画像パックの計画に記載します。
2. 次に各画像の番号、用途、アスペクト比、画像内の短いコピー、個別のプロンプトを設定します。
3. メイン画像はデフォルトで 1:1、詳細ページ画像はデフォルトで 2:3 とし、モバイルでの縦スクロールに適した比率にします。
4. 1 枚ごとに独立したプロンプトファイルを使用し、1 つのプロンプトで複数画面のコラージュを生成しないようにします。
5. 各プロンプトは、同一の Campaign Style Lock の段落で始めます。
6. 出力先ディレクトリには、generated-images/laundry-detergent-pods-pdp/ のような商品の英語スラッグを使用します。
7. モデルが指定された比率に対応していない場合は、対応している中で最も近い比率に変更し、結果にその旨を記載します。
8. apiz CLI が利用できず（未インストール／未ログイン）、Codex 環境でもない場合は、スクリプトを呼び出さず、完全なプロンプト一式のみを出力します。
9. 認証、実験データ、評価、販売数、実際のレビュー、ブランドの使用許諾を捏造しないでください。

---

画像を直接生成するルール

ユーザーが画像の生成を求めた場合：

1. 最終プロンプトを先に出力します。
2. 画像生成チャネルの判定に従ってチャネルを選びます。Codex 環境では組み込みの imagegen を直接呼び出し、それ以外の環境では scripts/generate_image.py を実行します（内部で apiz CLI を使用します）。
3. 短いプロンプトには --prompt、長いプロンプトには --prompt-file を使用します。
4. プラットフォームに応じて --size（比率形式）を選択します。指定がない場合はデフォルトで 1:1 にします。
5. --output-dir を使用するのは、ユーザーが出力先ディレクトリを指定した場合のみです。それ以外は generated-images/ を使用します。
6. apiz CLI が未インストール、または未ログインの場合は、スクリプトを呼び出さず、プロンプトと apiz auth login の案内を返します。
7. 一括生成の前に Image Pack Plan と予想されるポイント消費量を提示し、ユーザーの確認を得てから実行します。

コマンド形式（Codex 以外の環境）：

python3 scripts/generate_image.py --prompt "..." --size 1:1

スクリプトの対応項目：

• --prompt / --prompt-file
• --output-dir
• --size：比率形式（1:1、16:9、2:3、4:5 など。1024x1024 のピクセル表記にも対応）
• --model：apiz 画像モデルの id。デフォルトは apiz/gpt-image-2.5-flare
• --image：ローカルの参考商品画像のパス（apiz CDN に自動アップロード）。--image-url：参考画像の公開 URL
• --timeout：単一タスクの最大待機秒数。デフォルトは 420
• --format：保存形式のデフォルト拡張子。デフォルトは png

---

QA チェック

最終出力の前に、以下を確認します：

• プロンプトがユーザーの実際の目的に合っている。
• 適切なシーンテンプレートが選ばれ、テンプレートの prompt_template に基づいてプロンプトが組み立てられている。
• プロンプトは簡潔で、重要な情報だけが含まれており、冗長な制約がない。
• 主体、構図、スタイル、用途が明確である。
• 商品／マーケティングのタスクに、コンバージョンを促す要因の診断が含まれている。
• 根拠が不足している場合、効果、認証、データを捏造していない。
• 画像内のテキストが短く、必要なものに限られている。
• UGC／ライブ配信／ソーシャルメディアのシーンで、anti-AI のテクニック（テンプレート内の anti_ai_tips フィールド）が適用されている。
• 画像生成チャネルの判定に従ってチャネルが選択されている。Codex 環境では組み込みの imagegen を、それ以外の環境では scripts/generate_image.py（apiz CLI）を使用している。
• ユーザーの参考画像がある場合、Codex チャネルでは imagegen に渡し、スクリプトチャネルでは --image / --image-url パラメーターに渡している。
• よくある失敗を防ぐネガティブ制約が含まれている。
• 出力とファイルに API key や機密情報が含まれていない。
• GPT-Image-2 の絶対ルールが適用されている：hex カラー、数値による占有率、明示的な余白、禁止事項のリスト、プラットフォーム向けの余白。
• 複数画像のタスクで角度と画角が使い分けられ、同じ角度が 3 枚連続せず、全景画像の割合が 40% 以下である。
• 詳細ページ画像は必ず EC インフォグラフィック形式（見出し、アイコン、ラベル、ベネフィット、手順、または信頼バッジを含む）にし、単なる複数アングルの商品写真にしない。各詳細ページ用プロンプトは E-commerce infographic で始める。
• 画像生成後、ユーザーに 200% に拡大して中国語の文字の画を一字ずつ確認するよう伝える。

---

よくある失敗と対策

失敗	原因	対策
中国語の文字の画が間違っている	モデルの中国語の精度は約 95% で、複雑な文字では画が抜けやすい	200% に拡大して一字ずつ確認する。複雑な文字は簡単な同義語に置き換える
ブランドカラーがずれる	「ゴールド」と書くと、8 種類のゴールドが出てくる	すべて hex コードで指定する（#D4AF37）
ロゴのスペースが埋まる	「スペースを空ける」と書いても、モデルに無視される	正確な座標で指定する：左上の 200×100 ピクセルの領域を完全に空ける
背景が純白ではない	「白背景」と書くと、薄いグレーになる	#FFFFFF と指定する
商品が大きすぎる、または小さすぎる	占有率を指定していない	具体的な割合を指定する：商品が画面の 38% を占める
画面いっぱいに詰まり、余白がない	余白の指定がない	明示的に指定する：余白を少なくとも 50% 確保する
連続する画像で視覚的に疲れる	すべての画像で背景色が同じ	2〜3 種類の背景色を交互に使用する
画像セット全体で角度が似通う	AI はデフォルトで正面の 3/4 アングルを生成するため、指定しないと画一的になる	各プロンプトで角度のキーワードを明示する。メイン画像は 3 種類以上、詳細ページは 4 種類以上の角度を使い、クローズアップ／マクロ撮影も織り交ぜる
衣類／3C の失敗率が高い	生地のドレープ感、人体の比率、端子やボタンの細部への要求が高すぎる	まずスキンケア、ホーム用品、食品など、安定したカテゴリで試す。衣類には参考画像 --image を使用して一貫性を高める
詳細ページが商品画像だけになる	複数アングルのキーワードしか書かれておらず、EC インフォグラフィックの構成（見出し、アイコン、ラベル、訴求点のリスト）がない	各詳細ページ用プロンプトは E-commerce infographic で始め、レイアウト、コピー、アイコンなどの EC 要素を含める。複数アングルはインフォグラフィック内で見せる手段であり、目的ではない

---

出力形式

Brief / Prompt モードでは、以下を返します：

1. 適用テンプレート：使用したテンプレートのファイル名とシーンの種類
2. Visual Brief
3. Final Image Prompt
4. Negative Constraints
5. Assumptions

商品またはマーケティングのタスクでは、以下も追加します：

1. Conversion Driver Diagnosis
2. Campaign Style Lock：複数画像を含むタスクの場合
3. Hero Image Sequence（各画像に対応するテンプレートファイルを明記）
4. PDP Detail Image Sequence：詳細ページ、PDP、または商品画像一式に関する依頼の場合
5. Copy Lines：画像に文字が必要な場合
6. Test Priorities

Generate モードでは、以下を返します：

1. 適用テンプレート：使用したテンプレートのファイル名とシーンの種類
2. Final Image Prompt
3. Campaign Style Lock：複数画像のタスクでは必須
4. Image Pack Plan：各画像の番号、用途、サイズ、対応するテンプレート、短いコピーを含む
5. Generated Files
6. Assumptions / Notes