Communitygithub.com

CheshireMew/ip-studio

Créez, verrouillez et réutilisez des personnages IP sur plusieurs sessions, générez automatiquement du contenu visuel et un pet de bureau Codex v2.

Qu'est-ce que ip-studio ?

IP Studio est une compétence d'agent spécialisée dans la création, la gestion et la réutilisation de personnages IP (propriété intellectuelle) sur différentes sessions. Elle permet de transformer des idées de personnages ou des images existantes en personnages stylisés et cohérents, puis de générer des visuels dérivés (avatars, bannières, couvertures) et même un pet de bureau interactif pour Codex v2. La compétence prend en charge l'ensemble du flux de travail : depuis la définition du personnage, la vérification de la cohérence du design, jusqu'à la génération d'animations, la validation et l'installation. Elle est conçue pour être utilisée avec des agents comme Claude Code, Cursor et Codex, et exploite des scripts Python pour gérer la structure, la génération d'images et les vérifications, déléguant à l'utilisateur uniquement les décisions qui modifient l'identité du personnage ou la direction de la communication. Le résultat final est un personnage verrouillé, réutilisable, avec un dossier de personnage complet, des visuels dérivés vérifiés et un pet de bureau prêt à l'emploi, le tout sans que l'utilisateur ait besoin de modifier du JSON ou de gérer manuellement les fichiers.

Compatible avec~Claude Code✓Codex CLI~Cursor
npx skills add CheshireMew/ip-studio

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

IP Studio

Transformez des indices d'identité épars ou des images de personnages existants en personnages stylisés réutilisables sur plusieurs sessions, puis utilisez la même identité pour créer des pages de réseaux sociaux, des visuels de diffusion d'articles et un pet de bureau Codex v2. Par défaut, la création d'un personnage livre une image de référence principale officielle, un dossier de personnage complet et une description ; les visuels dérivés livrent une image finale vérifiée pour la cohérence du personnage et le contenu, ainsi qu'un enregistrement traçable ; le pet de bureau livre neuf groupes d'animations d'état, seize directions de regard, des preuves QA complètes et un répertoire de pet directement installable. L'utilisateur ne fait que les choix qui changent l'identité, la direction de communication ou les installations existantes. La complétion de la structure, l'extraction du contenu, la génération d'images, la vérification, les nouvelles tentatives, la sauvegarde, l'assemblage et la validation sont effectués par l'Agent.

Premier Jugement

Choisissez d'abord le chemin principal en fonction du résultat indépendant que l'utilisateur souhaite obtenir :

  • Établir ou modifier une identité de personnage : Créer à partir de zéro, importer une image existante ou modifier un personnage verrouillé, entrez dans le "Chemin Principal de l'Identité du Personnage".
  • Créer un visuel dérivé de personnage : Avatar, bannière de page, carte de profil, couverture d'article, image explicative ou illustration de texte, entrez dans le "Chemin Principal du Visuel Dérivé". Si le personnage a déjà un pack verrouillé, consommez-le directement ; s'il n'y a qu'une image approuvée, importez et verrouillez d'abord le personnage automatiquement ; s'il n'y a pas encore de personnage, terminez d'abord le Chemin Principal de l'Identité du Personnage, puis revenez à la demande de dérivé actuelle.
  • Créer un pet Codex : Créez, vérifiez, empaquetez ou installez un personnage verrouillé en tant que pet Codex v2, entrez dans le "Chemin Principal du Pet Codex". Si le personnage a déjà un pack, consommez-le directement ; s'il n'y a qu'une image approuvée, importez et verrouillez d'abord le personnage automatiquement ; s'il n'y a pas encore de personnage, terminez d'abord le Chemin Principal de l'Identité du Personnage, puis revenez à la demande de pet.
  • Si une seule demande exige à la fois un personnage, un visuel dérivé ou un pet, verrouillez d'abord le personnage, puis terminez chaque résultat séparément ; le pet ne peut commencer qu'après le verrouillage de la version actuelle du personnage.
  • Le planning de marque personnelle ordinaire, les couvertures, images explicatives et illustrations générales sans personnage IP, les avatars numériques photoréalistes, les animations générales (autres que pet Codex), Live2D, vidéos, les pétards de bureau Windows indépendants et les autres plateformes de pet s'arrêtent ici, en expliquant directement les limites de capacité adjacentes.
  • Si l'utilisateur nomme seulement $ip-studio, traitez comme une création à partir de zéro.

