Generate Asset
Un lot d'images cohérent, contrôlé et intégré au projet. Codex CLI génère avec le modèle gpt-6-luna, effort high, via son skill système imagegen (outil intégré image_gen, compte ChatGPT de l'utilisateur : ni clé API ni facturation à l'image). Claude cadre, rédige le brief, lance, contrôle et intègre.
Ne jamais substituer un autre modèle (gpt-5.6-luna, gpt-6-astra…) : si gpt-6-luna est refusé, s'arrêter et le signaler. Un autre modèle, choisi par l'utilisateur, passe par CODEX_IMAGE_MODEL=<modèle>.
Installation sur une machine : bash ~/.claude/skills/generate-asset/install.sh (Pillow dans .venv, vérification de Codex CLI, essai des scripts).
Workflow
- Direction artistique : jamais de génération sans DA explicite. La chercher dans le projet (section « Direction artistique » du README,
ART_DIRECTION.md,docs/,CLAUDE.md,assets-src/*/README.mdavec les prompts précédents) et regarder 3 ou 4 assets existants de la même famille. Si elle couvre le besoin, l'appliquer et le dire en une phrase ; sinon poser le questionnaire de references/brief.md en une seule fois, puis proposer de consigner la réponse dans le README. - Cadrer le lot : sujets en
id→ description visuelle concrète (l'iddevient le nom de fichier). Dossier de sortie dans le workdir passé à Codex (le sandboxworkspace-writeinterdit d'écrire ailleurs) ; dans un dépôt, un dossier de sources commeassets-src/<lot>/, pas le dossier servi. Au-delà d'environ 20 images, un lot par catégorie, chacun avec son slug, lancés en parallèle. - Brief dans
/tmp/<slug>-prompt.md, en anglais, sur le modèle de references/brief.md. S'il existe des images de référence, demander à Codex de les regarder d'abord. - Lancer :
Le script détache Codex (mkdir -p <workdir>/<dossier> ~/.claude/skills/generate-asset/scripts/launch.sh <slug> <workdir> /tmp/<slug>-prompt.mdsetsid nohup), écrit le PID dans/tmp/<slug>.pid, le log dans/tmp/<slug>.log, et affiche les lignesmodel:etreasoning effort:: vérifiergpt-6-lunaethigh. - Attendre sans bloquer : Bash en
run_in_background: true, environ 1 minute par image ; un Monitor qui compte les fichiers du dossier suit la progression.while kill -0 $(cat /tmp/<slug>.pid) 2>/dev/null; do sleep 15; done; ls <workdir>/<dossier>; tail -20 /tmp/<slug>-last.md - Contrôler :
python3 ~/.claude/skills/generate-asset/scripts/contact_sheet.py <workdir>/<dossier> /tmp/<slug>-sheet.jpg, lire la planche (cohérence, aucun texte, lisibilité en petit), ouvrir en grand les images douteuses. Pour refaire ou compléter : nouveau slug, brief restreint aux ids concernés (« generate the N MISSING/REJECTED illustrations () — look at the existing files in first and match their style exactly »). - Intégrer :
python3 ~/.claude/skills/generate-asset/scripts/to_webp.py <workdir>/<dossier> <dossier_servi> 768 80recadre au carré, redimensionne et écrit<id>.webpen écrasant l'existant : ne remplacer des assets que si l'utilisateur l'a demandé. Adapter l'affichage si le format change (scène plein cadre :object-fit: coveren bandeau, pas une vignettecontainavec ombre).
Pièges Codex
--approve-for-meest incompatible avec-s/--sandbox: seulement-s workspace-write.- Un
codex execlancé sanssetsidmeurt au redémarrage de la session Claude : relancer alors seulement les ids manquants. - Codex écrit d'abord dans
~/.codex/generated_images/<session>/: y récupérer les images si la copie a échoué. tmux: Operation not permitteddans le log est sans conséquence.- Transparence : la demander explicitement (
transparent background) ; Codex préserve l'alpha deimage_gen. - Le skill système est dans
~/.codex/skills/.system/imagegen/. Ne jamais passer en mode CLI/API (~/.codex/skills/.system/imagegen/scripts/image_gen.py, qui exigeOPENAI_API_KEY) sans accord explicite.
Références (à lire seulement si l'étape l'exige)
- references/brief.md : questionnaire de direction artistique et modèle de brief Codex. À lire quand la DA du projet manque ou avant d'écrire le brief.
scripts/launch.sh: lance Codex détaché ; commande sous-jacentecodex exec -m gpt-6-luna -c model_reasoning_effort=high -s workspace-write --skip-git-repo-check -C <workdir> -o /tmp/<slug>-last.md "<brief>".scripts/contact_sheet.py(planche contact),scripts/to_webp.py(conversion WebP) : usage en tête de fichier.