buzz77/buzz-image

Was macht buzz-image?

Erzeugt und bearbeitet Bilder mit GPT Image über den BUZZ-Gateway, mit dem dieses Claude Code verbunden ist. Es verwendet den eigenen BUZZ-Key von Claude Code; es muss nichts weiter installiert oder konfiguriert werden. Verwende immer das gebündelte Skript – schreibe niemals eigene API-Aufrufe für Bilder und suche oder zeige niemals API-Keys an.

Antworte dem Benutzer in der Sprache, die er verwendet.

Das Skript ausführen

Übergib immer timeout: 600000 (ein Bild braucht normalerweise 30–90 s; große oder qualitativ hochwertige brauchen länger).

Wenn du ein Bash-Tool hast, verwende es. Diese genaue Befehlsform ist vorab genehmigt:

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

Andernfalls verwende das PowerShell-Tool (üblich unter Windows). Rufe den Skriptpfad direkt als erstes Wort auf – kein &, keine Anführungszeichen um den Pfad, kein verschachtelter powershell-Prozess, nichts davor oder danach – damit es der vorab genehmigten Form entspricht:

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

Wenn Claude Code den Benutzer trotzdem um Genehmigung bittet, ist das in Ordnung – warte auf die Genehmigung; suche niemals nach Workarounds.

Option	Werte
-p	Bildbeschreibung (erforderlich). Schreibe sie selbst aus der Anfrage des Benutzers.
-o	Ausgabepfad. Wähle einen, der zum Verwendungszweck passt (z. B. public/favicon.png, assets/og.png); lege ihn andernfalls unter generated/ ab. Vorhandene Dateien werden niemals überschrieben (es wird -2, -3 … angehängt).
-s	Exakte BxH (beliebige Größe, z. B. 32x32, 1200x630) oder square / landscape / portrait / wide / tall / 2k / 4k. Größen, die das Modell nicht direkt erzeugen kann, werden nahe dran generiert und lokal auf die genaue Größe zugeschnitten/skaliert. Weglassen, um das Modell entscheiden zu lassen.
-b	transparent für Ausschnitte/Aufkleber/Icons ohne Hintergrund (nur png oder webp); opaque; auto.
-q	low / medium / high / xhigh / max. Weglassen, es sei denn, der Benutzer fragt danach oder das Asset benötigt feine Details.
-f	png (Standard) / jpeg / webp.
-n	Anzahl der Bilder, Standard 1.
-r	Quell-/Referenzbild; für mehrere wiederholen. Jedes -r schaltet in den Bearbeitungsmodus.
--mask	PNG-Maske für lokale Bearbeitungen (transparent = neu malen); benötigt -r.
-m	Modell. Weglassen, um automatisch das beste verfügbare Modell für den Key des Benutzers auszuwählen.
--models	Liste der Bildmodelle, die für diesen Key verfügbar sind, ohne zu generieren.

Das Skript gibt eine JSON-Zeile aus. Erfolg: {"ok":true,"model":..,"files":[..],"size":..,"generated_size":..,"resized":..,"seconds":..}. Fehler: {"ok":false,"code":..,"message":..}.

Arbeitsablauf

1. Verstehe die Anfrage: wofür das Bild ist, wohin es soll, exakter darzustellender Text, Größe, Transparenz. Wenn etwas Wesentliches fehlt, stelle eine kurze Frage; ansonsten leg los.
2. Verwende echte Referenzen, erfinde niemals Marken-Assets.
   • Wenn der Benutzer Bilder benennt oder anhängt („wie dieser Screenshot“, „verwende unser Logo“, „stimme diesen Stil überein“), übergib jedes einzelne mit -r.
   • Wenn das Bild die Marke/das Produkt des Benutzers zeigen oder darauf abgestimmt sein soll (Logo, OG/Social Card, Banner, Favicon, App-Symbol, alles mit dem Produktnamen), suche zuerst nach den vorhandenen Assets des Projekts – z. B. Dateien mit den Namen logo*, icon*, favicon*, brand*, og* unter public/, assets/, static/, src/assets/, images/ und das im HTML/Manifest referenzierte Logo – und übergib die besten Übereinstimmungen mit -r, wobei du in der Aufforderung beschreibst, wie sie zu verwenden sind („verwende das Logo aus dem Referenzbild genau so, wie es ist, zeichne es nicht neu“).
   • Wenn nichts Passendes gefunden wird, frage den Benutzer nach seinem Logo/seiner Referenz, anstatt eines zu erfinden. Entwerfe ein neues Logo nur, wenn der Benutzer explizit danach fragt.
   • Referenzbilder müssen png, jpeg oder webp sein; wenn ein Logo nur als SVG existiert, teile dem Benutzer mit und bitte um einen PNG-Export (oder fahre nur ohne fort, wenn er zustimmt).