Limites de l'Information et des Actions

Utilisez les informations dans l'ordre suivant :

  1. La demande actuelle et les choix explicitement exprimés par l'utilisateur.
  2. Les indices d'identité, d'utilisation et d'esthétique déjà apparus dans la conversation en cours.
  3. Les images, documents, liens et dossiers de personnages fournis ou explicitement indiqués par l'utilisateur.
  • Lorsque le matériel du personnage est suffisant pour déterminer l'utilisation, le public, la forme du personnage, l'impression souhaitée et le style final, continuez directement.

  • S'il manque des informations qui changeraient la direction du personnage, organisez les solutions possibles en trois fiches de direction complètes et laissez l'utilisateur choisir ou combiner, ne diffusez pas de questionnaire.

  • Lorsque l'utilisateur confie explicitement le choix à l'Agent, adoptez la fiche la plus adaptée à l'utilisation et expliquez le choix.

  • Pour les visuels dérivés, lisez d'abord le contenu actuel, le pack de personnage spécifié par l'utilisateur et l'image de référence principale, puis lisez le logo, l'interface, les données ou les documents visuels fournis par l'utilisateur.

  • Ne soumettez un choix spécifique à l'utilisateur que lorsque les faits, le nom, la direction de la marque ou le récit central ne peuvent être déterminés à partir du matériel ET que différentes réponses changeraient l'image finale.

  • Pour les recadrages et les zones de sécurité de la plateforme, si la spécification actuelle est requise et que l'utilisateur n'a pas fourni de capture d'écran ou de dimensions, consultez la documentation officielle de cette plateforme.

  • Pour le chemin du pet, lisez d'abord le dossier du personnage actuel et l'image de référence principale, puis lisez les autres références visuelles explicitement fournies par l'utilisateur.

  • Continuez directement lorsque le nom du personnage, le nom du pet, le style et le tempérament des actions peuvent être déduits de manière stable du pack de personnage.

  • Ne soumettez à l'utilisateur qu'un seul compromis lorsque un seul trait fixe ne peut pas maintenir simultanément l'identité et la géométrie 192×208 du pet.

  • Ne recherchez pas activement en ligne des indices de marque, sauf si l'utilisateur demande explicitement de compléter les indices de marque publics pour une demande qui n'a qu'un nom de marque et aucune direction de personnage.

  • L'appel à cette Compétence est autorisé, dans la tâche en cours, à visualiser les images fournies par l'utilisateur, à utiliser les capacités existantes de génération d'images et de visualisation, et à créer des packs de personnages, des visuels dérivés et des répertoires d'exécution de pet dans l'espace de travail inscriptible.

  • Lorsque l'utilisateur demande "crée un pet Codex utilisable", l'écriture dans le répertoire des pets Codex local est la dernière étape de ce résultat.

  • Si le même identifiant de pet est déjà occupé par un contenu différent, sauvegardez d'abord le répertoire existant et demandez une décision de remplacement.

  • Les autres installations, téléchargements, envois et publications ne sont effectués que si l'utilisateur le demande explicitement.

  • Ce flux ne supprime pas les versions de personnage existantes, les images dérivées officielles, les enregistrements d'exécution de pet ou les anciennes installations sauvegardées.

  • La langue de la réponse suit l'utilisateur.

  • Les dossiers internes utilisent des noms de clé en anglais fixes, l'utilisateur n'a pas besoin de les lire ou de les modifier.

Chemin Principal de l'Identité du Personnage

Distinguer d'abord la création à partir de zéro, l'importation d'une image existante et la modification d'un personnage verrouillé. Lors de l'importation, distinguez les caractéristiques que l'utilisateur souhaite conserver des détails accidentels de l'image actuelle. Lors de la modification, lisez character-profile.json et l'image de référence principale unique qui y est enregistrée ; la modification des caractéristiques fixes génère une nouvelle version.

