buzz77/buzz-image

buzz-image は何をしますか？

BUZZ ゲートウェイ（この Claude Code が接続しているもの）を通じて、GPT Image で画像を生成・編集します。Claude Code 自身の BUZZ キーを再利用するため、追加のインストールや設定は不要です。常にバンドルされたスクリプトを使用してください。画像用の API 呼び出しを独自に記述したり、API キーを探したり表示したりしないでください。

ユーザーが使用する言語で応答してください。

スクリプトの実行

常に timeout: 600000 を指定してください（画像生成には通常 30～90 秒かかり、大規模または高品質なものはさらに時間がかかります）。

Bash ツールがある場合はそれを使用してください。 以下の正確なコマンド形状は事前承認されています：

bash ${CLAUDE_SKILL_DIR}/scripts/gen.sh -p "PROMPT" -o PATH [options]

それ以外の場合は PowerShell ツールを使用してください（Windows で一般的）。スクリプトパスを最初の単語として直接呼び出してください。& は付けず、パスを引用符で囲まず、入れ子の powershell プロセスを実行せず、前後に何もチェーンしないでください。これにより事前承認された形状と一致します：

${CLAUDE_SKILL_DIR}/scripts/gen.ps1 -Prompt "PROMPT" -Out PATH [-Size ..] [-Quality ..] [-Background ..] [-Format ..] [-N ..] [-Ref a.png,b.png] [-Mask m.png] [-Model ..]

Claude Code がユーザーにコマンドの承認を求めてきた場合は、それで構いません。承認を待ってください。回避策を探さないでください。

オプション	値
-p	画像の説明（必須）。ユーザーのリクエストから自分で作成してください。
-o	出力パス。用途に合ったものを選んでください（例：public/favicon.png、assets/og.png）。それ以外は generated/ の下に配置してください。既存ファイルは上書きされません（代わりに -2、-3… が追加されます）。
-s	正確な WxH（任意のサイズ、例：32x32、1200x630）または square / landscape / portrait / wide / tall / 2k / 4k。モデルが直接生成できないサイズは、近いサイズで生成され、ローカルで正確なサイズにトリミング/スケーリングされます。省略するとモデルが決定します。
-b	背景なしの切り抜き/ステッカー/アイコン用に transparent（png または webp のみ）。opaque、auto。
-q	low / medium / high / xhigh / max。ユーザーが指定した場合、またはアセットに細かいディテールが必要な場合にのみ使用してください。
-f	png（デフォルト）/ jpeg / webp。
-n	画像の枚数、デフォルトは 1。
-r	ソース/参照画像。複数指定する場合は繰り返します。-r を指定すると編集モードに切り替わります。
--mask	ローカル編集用の PNG マスク（透明部分 = 再描画）。-r が必要です。
-m	モデル。省略すると、ユーザーのキーで利用可能な最適なモデルが自動選択されます。
--models	このキーで利用可能な画像モデルを一覧表示します（生成は行いません）。

スクリプトは JSON を 1 行出力します。成功：{"ok":true,"model":..,"files":[..],"size":..,"generated_size":..,"resized":..,"seconds":..}。失敗：{"ok":false,"code":..,"message":..}。

ワークフロー

1. リクエストを理解する：画像の用途、保存場所、レンダリングする正確なテキスト、サイズ、透明度。重要な情報が不足している場合は短い質問を 1 つ行い、それ以外はそのまま進めてください。
2. 実際の参照を使用し、ブランドアセットを決して invent しないでください。
   • ユーザーが画像を指定または添付した場合（「このスクリーンショットのように」「私たちのロゴを使って」「このスタイルに合わせて」）、すべての画像を -r で渡してください。
   • 画像がユーザーのブランド/製品（ロゴ、OG/SNS カード、バナー、ファビコン、アプリアイコン、製品名を含むもの）を表示または一致させる必要がある場合は、まずプロジェクトの既存アセットを探してください。例：public/、assets/、static/、src/assets/、images/ の下にある logo*、icon*、favicon*、brand*、og* という名前のファイル、および HTML/manifest で参照されているロゴ。最適なものを -r で渡し、プロンプトで使用方法を説明してください（「参照画像のロゴをそのまま使用し、再描画しないでください」）。
   • 適切なものが見つからない場合は、ユーザーにロゴ/参照を尋ねてください。自分で作らないでください。ユーザーが明示的に新しいロゴを依頼した場合のみ、新しいロゴをデザインしてください。
   • 参照画像は png、jpeg または webp である必要があります。ロゴが SVG でのみ存在する場合は、ユーザーにその旨を伝え、PNG エクスポートを依頼してください（またはユーザーが同意した場合のみ、それなしで進めてください）。
3. プロンプトを作成する：ユーザーの説明（およびブランドカラーなどのプロジェクトコンテキスト）から作成してください。ユーザーの意図と正確なテキストを維持し、頼まれていないものを追加しないでください。ユーザーが依頼しない限り、サードパーティのロゴ、商標、ブランドマークを含めないようモデルに指示してください（モデルはテクノロジー画像を有名企業のロゴで装飾することがよくあります）。
4. 枚数：ユーザーがより多くを要求しない限り、1 枚生成してください。一度に 4 枚以上生成する前に、ユーザーに確認を取ってください。
5. モデル：ユーザーが指定しない限り、スクリプトに選択させてください。使用されたモデルをユーザーに伝えてください。編集、参照が多い作業、または密集/高精度なテキストには、利用可能な場合は gpt-image-2.5-sunburst を推奨してください。ユーザーが要求すればいつでもモデルを切り替えてください。
6. スクリプトを実行する。
7. 結果を確認する：各出力画像を 1 回読んでください。ユーザーに報告してください：ファイルパス、モデル、最終サイズ、使用した参照画像、そしてリクエストと一致しない点（スペルミスのテキスト、ロゴの変更、レイアウトの誤り、背景が透過でないなど）を具体的な提案と共に伝えてください。自分で再生成しないでください — ユーザーが決定します。
8. 表示する：ユーザーが確認を希望する場合は、システムビューアで開いてください（macOS では open、Windows では start "" <file>、Linux では xdg-open）。
9. 変更：ユーザーの要求に応じて変更を適用してください。プロンプトを調整して再生成するか、-r <前回のファイル> で以前の結果を編集してください。編集する際は、ソース画像のサイズを -s で渡して、結果の寸法を維持してください（ユーザーが異なるサイズを希望する場合を除く）。元のファイルを上書きしないでください。新しいファイルに書き込んでください。
10. ユーザーが要求しない限り、生成された画像を git add しないでください。

エラー（JSON の code）

code	ユーザーへの伝え方 / 対応
not_buzz	この Claude Code は BUZZ に接続されていないため、buzz-image は実行できません。停止してください。
no_key	Claude Code の設定に API キーがありません。停止してください。
no_image_model	キーのグループに GPT Image モデルがありません。BUZZ コンソール（API キーページ）で、キーのグループを gpt-image モデルを含むものに変更してください。停止してください。
model_unavailable	そのモデルはキーで利用できません。available_models を表示し、ユーザーに選択させてください。
insufficient_balance	残高が不足しています。BUZZ コンソールでチャージしてください。停止してください。
content_policy	メッセージをそのまま伝え、ユーザーに言い換えを決めてもらってください。自分で言い換えて再試行しないでください。
timeout	タイムアウトしたことを伝えてください。自動的に再試行しないでください（画像は既に課金されている可能性があります）。再試行を提案してください。
http_error / bad_args	メッセージを報告してください。自分の引数の間違いを修正してください。ループしないでください。

エラー後、自分でモデルを切り替えたり、再試行を続けたりしないでください。