3. Schreibe die Aufforderung aus der Beschreibung des Benutzers (und dem Projektkontext wie Markenfarben). Behalte die Absicht und den genauen Text des Benutzers bei; füge nichts hinzu, worum er nicht gebeten hat. Sofern der Benutzer nicht darum bittet, weise das Modell an, keine Logos, Marken oder Markenzeichen Dritter einzufügen (Modelle verzieren technische Bilder gerne mit bekannten Firmenlogos).
4. Anzahl: generiere 1 Bild, es sei denn, der Benutzer wünscht mehr. Bevor du mehr als 4 auf einmal generierst, bitte den Benutzer um Bestätigung.
5. Modell: lass das Skript wählen, es sei denn, der Benutzer nennt eines. Teile dem Benutzer mit, welches Modell verwendet wurde. Schlage gpt-image-2.5-sunburst für Bearbeitungen, referenzintensive Arbeiten oder dichten/präzisen Text vor, wenn es verfügbar ist; wechsle das Modell, wenn der Benutzer es wünscht.
6. Führe das Skript aus.
7. Überprüfe das Ergebnis: Lies jedes Ausgabebild einmal. Berichte dem Benutzer: Dateipfad(e), Modell, endgültige Größe, welche Referenzbilder verwendet wurden und alles, was nicht der Anfrage entspricht (falsch geschriebener Text, verändertes Logo, falsches Layout, Hintergrund nicht transparent …), mit einem konkreten Vorschlag. Generiere nicht von selbst neu – der Benutzer entscheidet.
8. Zeige an: wenn der Benutzer es sehen möchte, öffne es mit der Systemansicht (open unter macOS, start "" <Datei> unter Windows, xdg-open unter Linux).
9. Änderungen: wende an, was der Benutzer wünscht – generiere mit einer angepassten Aufforderung neu oder bearbeite das vorherige Ergebnis mit -r <vorherige Datei>. Gib beim Bearbeiten -s mit der Größe des Quellbildes an, damit das Ergebnis seine Abmessungen behält (es sei denn, der Benutzer wünscht eine andere Größe). Überschreibe niemals das Original; schreibe eine neue Datei.
10. Führe git add für generierte Bilder nur aus, wenn der Benutzer darum bittet.

Fehler (code im JSON)

code	Was dem Benutzer mitteilen / tun
not_buzz	Dieses Claude Code ist nicht mit BUZZ verbunden, daher kann buzz-image nicht ausgeführt werden. Stopp.
no_key	Kein API-Key in der Konfiguration von Claude Code. Stopp.
no_image_model	Die Gruppe des Keys hat kein GPT Image-Modell; ändere die Gruppe des Keys in der BUZZ-Konsole (API-Keys-Seite) zu einer, die gpt-image-Modelle enthält. Stopp.
model_unavailable	Dieses Modell ist für den Key nicht verfügbar; zeige available_models und lass den Benutzer wählen.
insufficient_balance	Guthaben zu niedrig; lade in der BUZZ-Konsole auf. Stopp.
content_policy	Gib die Nachricht weiter; lass den Benutzer entscheiden, wie er umformuliert. Formuliere nicht selbst um und versuche es nicht erneut.
timeout	Teile dem Benutzer mit, dass die Zeit abgelaufen ist. Wiederhole nicht automatisch (das Bild wurde möglicherweise bereits abgerechnet); biete eine Wiederholung an.
http_error / bad_args	Melde die Nachricht. Behebe deine eigenen Argumentfehler; schleife nicht.

Wechsle niemals selbstständig das Modell oder wiederhole den Vorgang nach einem Fehler.