Après être entré dans ce chemin, lisez references/character-system.md. Il est responsable de la direction du personnage, du diagnostic chibi, des entrées de génération d'images, de la vérification visuelle, des couleurs et du traitement des pièces complexes. Après avoir terminé chaque action professionnelle, revenez à l'étape correspondante de cette section.

1. Établir un dossier en attente de confirmation

Exécutez python scripts/character_kit.py schema pour lire le contrat de dossier actuel. Si vous avez besoin d'un brouillon de fichier, exécutez :

python scripts/character_kit.py draft <draft-profile-path> --character-id <slug> --display-name <name> --language <language>

Écrivez d'abord les informations connues dans le brouillon. Lorsque la direction chibi n'est pas encore déterminée, les champs non sélectionnés peuvent rester vides temporairement. Avant la génération formelle des images, le dossier de reconstruction complet doit être complété en fonction du choix de l'utilisateur ou des images déjà approuvées. Le dossier enregistre respectivement la forme et les proportions, chaque partie de la tête et du visage, le torse et les membres, les appendices (queue, ailes, etc.), l'emplacement et les relations de surface de chaque couleur, les limites des motifs, les zones de texture, la hiérarchie et les connexions des vêtements, la géométrie et la méthode d'installation des éléments emblématiques, la structure de face, de côté et de dos, la méthode de rendu et les limites de cohérence.

  • L'Agent décide activement des détails de profil, de dos, de couture et de texture qui ne changent pas la direction du personnage, et les marque comme agent_inferred dans provenance.decisions.
  • Les divergences qui modifient le contour, le visage, la palette de couleurs principale, l'élément emblématique ou la signification du personnage sont soumises à l'utilisateur.
  • Avant la génération formelle des images, exécutez :
python scripts/character_kit.py prompt <draft-profile-path> --purpose master

Cette commande vérifie d'abord si le dossier est complet, puis génère le prompt d'identité complet à partir du dossier. Les générations d'images suivantes utilisent le prompt de sortie de la commande ; n'écrivez pas une autre description d'identité. La pose, l'action, la scène, le cadre et l'objectif sont uniquement transmis via le --task de la commande en cours.

2. Concevoir avec un diagnostic chibi

Générez indépendamment trois brouillons de diagnostic à partir du même dossier en attente de confirmation. Chaque brouillon est un personnage unique, avec des lignes claires, des détails retenus, environ 3,5 têtes, une pose neutre de face et un arrière-plan propre. Les trois brouillons doivent former de véritables différences de contour, de forme du personnage ou de symbole central, pas seulement un changement de couleur.

  • Après la génération, examinez chaque brouillon. Le contour principal et un point de mémorisation principal doivent rester valables même en vignette, et il ne doit pas y avoir de membres manquants, de rupture structurelle, de texte non pertinent ou d'accumulation de design.

  • À ce stade, le dossier reste un design provisoire : seules les erreurs techniques ou les violations des caractéristiques déjà confirmées par l'utilisateur sont automatiquement éliminées. Les images structurellement valides et identifiables mais qui modifient des détails non encore confirmés sont conservées comme une nouvelle branche, et les changements sont expliqués à l'utilisateur.

  • Si une image échoue réellement, remplacez-la à partir du dossier original, ne continuez pas à éditer à partir de l'image échouée.

  • Présentez les trois images passant l'inspection, accompagnées d'une brève différence, à l'utilisateur pour qu'il choisisse ou combine.

  • Si l'image existante a déjà été approuvée par l'utilisateur et que l'utilisateur souhaite seulement établir un dossier, sautez cette étape.

  • Lors de la modification d'un personnage verrouillé, revenez à cette étape uniquement si le contour, le visage, la palette de couleurs principale ou l'élément emblématique sont redessinés.

3. Générer l'image de référence principale officielle

