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。成功：{"ok":true,"model":..,"files":[..],"size":..,"generated_size":..,"resized":..,"seconds":..}。失敗：{"ok":false,"code":..,"message":..}。
工作流程
- 理解請求：圖片的用途、放置位置、需要確切渲染的文字、尺寸、透明度。如果缺少關鍵資訊，問一個簡短的問題；否則直接進行。
- 使用真實參考，絕不虛構品牌資產。
- 如果使用者指名或附加圖片（例如「像這個截圖」、「使用我們的標誌」、「符合這種風格」），請將每一張圖片都使用
-r傳入。 - 如果圖片應該顯示或符合使用者的品牌/產品（標誌、OG 社交通用卡、橫幅、favicon、應用程式圖示、任何帶有產品名稱的內容），請先尋找專案中現有的資產 — 例如在
public/、assets/、static/、src/assets/、images/下名為logo*、icon*、favicon*、brand*、og*的檔案，以及 HTML/manifest 中引用的標誌 — 並將最符合的檔案使用-r傳入，同時在提示詞中說明如何使用它們（「完全按原樣使用參考圖片中的標誌，不要重新繪製它」）。 - 如果找不到合適的檔案，請要求使用者提供他們的標誌/參考，而不是自行虛構一個。只有在使用者明確要求時，才設計新的標誌。
- 參考圖片必須是 png、jpeg 或 webp 格式；若標誌僅有 SVG 格式，請告知使用者並要求提供 PNG 匯出（或僅在使用者同意的情況下，在沒有它的情況下繼續進行）。
- 如果使用者指名或附加圖片（例如「像這個截圖」、「使用我們的標誌」、「符合這種風格」），請將每一張圖片都使用
- 撰寫提示詞：根據使用者的描述（以及專案上下文，例如品牌顏色）來撰寫。保留使用者的意圖和確切文字；不要添加他們未要求的內容。除非使用者要求，否則告知模型不要包含第三方標誌、商標或品牌標記（模型喜歡用知名公司標誌裝飾科技圖片）。
- 數量：除非使用者要求更多，否則生成 1 張圖片。在一次生成超過 4 張圖片之前，請先要求使用者確認。
- 模型：除非使用者指定，否則讓腳本自行選擇。告知使用者使用了哪個模型。如果可用，對於編輯、大量參考或密集/精確文字的工作，建議使用
gpt-image-2.5-sunburst；每當使用者要求時，可以切換模型。 - 執行腳本。
- 檢查結果：閱讀每個輸出圖片一次。向使用者報告：檔案路徑、模型、最終尺寸、使用了哪些參考圖片，以及任何與請求不符的地方（拼寫錯誤的文字、被更改的標誌、錯誤的佈局、背景未透明…），並附上具體的建議。切勿自行重新生成 — 由使用者決定。
- 顯示：如果使用者想查看，請使用系統檢視器開啟（macOS 上使用
open，Windows 上使用start "" <file>，Linux 上使用xdg-open）。 - 修改：根據使用者的要求進行調整 — 使用調整後的提示詞重新生成，或使用
-r <先前的檔案>編輯先前的結果。編輯時，請使用來源圖片的尺寸傳入-s，以使結果保持其尺寸（除非使用者想要不同的尺寸）。切勿覆寫原始檔案；請寫入一個新檔案。 - 除非使用者要求，否則不要對生成的圖片執行
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 | 回報訊息。修正您自己的參數錯誤；不要重複嘗試。 |
在發生錯誤後，切勿自行切換模型或持續重試。