Ressources graphiques finales
<skill-dir> est le dossier qui contient ce SKILL.md, et <plugin-root> est deux dossiers au-dessus. Remplacez-les par les chemins réels dans les commandes. (Dans Claude Code, ce sont ${CLAUDE_SKILL_DIR} et ${CLAUDE_PLUGIN_ROOT}.)
Entrée : un actif ou une liste, comme "icône de gel de séquence" ou "les 6 icônes de récompense du GDD des quêtes quotidiennes". Sortie : PNG dans le dossier des actifs du jeu, chacun enregistré avec son prompt et son modèle.
Lisez d'abord <plugin-root>/shared/conventions.md et la configuration du dépôt (section Art).
GI="<skill-dir>/scripts/gen_image.py" # Python 3 uniquement ; n'affiche jamais la clé
python3 "$GI" check # clé + modèle qui serait utilisé, sans coût (à exécuter depuis le dépôt du jeu)
python3 "$GI" generate --prompt "…" --out <fichier.png> [--size LxH] [--background transparent] [--ref <art.png> …] [--log <log.jsonl>]
0. La génération d'images est-elle activée pour ce projet ?
Lisez config : Génération d'images :
on: allez à l'étape 1.off: ne générez pas. Utilisez l'art existant ou le modèle de remplacement du dépôt, et listez les actifs toujours nécessaires (nom, taille, utilisation) dans le rapport. Ne demandez pas à nouveau.not setou absent : c'est la première image pour ce projet. Exécutezcheck, puis demandez avec l'outil de question :- Si aucune clé n'a été trouvée, la question indique que les actifs finaux utilisent par défaut GPT Image d'OpenAI (la version la plus récente, 2 ou ultérieure) et qu'une clé API est nécessaire. Les options sont :
- Configurer une clé maintenant (Recommandé) : affichez les étapes de configuration ci-dessous et attendez que l'utilisateur confirme. Exécutez à nouveau
check. Une fois prêt, écrivezon. - Pas pour ce projet : écrivez
off (opted out <AAAA-MM-JJ>)et continuez sans art généré. - Pas maintenant : sautez les images cette fois, laissez le champ
not set, et demandez à nouveau la prochaine fois.
- Configurer une clé maintenant (Recommandé) : affichez les étapes de configuration ci-dessous et attendez que l'utilisateur confirme. Exécutez à nouveau
- Si une clé a été trouvée (dans le
.envdu dépôt, l'environnement, ou configurée pour un autre projet), la question indique où elle a été trouvée et le modèle quechecka sélectionné. Sicheckindique que le fichier.envest suivi par git, prévenez que la clé est commitée et doit être tournée, et recommandez de la déplacer hors de git. Les options sont : l'utiliser pour ce projet (Recommandé, puis écrivezon), pas pour ce projet (off), et pas maintenant.
- Si aucune clé n'a été trouvée, la question indique que les actifs finaux utilisent par défaut GPT Image d'OpenAI (la version la plus récente, 2 ou ultérieure) et qu'une clé API est nécessaire. Les options sont :
Configuration de la clé API (afficher à l'utilisateur)
- Allez sur platform.openai.com → API keys → Create new secret key. Une clé limitée à un projet est préférable.
- Assurez-vous que Billing a du crédit. Les modèles GPT Image peuvent également vous demander de vérifier votre organisation (Settings → Organization → General). L'accès peut prendre quelques minutes après la vérification.
- Enregistrez la clé sur cette machine. Ne la copiez jamais dans le chat.
- macOS (recommandé) : exécutez ceci dans le Terminal. Il demande la clé sans l'afficher, et la stocke dans le Trousseau :
security add-generic-password -U -a "$USER" -s gd-toolkit-openai -w - Ce projet uniquement : ajoutez
OPENAI_API_KEY=…au fichier.envou.env.localdu dépôt. Vérifiez d'abord que le fichier est dans.gitignore. - Partout : ajoutez
export OPENAI_API_KEY=…à votre profil shell, par exemple~/.zshrc, puis ouvrez un nouveau terminal. - Ou utilisez un fichier lisible uniquement par vous :
~/.config/gd-toolkit/openai_api_key(chmod 600).
- macOS (recommandé) : exécutez ceci dans le Terminal. Il demande la clé sans l'afficher, et la stocke dans le Trousseau :
- Dites-moi quand c'est fait, et je le vérifierai. Cette vérification ne coûte rien.
Une clé dans le Trousseau, le shell ou le fichier de configuration fonctionne pour tous les projets ; une clé dans .env fonctionne pour son dépôt et a priorité sur le Trousseau. Le choix on/off est fait par projet.
1. Planifier les actifs
- Style : lisez config : Style artistique et regardez l'art de référence qu'il liste. Passez 1 à 4 des actifs existants les plus proches en tant que
--ref, afin que le nouvel art corresponde au jeu. Décrivez le style dans chaque prompt avec les mêmes mots : palette, épaisseur de trait, ombrage, angle de caméra et matériau. - Spécifications : pour chaque actif, sa taille finale, son format, s'il nécessite de la transparence, son nom de fichier et son chemin (config : Dossier des actifs, plus le modèle de nommage du dépôt).
- Affichez la liste, avec son nombre total et son modèle, et générez une fois que l'utilisateur l'approuve. Une seule confirmation couvre le lot.
2. Générer
- Modèle :
--model auto(par défaut) utilise le modèle gpt-image le plus récent, version 2 ou ultérieure, que la clé peut utiliser, en privilégiant la variante détaillée pour l'art final.--fast(passé en tant que--prefer fast) est pour les brouillons uniquement. Si config : Modèle d'image nomme un modèle, passez-le avec--model. - Taille : générez à la plus grande taille carrée du modèle ou au rapport d'aspect le plus proche, puis réduisez aux tailles finales (
sips -Z <px>sur macOS). N'agrandissez jamais. - Transparence : les icônes, objets et sprites nécessitent
--background transparent. Si la sortie indique que le modèle l'a rejeté, l'image a été rendue opaque : régénérez avec une couleur d'arrière-plan plate et unie nommée dans le prompt, supprimez cette couleur, et mentionnez-le dans le rapport. - Prompt : décrivez le sujet, puis le bloc de style, puis la composition (centré, espacement, pas de texte sauf demande explicite). Demandez l'absence de mots, logos ou filigranes, sauf si l'actif nécessite du texte.
- Enregistrez chaque génération dans config : Journal des actifs (
--log). Ne placez jamais de fichiers de métadonnées à côté des actifs livrés.
3. Vérifier chaque image
Examinez chaque image avant de la conserver, en utilisant une petite copie pour économiser du contexte. Régénérez-la, au maximum 3 fois, si elle ne correspond pas aux références de style, comporte du texte ou des artefacts parasites, est mal recadrée, ou est illisible à sa plus petite taille dans le jeu. Si elle échoue encore, gardez la meilleure et signalez-la.
4. Rapporter
Listez chaque actif avec son chemin, ses tailles, son modèle et les éventuels drapeaux. Donnez également les actifs encore nécessaires (si la génération est off ou a été sautée), et le chemin du journal. Dites que les images sont générées par IA, afin que le propriétaire puisse décider où cela doit être divulgué, par exemple sur les fiches de la boutique.