Écrivez le choix de l'utilisateur dans le dossier en attente de confirmation, complétez la structure requise par la référence point par point, puis utilisez le script pour générer le prompt complet pour les candidats officiels. Le critère de réussite est : un autre Agent peut dessiner le même personnage (face, profil, dos) à partir du dossier sans avoir à deviner les détails clés de l'identité. Le chibi ne fournit que la preuve du choix actuel, il n'entre pas dans le pack de personnage et ne devient pas une référence pour les générations futures.

  • L'image de référence principale officielle doit être : personnage unique, en pied, de face ou légèrement trois-quarts, pose neutre, arrière-plan propre, sans texte, étiquette ou puzzle ; tous les traits fixes doivent être directement visibles.

  • Comparez d'abord le dossier avec l'image, puis comparez l'intégrité technique.

  • Les erreurs de génération évidentes sont corrigées automatiquement, avec un maximum de deux corrections pendant la phase officielle.

  • Lorsque la palette de couleurs de base, le contour, le visage ou l'élément emblématique changent, créez une nouvelle branche à partir du dossier actuel et redessinez.

  • Seuls les défauts de rendu peuvent être réparés localement ; après la réparation, revérifiez tous les traits fixes.

  • Si la même pièce complexe est incorrecte deux fois de suite, déterminez d'abord sa géométrie, ses proportions, sa texture, sa connexion, sa visibilité dans chaque vue et son mouvement selon la branche de pièce dans la référence, écrivez la structure confirmée dans le dossier, puis laissez le script régénérer le prompt complet et l'image entière du personnage.

  • Présentez le candidat officiel ayant passé l'inspection à l'utilisateur et demandez l'approbation finale.

  • Si l'utilisateur a explicitement autorisé l'Agent à finaliser dans la demande en cours, l'Agent peut choisir l'image la plus conforme au dossier.

4. Vérifier la réutilisabilité

Après l'approbation de l'image finale, vérifiez d'abord la correspondance entre la structure réellement établie dans l'image et le dossier : les modifications de conception approuvées par l'utilisateur sont écrites dans les champs correspondants, les détails générés accidentellement n'écrasent pas les paramètres confirmés existants. Ensuite, exécutez :

python scripts/character_kit.py prompt <draft-profile-path> --purpose consistency --reference <approved-master-image> --task <different-pose-expression-and-simple-background>

Transmettez le prompt et la master_reference de sortie de la commande ensemble à la capacité de génération d'images pour générer une image de test de cohérence avec une pose différente, une expression différente et un arrière-plan simple. L'image de test doit conserver la forme, le visage, l'emplacement des couleurs, la connexion des vêtements, la texture et l'élément emblématique. Elle sert uniquement à cette vérification, n'entre pas dans le pack de personnage et ne sert pas de référence ultérieure.

  • Si le test échoue, déterminez d'abord s'il s'agit d'un manque de description dans le dossier ou d'une instabilité de l'image de référence principale, puis mettez à jour le producteur correspondant et réessayez. Maximum deux corrections.
  • Si un trait approuvé doit encore être abandonné, soumettez ce compromis unique à l'utilisateur.

5. Verrouiller le pack de personnage sans perte

Après que le personnage a passé la vérification de cohérence, utilisez ip-studio-output/<character-slug>/ dans l'espace de travail inscriptible actuel. Transmettez le dossier en attente de confirmation et l'image de référence principale officielle au script :

python scripts/character_kit.py finalize <kit-folder> --profile <draft-profile-path> --master <master-image-path>
python scripts/character_kit.py check <kit-folder>
  • finalize vérifie le dossier et l'image avant l'écriture. Si un personnage existe déjà, il incrémente la version, enregistre l'ancien dossier et la description dans history/rNNN/, et conserve l'ancienne image de référence principale.
  • En cas d'échec de la commande, lisez l'erreur, corrigez l'entrée de production et réessayez, n'écrivez pas manuellement le numéro de version, la valeur de contrôle ou le fichier de description que le script devrait générer.

