Finale Bild-Assets
<skill-dir> ist der Ordner, der diese SKILL.md enthält, und <plugin-root> liegt zwei Ebenen darüber. Ersetze sie in Befehlen mit den echten Pfaden. (In Claude Code sind sie ${CLAUDE_SKILL_DIR} und ${CLAUDE_PLUGIN_ROOT}.)
Eingabe: ein Asset oder eine Liste, z. B. „Streak-Freeze-Icon“ oder „die 6 Belohnungsicons im GDD der täglichen Quests“. Ausgabe: PNGs im Asset-Pfad des Spiels, jedes mit seinem Prompt und Modell protokolliert.
Lies zuerst <plugin-root>/shared/conventions.md und die Repository-Konfiguration (Art-Abschnitt).
GI="<skill-dir>/scripts/gen_image.py" # Nur Python 3; gibt niemals den Key aus
python3 "$GI" check # Key + Modell, das verwendet würde, keine Kosten (aus dem Spiel-Repository ausführen)
python3 "$GI" generate --prompt "…" --out <datei.png> [--size BxH] [--background transparent] [--ref <kunst.png> …] [--log <log.jsonl>]
0. Ist die Bildgenerierung für dieses Projekt aktiviert?
Lies config: Image generation:
on: gehe zu Schritt 1.off: nicht generieren. Verwende vorhandene Kunst oder das Platzhalter-Muster des Repositorys und liste die noch benötigten Assets (Name, Größe, Verwendung) im Bericht auf. Nicht erneut fragen.not setoder fehlend: dies ist das erste Bild für dieses Projekt. Führecheckaus, frage dann mit dem Frage-Tool:- Wenn kein Key gefunden wurde, teilt die Frage mit, dass finale Assets standardmäßig OpenAIs GPT Image (neueste Version, 2 oder später) verwenden und ein API-Key benötigt wird. Die Optionen sind:
- Jetzt einen Key einrichten (empfohlen): zeige die Einrichtungsschritte unten an und warte, bis der Benutzer sagt, dass es erledigt ist. Führe dann erneut
checkaus. Wenn es bereit ist, schreibeon. - Nicht für dieses Projekt: schreibe
off (opted out <YYYY-MM-DD>)und fahre ohne generierte Kunst fort. - Nicht jetzt: überspringe Bilder dieses Mal, lasse das Feld
not setund frage beim nächsten Mal erneut.
- Jetzt einen Key einrichten (empfohlen): zeige die Einrichtungsschritte unten an und warte, bis der Benutzer sagt, dass es erledigt ist. Führe dann erneut
- Wenn ein Key gefunden wurde (in der
.envdes Repositorys, in der Umgebung oder für ein anderes Projekt eingerichtet), nennt die Frage, wo er gefunden wurde und das Modell, dascheckausgewählt hat. Wennchecksagt, dass die.env-Datei von Git getrackt wird, warne, dass der Key committed ist und rotiert werden sollte, und empfehle, ihn aus Git zu entfernen. Die Optionen sind: für dieses Projekt verwenden (empfohlen, dann schreibeon), nicht für dieses Projekt (off), und nicht jetzt.
- Wenn kein Key gefunden wurde, teilt die Frage mit, dass finale Assets standardmäßig OpenAIs GPT Image (neueste Version, 2 oder später) verwenden und ein API-Key benötigt wird. Die Optionen sind:
API-Key-Einrichtung (dem Benutzer anzeigen)
- Gehe zu platform.openai.com → API keys → Create new secret key. Ein projektspezifischer Key ist am besten.
- Stelle sicher, dass Billing Guthaben hat. GPT-Image-Modelle können dich auffordern, deine Organisation zu verifizieren (Settings → Organization → General). Der Zugriff kann nach der Verifizierung einige Minuten dauern.
- Speichere den Key auf diesem Rechner. Füge ihn niemals in den Chat ein.
- macOS (empfohlen): führe dies im Terminal aus. Es fragt nach dem Key, ohne ihn anzuzeigen, und speichert ihn im Schlüsselbund:
security add-generic-password -U -a "$USER" -s gd-toolkit-openai -w - Nur dieses Projekt: füge
OPENAI_API_KEY=…zur.envoder.env.localdes Repositorys hinzu. Überprüfe zuerst, dass die Datei in.gitignoreist. - Überall: füge
export OPENAI_API_KEY=…zu deinem Shell-Profil hinzu, z. B.~/.zshrc, und öffne dann ein neues Terminal. - Oder verwende eine nur für dich lesbare Datei:
~/.config/gd-toolkit/openai_api_key(chmod 600).
- macOS (empfohlen): führe dies im Terminal aus. Es fragt nach dem Key, ohne ihn anzuzeigen, und speichert ihn im Schlüsselbund:
- Sag mir, wenn es erledigt ist, und ich überprüfe es. Diese Überprüfung kostet nichts.
Ein Key im Schlüsselbund, in der Shell oder in der Konfigurationsdatei funktioniert für jedes Projekt; ein .env-Key funktioniert für sein Repository und überschreibt den Schlüsselbund. Die Ein-/Aus-Wahl wird pro Projekt getroffen.
1. Plane die Assets
- Stil: lies config: Art style und betrachte die darin aufgeführten Referenzkunstwerke. Übergib 1–4 der ähnlichsten vorhandenen Assets als
--ref, damit neue Kunst zum Spiel passt. Beschreibe den Stil in jedem Prompt mit denselben Worten: Palette, Linienstärke, Schattierung, Kamerawinkel und Material. - Spezifikationen: für jedes Asset: seine endgültige Größe, sein Format, ob es Transparenz benötigt, sein Dateiname und sein Pfad (config: Assets dir, plus das Namensmuster des Repositorys).
- Zeige die Liste mit der Gesamtzahl und dem Modell an und generiere, sobald der Benutzer zustimmt. Eine Bestätigung deckt den gesamten Batch ab.
2. Generiere
- Modell:
--model auto(Standard) verwendet das neueste gpt-image-Modell, Version 2 oder später, das der Key verwenden kann, und bevorzugt die detaillierte Variante für finale Kunst.--fast(übergeben als--prefer fast) ist nur für Entwürfe. Wenn config: Image model ein Modell nennt, übergib es mit--model. - Größe: generiere mit dem größten Quadrat oder dem nächstgelegenen Seitenverhältnis des Modells und skaliere dann auf die endgültigen Größen herunter (
sips -Z <px>auf macOS). Niemals hochskalieren. - Transparenz: Icons, Items und Sprites benötigen
--background transparent. Wenn die Ausgabe anmerkt, dass das Modell es abgelehnt hat, wurde das Bild deckend gemacht: generiere erneut mit einer flachen, einfarbigen Hintergrundfarbe, die im Prompt genannt wird, entferne diese Farbe und erwähne dies im Bericht. - Prompt: beschreibe das Subjekt, dann den Stilblock, dann die Komposition (zentriert, Abstand, kein Text, wenn nicht gewünscht). Bitte um keine Wörter, Logos oder Wasserzeichen, es sei denn, das Asset benötigt Text.
- Protokolliere jede Generierung in config: Art log (
--log). Platziere niemals Metadatendateien neben den ausgelieferten Assets.
3. Überprüfe jedes Bild
Betrachte jedes Bild, bevor du es behältst, und verwende eine kleine Kopie, um Kontext zu sparen. Generiere es erneut, maximal 3 Mal, wenn es nicht zu den Stilreferenzen passt, ungewollten Text oder Artefakte aufweist, falsch beschnitten ist oder in seiner kleinsten In-Game-Größe unlesbar ist. Wenn es immer noch fehlschlägt, behalte das beste und markiere es.
4. Bericht
Liste jedes Asset mit seinem Pfad, Größen, Modell und etwaigen Flags auf. Gib auch die noch benötigten Assets an (wenn die Generierung off oder übersprungen wurde) sowie den Log-Pfad. Sage, dass die Bilder KI-generiert sind, damit der Eigentümer entscheiden kann, wo dies offengelegt werden muss, z. B. in Store-Listings.