Réalisateur d'image Codex
Règles de comportement
-
Commence par choisir un unique flux dans le tableau « Taille de tâche et flux » ci-dessous, détermine le mode de décision selon « Mode de décision », puis lis le fichier de ce flux avant d'agir.
- Avant cela, n'écris pas de prompt, n'appelle pas Codex, ne lis pas les fichiers profonds de
catalog/.
- Avant cela, n'écris pas de prompt, n'appelle pas Codex, ne lis pas les fichiers profonds de
-
Après avoir choisi, réponds par une phrase :
Flux <flux>[·<niveau>], motif : utilisateur a mentionné <extrait> ; mode de décision : <interrogatif/autonome/hybride> ; prochaine lecture : <fichier> -
Si deux lignes du tableau ou plus correspondent, ou si aucune ne correspond, arrête-toi et demande à l'utilisateur, ne pars pas par défaut sur un flux.
-
La consommation de crédits de génération d'image est nettement plus élevée qu'un échange de dialogue normal (environ 3 à 5 fois). Ne génère pas en lot « pour essayer », ne modifie qu'une seule variable par retour de correction.
Chaîne de génération d'image
Besoin utilisateur
│
▼
Conception de l'image ── compléter les dimensions non mentionnées / déduire la géométrie physique / anticiper les conflits / adapter pour faciliter le dessin ← agent : réalisateur
│
▼
Fichier de prompt (anglais, balises segmentées) [+ fichier de paramètres fixes] [+ image(s) de référence / image de base]
│
▼
scripts/gen.py ──▶ codex exec (sandbox en lecture seule) ──▶ image_gen intégré ← Codex : transcripteur ; image_gen : dessinateur
│ L'emballage demande un appel à l'identique sans réécriture ni auto-vérification
▼
$CODEX_HOME/generated_images/<thread_id>/ ──▶ répertoire de sortie name-vNNN.<ext> (n'écrase pas les anciennes versions)
│
▼
L'agent inspecte lui-même les images une par une (zoom sur les petits détails) ← agent : contrôle qualité
│
▼
Retouche à variable unique : édition / régénération / collage local (scripts/patch_region.py)
La précision vient de la boucle fermée (conception → spécification → exécution → validation → retouche à variable unique), pas d'un mot-clé. Voir README.md pour l'explication (lu par l'humain, pas nécessaire à l'exécution).
Terminologie
| Terme | Signification |
|---|---|
| Image de base | L'image modifiée en mode édition ; dans le prompt, écrire Image N is the edit target |
| Image de référence | Image empruntée seulement pour certains éléments, non modifiée ; pour chaque, préciser ce qui est emprunté et ce qui ne l'est pas |
| Liste de verrouillage | Éléments qui ne doivent pas changer dans ce tour, listés un par un (pas seulement « le reste inchangé ») |
| Fichier de paramètres fixes | Paramètres de personnage, style, physique constants entre plusieurs images ; utiliser --spec pour les concaténer avant les spécifications de chaque image |
| Édition / Régénération | Édition : conserver la composition de l'image de base, ne modifier qu'une partie ; Régénération : redessiner à partir du prompt, éventuellement avec image(s) de référence |
| Collage local | Prendre l'ancienne image comme base, ne coller que les pixels de la zone cible de la nouvelle image ; sert à rattraper la dérive en édition |
| Échelle de réalisme | Gradation continue de l'illustration plate à la photo réaliste, avec mots-clés d'ancrage par niveau |
| Point de décision | Endroit dans le flux nécessitant un choix ; chaque flux contient un tableau « Points de décision » listant les options, le choix par défaut en autonome et les cas où il faut impérativement demander |
Taille de tâche et flux
Lis d'abord tout le tableau, puis choisis un flux.
| Flux | Signal d'intention (phrases typiques) | Première étape | Profondeur de conception | Itérations attendues | Fichier |
|---|---|---|---|---|---|
| Image unique rapide | Veut une nouvelle image, esquisse, brouillon, « dessine-moi ça vite » | Concevoir et générer directement | Seulement angle, style, lumière | 1–2 tours | flows/single-image.md |
| Image unique premium | Veut une nouvelle image, description longue, insiste sur la tension ou la texture, fournit une référence | Compléter toutes les dimensions, déduire la géométrie physique | Toutes dimensions | Plusieurs tours, souvent régénération d'abord pour poser le cadre, puis édition fine | flows/single-image.md |
| Série / Projet personnage | Même personnage ou univers pour plusieurs images, cohérence, fiche de personnage ou vues 3/4 | Questions de fond + créer le répertoire projet | D'abord les paramètres, puis les scènes | Plusieurs tours pour les paramètres, 1–2 tours par scène puis retouches | flows/series-project.md |
| Exploration de variantes | Forme non définie, « donne plusieurs options », comparer et choisir | Définir l'invariant et l'axe d'exploration | Chaque direction ne change qu'un axe | Divergence → sélection → convergence | flows/explore-variants.md |
| Édition d'image existante | Ne modifier qu'une partie, « répare la main », « le reste inchangé », « enlève tel objet » | Décrire l'erreur actuelle + liste de verrouillage | Décrire seulement la modification | Une modification par tour | flows/edit-refine.md |
| Refonte d'image existante | Changement de vêtements, de forme, de style, changement d'angle, recomposition, tout en gardant le visage ou certains éléments | Lister les éléments conservés et ceux remplacés | Éléments conservés verrouillés, remplacés entièrement conçus | 2–4 tours | flows/redesign.md |
| Maintenance | Maintenance du skill : ajout d'expérience, ajustement des flux ou scripts, calibration des déclencheurs | Déterminer à quel niveau placer | — | — | flows/maintain.md |
Erreurs de routage fréquentes :
- « Modifie cette image » :
- Ne touche qu'une partie → édition.
- Modifie la composition, l'angle, les vêtements du sujet ou le style → refonte. En cas de doute, demande à l'utilisateur.
- « Déplace la personne vers le bas à gauche » / « Tourne l'angle » : modification de niveau composition ; le mode édition échoue généralement → refonte ou régénération d'image unique, pas d'édition.
- « Fais-en encore quelques-unes » :
- Même personnage, scènes différentes → série.
- Même besoin, directions de conception différentes → exploration de variantes.
Mode de décision
Les choix à faire pendant l'exécution sont listés dans le tableau « Points de décision » de chaque flux. Traite selon le niveau d'autorisation de l'utilisateur :
| Mode | Déclencheur | Comportement |
|---|---|---|
| Interrogatif (par défaut) | L'utilisateur n'a pas exprimé de préférence | Aux points de décision, poser une question à choix multiples ; mettre la recommandation en première option avec justification ; poser toutes les questions d'une même phase en une fois, pas en vrac |
| Autonome | L'utilisateur dit « fais comme tu veux », « suit ton idée », « décide tout seul », « le reste selon ton idée » | Appliquer la valeur par défaut autonome du tableau ; à la livraison, lister « Mes décisions » : décision, raison, comment l'annuler |
| Hybride | L'utilisateur n'autorise qu'une partie, ex. « l'angle tu décides, les vêtements demande-moi » | Les parties autorisées suivent le mode autonome, le reste est interrogatif |
En mode autonome, deux cas où il faut impérativement s'arrêter et demander (barrière dure) :
- La décision va à l'encontre des paramètres confirmés par l'utilisateur ou de ses instructions explicites.
- Augmentation significative des crédits : plus de 3 images en une fois, ou plus de 2 tours de retouche automatique sur le même problème.
- Prérequis manquants : source de référence non autorisée, Codex indisponible.
- Instructions contradictoires de l'utilisateur, impossible de satisfaire toutes les contraintes simultanément.
- Points marqués « toujours demander » dans les tableaux de décision de chaque flux.
Retouches en mode autonome :
- Défauts structurels (doigts supplémentaires, lignes cassées, erreur de comptage, violation de la consigne) : retouche automatique autorisée, max 2 tours par problème.
- Choix esthétiques (plus fin ou plus costaud, plus froid ou plus chaud) : pas de retouche automatique ; les écrire dans « Directions optionnelles » à la livraison, pour que l'utilisateur choisisse.
Limites
- Les images de référence sont uniquement celles fournies par l'utilisateur ou explicitement autorisées. Si l'utilisateur demande « ne pas se baser sur des productions intermédiaires », les images générées précédemment ne peuvent pas servir de référence ou d'image de base.
- Les productions sont sauvegardées par numéro de version, sans écraser les fichiers existants.
- Le propre rapport du générateur (Codex ou autre agent) sur le résultat ne fait pas foi pour la validation ; il faut regarder l'image.
- Si Codex est indisponible, non connecté ou si les crédits sont insuffisants, s'arrêter et le signaler ; ne pas contourner, ne pas utiliser un canal de génération non approuvé.
- En cas d'annulation en cours de génération, vérifier que le sous-processus codex est bien terminé, sinon les crédits continuent d'être consommés.
- S'inspirer du travail d'autrui uniquement par le langage de design, pas en reproduisant la forme ; ne pas écrire le nom de l'œuvre, du jeu, de la marque dans le prompt, mais décrire les caractéristiques techniques de rendu.