Après la réussite du script, lisez à nouveau character-profile.json et character-guide.md, ouvrez réellement l'image pointée par assets.master_reference, et exécutez une fois python scripts/character_kit.py prompt <kit-folder> --purpose scene --task <simple-reuse-task> pour confirmer que les aval peuvent lire le dossier actuel et l'image de référence principale. Le personnage n'est considéré comme verrouillé que si le dossier, la description, l'image et le prompt dérivé sont cohérents et que la vérification check est réussie.

Chemin Principal du Visuel Dérivé

Ce chemin consomme uniquement les identités de personnage déjà verrouillées. Lisez references/visual-production.md. Il est responsable du brief, de la composition, de la génération d'images, de la vérification et de l'archivage pour les avatars, bannières de page, cartes de profil, couvertures d'articles, images explicatives et illustrations de texte. Après avoir terminé chaque action professionnelle, revenez à cette section.

1. Déterminer le résultat actuel

Décomposez la demande en un ou plusieurs résultats explicites :

  • avatar : Avatar 1:1 adapté à la fois au recadrage rond et carré. Si l'utilisateur dit "ensemble d'avatars", générez respectivement une version simplifiée (type badge) et une version riche (type portrait).
  • profile-banner : Bannière de page générique 3:1 si aucune plateforme n'est spécifiée. Si une plateforme est spécifiée, composez en fonction de la zone de recadrage et de masquage réelle.
  • profile-card : Carte de profil mobile 4:5 par défaut.
  • cover : Couverture d'article fixe 5:2.
  • explainer : Image explicative, choisissez le format 4:5, 3:4 ou 16:9 en fonction du contenu.
  • article-illustration : Illustration de texte fixe 16:9.
  • Si l'utilisateur dit "page de garde", générez par défaut l'avatar et la bannière de page. N'ajoutez la carte de profil que si elle est explicitement demandée.
  • Chaque résultat a son propre brief, génération, vérification et archivage, partageant la même version de personnage.
  • Un résultat n'emprunte pas les images candidates d'un autre résultat pour continuer la dérivation.

2. Établir un brief visuel

Exécutez d'abord python scripts/visual_kit.py schema, puis l'Agent crée et remplit le brouillon :

python scripts/visual_kit.py draft <brief-path> --kind <kind> --visual-id <slug> --language <language>

Déterminez l'objet central, les lacunes de compréhension, le mécanisme ou le changement, la conclusion après visualisation, le rôle de la marque, la structure unique principale, l'action du personnage, le titre, les étiquettes et la palette de couleurs, en fonction de la véritable source du contenu. Les couvertures, images explicatives et illustrations de texte sont exécutées selon le contrat actuel de references/visual-production.md.

  • Le personnage doit jouer un rôle causal dans le visuel du contenu : recevoir, déplacer, connecter, diviser, sélectionner, bloquer, transformer ou subir l'objet central personnellement, et produire un résultat visible.
  • L'avatar a pour objectif la reconnaissance en vignette.
  • La bannière de page et la carte de profil font interagir le personnage avec le symbole central de manière authentique.
  • L'utilisateur n'a pas besoin de voir ou de modifier le brief.

3. Générer et vérifier automatiquement

Exécutez :

python scripts/visual_kit.py prompt <kit-folder> --brief <brief-path>

Transmettez le prompt de sortie de la commande et les image_references classées dans l'ordre ensemble à la capacité de génération d'images. Ils proviennent respectivement du dossier de personnage actuel, de l'image de référence principale unique, du brief visuel et des autres images fournies par l'utilisateur. N'écrivez pas un deuxième prompt d'identité ou de contenu.

  • Après la génération, ouvrez réellement l'image et vérifiez, dans l'ordre de la référence : la cohérence du personnage, l'exactitude factuelle du contenu, le rôle causal de l'action du personnage, la structure d'information unique, la hiérarchie mobile, la lisibilité du texte et du logo, et l'intégrité technique.
  • En cas d'échec, corrigez le jugement de brief le plus ancien qui a causé l'erreur, puis redessinez à partir du dossier de personnage original et des données de contenu. Maximum deux corrections automatiques par résultat formel.
  • S'il est encore nécessaire de modifier un fait, un point central du récit ou un trait fixe du personnage, soumettez uniquement ce compromis unique à l'utilisateur.

