liangdabiao/ecom-details-image

一个面向workbuddy / Codex 等agent 的跨境电商和国内电商通用视觉创作 Skill。我精选25个高质量案例，涵盖纯色底产品主图、场景化生活图、平铺图、电商详情图、真实场景等等，全部配完整提示词，都可以利用 GPT-Image-2 API生成最终效果。一键生成电商相关图片！输入产品图片和需求描述，自动生成完整的电商主图、详情页图片、社媒推广图、直播间场景图等全套视觉素材。与众不同之处是：**Campaign Style Lock** 机制和 **强推广** 和 **重视转化效果**。

ecom‑details‑image スキル

概要 – eコマースの製品ページに必要なビジュアルアセット一式（メインの製品写真、詳細ページ用画像、ソーシャルメディア用バナー、ライブ配信の背景など）を作成する、コマンドライン駆動の「スキル」です。Claude Code、Codex、または WorkBuddy 環境で動作し、apiz 画像生成サービス（または Codex 内蔵の imagegen ツール）と連携します。このスキルは以下のいずれかが可能です：

ビジュアルブリーフとすぐに使えるプロンプトを生成して画像モデルに渡す、または
直接画像モデルを呼び出して生成された画像を保存する。

主要な概念

概念	意味
プロンプト / ブリーフモード	スキルは構造化されたブリーフ（目標、スタイル、コンバージョン要因など）と最終的なプロンプト、およびネガティブ制約を返します。apiz CLI がインストールされていない限り、画像は生成されません。
生成モード	「画像をレンダリング」と指示すると、スキルは最終的なプロンプトを構築し、Campaign Style Lock（色、照明、フォント、レイアウトなどをセット全体で一貫させるためのテキストブロック）を作成してから、Codex の `imagegen` ツールを呼び出すか、apiz CLI を使用する `scripts/generate_image.py` を実行します。
Campaign Style Lock	すべての画像プロンプトに注入される再利用可能なスタイル記述で、バンドル全体に統一感を持たせます。
apiz CLI	参照画像をアップロードし、AI 画像モデル（デフォルトは `apiz/gpt-image-2.5-flare`）への生成リクエストを送信し、タスクの完了を待機して結果をダウンロードするためのサードパーティ製コマンドラインクライアントです。
画像パックルール	デフォルトでは、このスキルは完全な eコマースパッケージ（メインの製品ショット 5 枚と詳細ページ用画像 7～9 枚、それぞれにプロンプトファイル付き）を出力します。

使用方法

apiz CLI をインストール（自動画像生成を行う場合）：

apiz --version   # インストールの確認
apiz auth login  # API キーの保存

リポジトリをクローンし、ルートディレクトリに移動します。
スキルを実行（AI アシスタント環境経由）し、ブリーフまたは完全な画像パックをリクエストします。アシスタントへのプロンプト例： “Generate a visual brief and prompt for a premium‑look Amazon main image of a self‑heating eye mask.” “Render the full image pack for a laundry pod product, using the configured API.”
生成をリクエストした場合、スキルは以下の処理を行います：
- 最終的なプロンプトを構築。
- Campaign Style Lock を作成。
- imagegen (Codex) を呼び出す、または python3 scripts/generate_image.py … (apiz) を実行。
- 画像を generated-images/（または指定したフォルダ）に保存し、ファイルパスを返します。

コマンドラインヘルパー (`scripts/generate_image.py`)

オプション	説明
`--prompt "…"`	コマンドラインで直接プロンプト文字列を指定。
`--prompt-file FILE`	テキストファイルからプロンプトを読み込む。
`--output-dir DIR`	生成された画像の保存先（デフォルトは `generated-images/`）。
`--size RATIO`	アスペクト比（`1:1`、`4:5`、`16:9` など）– `1024x1024` のようなピクセル形式も可。
`--model MODEL_ID`	使用する画像モデル（デフォルトは `apiz/gpt-image-2.5-flare`）。
`--image PATH`	ローカルの参照用製品写真 – 先に apiz CDN にアップロードされます。
`--image-url URL`	参照画像の公開 URL（`--image` より優先されます）。
`--timeout SEC`	apiz タスクの最大待機秒数（デフォルトは 420）。
`--format EXT`	保存する画像の拡張子（デフォルトは `png`）。
`--env-file FILE`	カスタム `.env` ファイルから環境変数を読み込む。

典型的な呼び出し：

python3 scripts/generate_image.py \
  --prompt-file prompt.txt \
  --size 4:5 \
  --model apiz/gpt-image-2.5-flare \
  --image data/product.jpg \
  --output-dir outputs

制限事項と安全上の注意

コスト – 各画像は apiz クレジットを消費します（1 枚あたり約 30～90 秒）。大量に生成する前に apiz account balance で残高を確認してください。
非同期生成 – CLI はタスクの完了を待機 (--wait) しますが、基盤となる URL は一時的なものです。スクリプトはファイルをローカルにダウンロードします。
機密情報の漏洩防止 – リポジトリは API キーを一切保存しません。apiz CLI のログインまたは環境変数を通じて提供する必要があります。
コンテンツポリシー – スキルはネガティブ制約（例：「読み取り可能なテキストなし」）を追加し、ビジュアルコピー内で認証やテスト結果を捏造しないよう警告します。
モデル依存の解像度 – 出力されるピクセル寸法は選択したモデルに依存します（デフォルトでは最大 4K をサポート）。

活用シーン

eコマース事業者：Amazon、Shopify、TikTok Shop など向けに、一貫性のある製品画像セットを迅速に作成する必要がある場合。
マーケティングチーム：AI 生成の広告バナー、ソーシャルメディア用グラフィック、ライブ配信の背景を求めている場合。
AI アシスタントボット開発者：独自の統合コードを書かずに、すぐに使える画像生成スキルを組み込みたい場合。

クイックスタートチェックリスト

apiz CLI をインストールしてログインする。
リポジトリをクローンする。
AI アシスタントでブリーフまたは完全な画像パックをリクエストする。
生成をリクエストした場合は、generated-images/ 配下のファイルを確認する。
ビジュアルブリーフを確認し、必要に応じてプロンプトを調整し、生成されたアセットで A/B テストを実行する。