4. Archiver l'image finale

Après l'approbation de l'utilisateur ou la finalisation autorisée par l'Agent, exécutez :

python scripts/visual_kit.py finalize <kit-folder> --brief <brief-path> --image <approved-image>
python scripts/visual_kit.py check <visual-folder> --kit <kit-folder>
  • Le résultat formel est écrit dans <kit-folder>/derivatives/<kind>/<visual-id>/. Il contient l'image finale, le brief visuel, un instantané du dossier de personnage actuel, l'entrée complète de génération d'images, une copie des données d'entrée et un enregistrement de vérification. Le dossier de personnage actuel, l'image de référence principale et l'historique des versions restent inchangés.

  • Les images candidates, les nouvelles tentatives automatiques et les éléments de vérification de cohérence restent uniquement dans le répertoire temporaire de la tâche.

  • Après la réussite du script, lisez à nouveau visual-record.json, ouvrez réellement l'image finale qui y est enregistrée, et confirmez que la version du personnage, l'image de référence principale, le brief visuel, l'entrée de génération d'images et la valeur de contrôle de l'image finale sont tous lisibles.

  • Arrêtez-vous une fois la demande actuelle satisfaite, ne passez pas automatiquement à d'autres formats, mèmes ou médias.

Chemin Principal du Pet Codex

Ce chemin consomme uniquement les identités de personnage déjà verrouillées. Après y être entré, lisez references/pet-production.md. Il est responsable du contrat de la feuille de sprites Codex v2, des neuf groupes d'états, des seize directions, de la génération d'images ligne par ligne, de l'assemblage déterministe, de la revue à l'aveugle, de l'aperçu dynamique, du répertoire final et de l'installation. L'identité du personnage, les mises à niveau et les autres visuels dérivés sont toujours gérés par leurs chemins principaux respectifs.

Au début, établissez une progression visible en quatre étapes, et n'avancez qu'après l'existence de fichiers réels ou de décisions :

  1. Préparer le répertoire d'exécution du personnage et du pet.
  2. Générer l'image principale du pet à la taille du pet.
  3. Générer et vérifier toutes les actions et directions de regard.
  4. Assembler, valider et installer le pet.

1. Établir un répertoire d'exécution connecté au pack de personnage

Appelez d'abord le chargeur de dépendances de l'espace de travail, et utilisez le chemin absolu Python qu'il renvoie pour chaque commande de ce chemin. Exécutez :

"<workspace-python>" -B scripts/pet_kit.py schema
"<workspace-python>" -B scripts/pet_kit.py prepare <kit-folder>
"<workspace-python>" -B scripts/pet_kit.py check <run-folder> --stage prepared
  • prepare génère la description d'identité complète à la taille du pet à partir de character-profile.json, copie un instantané vérifiable du dossier, de la description et de l'image de référence principale unique du personnage, et génère les tâches formelles pour l'image de base, les neuf groupes d'actions, les quatre points d'ancrage directionnels et les deux rangées de directions.
  • Par défaut, crée une nouvelle exécution dans <kit-folder>/derivatives/codex-pet/<pet-id>/runs/rNNN/, sans écraser les anciennes exécutions.
  • Les accessoires indépendants comme les lanternes de queue restent indépendants et peuvent se balancer, tout en rendant le chemin de force entre les points fixes, les colliers, les sangles, les anneaux et les accessoires visiblement continu dans 192×208.

2. Générer l'image principale du pet et les actions standard

Avant la génération d'images, chargez complètement la compétence $imagegen de l'environnement actuel. Exécutez pet_kit.py ready <run-folder> et ne traitez que les ready_jobs retournés. Chaque tâche lit le prompt et toutes les entrées d'image enregistrés dans imagegen-jobs.json. L'image de base peut partir uniquement du pack de personnage, mais les autres lignes doivent inclure l'image de référence principale du personnage, l'image principale du pet et la référence de disposition correspondante.

Après avoir sélectionné le résultat, ouvrez réellement l'image, puis exécutez :

"<workspace-python>" -B scripts/pet_kit.py accept-job <run-folder> --job <job-id> --source <image> --qa-note <visible-evidence>

Cette commande écrit le résultat accepté dans la position formelle, exécute la vérification déterministe de cette phase et met à jour les dépendances.

  • Une fois l'image de base acceptée, générez neuf groupes d'animations : idle, déplacement gauche/droite, signe de la main, saut, échec, attente, exécution de tâche et résultat de vérification. Chaque groupe utilise le nombre d'images et la sémantique d'application définis par la référence.

  • Les lignes d'action indépendantes peuvent être générées en parallèle (trois maximum) si l'environnement le permet. L'utilisateur n'a pas besoin de planifier les tâches.

  • Lorsque le retournement gauche-droite ne modifie pas les motifs du visage, la direction de la lumière, les accessoires unilatéraux et la signification de l'élément emblématique, running-left peut être obtenu à partir de running-right approuvé en utilisant le script de mise en miroir image par image spécifié par la référence. Les autres états sont générés séparément.

  • Une fois les neuf groupes d'actions acceptés, générez la feuille de sprites intermédiaire 8×9, l'image d'aperçu et neuf GIF selon la référence. Vérifiez visuellement l'identité, l'état, la direction, la boucle, l'échelle et la connexion.

3. Générer les seize directions de regard

L'Agent écrit qa/look-mechanics.md en fonction de la construction réelle de la tête, du visage, des yeux, du corps, des appendices et des accessoires du personnage, déterminant les points d'ancrage fixes, qui guide le regard, qui suit, les masquages pour chaque direction et l'amplitude de mouvement tous les 22,5 degrés.

  • Générez et approuvez d'abord les quatre points d'ancrage directionnels : haut, droite de l'écran, bas, gauche de l'écran.

  • Ensuite, générez deux familles de directions complètes de huit images : la 9ème ligne et la 10ème ligne.

  • Les lignes de direction sont interpolées uniformément à partir des poses approuvées des quatre directions. La 10ème ligne lit simultanément la 9ème ligne terminée, garantissant la continuité entre les lignes.

  • Si une direction unique échoue, refaites la ligne complète de huit images qui la contient. Ne mélangez pas des images de correction isolées dans la feuille de sprites finale.

  • accept-job enregistre les lignes de direction avec la même échelle, le même point d'ancrage inférieur et la même ligne de base, et vérifie les bords des images formelles avant de passer à la phase suivante.

  • Si des actions ou directions déjà acceptées échouent lors des vérifications ultérieures (aperçu, GIF, continuité ou revue à l'aveugle), utilisez la même commande accept-job avec l'ajout --replace-complete pour accepter une image de remplacement.

  • Le script déplace la tâche remplacée, les tâches qui en dépendent et les artefacts invalides dans un historique versionné, puis continue à partir du point d'échec le plus ancien. Ne modifiez pas manuellement l'état de la tâche et n'utilisez pas d'anciens atlas.

4. Vérification finale, produit fini et installation

Après la fin des lignes de direction, appliquez une seule fois le retrait de la couleur du fond sur les bords de la feuille de sprites complète 8×11 selon la référence, puis exécutez successivement : vérification de la taille v2 et de la transparence, aperçu standard et final, neuf GIF, image des seize directions, mesure de la continuité adjacente et trois revues à l'aveugle de direction isolée.

  • Le résultat final de la visualisation indépendante et les preuves visibles pour chaque direction sont écrits dans le fichier QA spécifié par la référence.
  • Les quatre directions correctes, l'identité du personnage, la connexion des accessoires, les états d'action et la géométrie de la feuille de sprites doivent tous passer la vérification avant la finalisation.

Exécutez :

"<workspace-python>" -B scripts/pet_kit.py finalize <run-folder>
"<workspace-python>" -B scripts/pet_kit.py check <run-folder> --stage final
"<workspace-python>" -B scripts/pet_kit.py install <run-folder>
  • finalize relit l'instantané du personnage, les treize tâches visuelles, le rapport déterministe et les conclusions de la visualisation, puis génère le répertoire de pet officiel contenant uniquement pet.json et spritesheet.webp.
  • install l'écrit dans le répertoire actuel des pets Codex. Si le même contenu existe déjà, n'écrivez pas en double. Si un contenu différent occupe le même identifiant, revenez à la section "Limites de l'Information et des Actions" pour gérer la décision de remplacement.
  • Après l'installation, ne redémarrez pas l'application ou n'activez pas le paramètre à la place de l'utilisateur.

En cas d'absence d'outils

  • Chemin de l'identité du personnage sans capacité de génération d'images : terminez la sélection de direction et le dossier complet en attente de confirmation, exécutez character_kit.py prompt --purpose master et livrez son résultat, en précisant clairement que l'image et le pack de personnage ne sont pas encore terminés.
  • Chemin du visuel dérivé sans capacité de génération d'images : terminez le brief visuel et exécutez visual_kit.py prompt, livrez le jugement de diffusion complété et l'entrée de génération d'images, en précisant clairement que l'image finale et l'archive dérivée ne sont pas encore terminés.
  • Chemin du pet sans capacité de génération d'images : terminez pet_kit.py prepare, livrez le répertoire d'exécution connecté au pack de personnage, la carte de tâche complète et le premier prompt d'image de base, en précisant clairement que les actions, la feuille de sprites et l'installation ne sont pas encore terminés.
  • Sans capacité d'exécution de visualisation indépendante : après avoir terminé toutes les vérifications déterministes, soumettez uniquement les images de revue à l'aveugle de direction et l'aperçu final à l'utilisateur pour confirmation. Ne falsifiez pas les trois revues à l'aveugle ou la conclusion finale indépendante.

Livraison et Arrêt

  • Chemin de l'identité du personnage : La première phrase indique directement si le personnage est verrouillé ou non. À la fin, affichez l'image de référence principale officielle, et expliquez le point de mémorisation central, la version actuelle et le chemin absolu du pack de personnage. Ensuite, énumérez les options de dérivation possibles, mais ne continuez que le résultat que l'utilisateur nomme actuellement.
  • Chemin du visuel dérivé : La première phrase indique directement si l'image est terminée ou ce qui manque. À la fin, affichez d'abord chaque image finale, puis expliquez en une phrase la relation centrale qu'elle exprime, la version du personnage utilisée et le chemin de sauvegarde absolu. L'utilisateur n'a pas besoin de copier le prompt, de modifier du JSON, de numéroter manuellement, de créer des branches ou de trier les images.
  • Chemin du pet : La première phrase indique directement si le pet a été généré et installé. À la fin, affichez d'abord l'image d'aperçu finale et au moins un aperçu d'action, puis expliquez le nom du pet, la version du personnage utilisée, si les neuf groupes d'états et les seize directions sont passés, le répertoire du produit final formel et le chemin d'installation absolu. Enfin, rappelez simplement à l'utilisateur de redémarrer ou de rouvrir Codex, et d'activer le pet dans les paramètres.

Critères de complétion :

  • Le pack de personnage contient le dossier actuel, la description, l'image de référence principale unique et un historique de version lisible. Les brouillons de diagnostic chibi et l'image de test de cohérence ne deviennent pas des références à long terme.
  • Les images dérivées lisent les résultats de production réels du pack de personnage et le contenu de l'utilisateur, et l'identité du personnage et la relation de communication sont toutes deux vérifiées par une inspection visuelle réelle.
  • Chaque répertoire de visuel dérivé formel peut revérifier la version du personnage, le brief visuel, l'entrée de génération d'images, les données d'entrée et l'image finale.
  • Le répertoire d'exécution du pet peut revérifier l'instantané du personnage, l'image de référence principale, les treize tâches visuelles, les neuf aperçus d'action, la sémantique des seize directions, la revue à l'aveugle, le traitement de la transparence, la feuille de sprites v2 et le répertoire de pet officiel.
  • Les images dérivées et le pet n'ont pas modifié rétroactivement l'identité du personnage. Les autres visuels, animations ou versions de plateforme non nommés ne sont pas générés automatiquement.

Skills associés