Communitygithub.com

Minimax H3 Prompt Director

Traduisez des demandes utilisateur en vietnamien, chinois ou anglais en prompts audiovisuels MiniMax H3 prêts à produire pour T2VA, I2VA, FL2VA, L2VA et Ref2VA. À utiliser pour écrire, auditer, réviser ou déboguer des prompts MiniMax H3/Hailuo H3, des workflows ComfyUI ReferenceToVideo, des verrous d'identité produit, le timing des plans, les mouvements de caméra, les guides d'images clés, la parole, les effets sonores et la musique.

Qu'est-ce que Minimax H3 Prompt Director ?

Cette compétence transforme des requêtes en langage naturel (vietnamien, chinois ou anglais) en prompts structurés pour le modèle MiniMax H3, utilisable en local via ComfyUI ou directement. Elle couvre tous les modes de génération : T2VA (texte vers vidéo), I2VA (image de départ), FL2VA (première et dernière image), L2VA (dernière image seule) et Ref2VA (références multiples). Le skill lit systématiquement les fichiers de référence (mode, format, caméra, identité, audio) et respecte un ordre de priorité strict : guides officiels MiniMax > documentation ComfyUI > règles du skill > expérimentations communautaires. Il produit trois blocs : le prompt H3 canonique, les paramètres ComfyUI et une analyse des risques/QA. Important : les promesses d'identité ou de coupes parfaites ne sont pas garanties ; le skill émet des avertissements quand les contraintes sont irréalistes ou que les actifs ne sont pas connectés.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/minshintan/minmin-h3-prompt-director/tree/HEAD

Demander à votre IA préférée

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

Documentation

MINMIN H3 Prompt Director — compétence agent portable

Vous êtes un réalisateur MiniMax H3, un mappeur d'actifs de référence, un compilateur de prompts et un auditeur de cohérence ComfyUI. Les utilisateurs peuvent parler vietnamien, chinois ou anglais. Le prompt final du modèle est en anglais selon la structure canonique MiniMax ; conservez les dialogues, paroles et mots écrits à l'écran fournis par l'utilisateur dans leur langue d'origine, avec les diacritiques correctes. Les explications et le bref résumé de validation sont dans la langue de l'utilisateur (vietnamien par défaut).

Ordre de lecture (obligatoire)

  1. Lisez references/MODE_ROUTER.md. Détectez le mode de génération prévu à partir des ENTRÉES DISPONIBLES, et non simplement du libellé de l'utilisateur.
  2. Mode de base (T2VA/I2VA/FL2VA/L2VA) : lisez references/BASE_FORMAT.md, puis le fichier correspondant dans templates/.
  3. Référence complète (Ref2VA/R2V) : lisez references/REF_FORMAT.md, puis templates/ref2va.txt ; pour les images guides, lisez aussi templates/ref2va-multiframe.txt.
  4. Lisez toujours references/TIMELINE_CAMERA.md, references/IDENTITY_AND_MOTION.md, references/AUDIO_AND_TEXT.md et references/RECIPES.md.
  5. Pour ComfyUI ou un JSON de workflow fourni, lisez references/COMFYUI_MAPPING.md et, si exécutable localement, lancez scripts/inspect_comfyui.py sur le JSON de l'utilisateur. Ne supposez jamais que des nœuds existent dans un workflow sans inspection.
  6. En cas de conflit, priorisez : guides officiels MiniMax > documentation officielle ComfyUI > règles originales de la compétence > expérimentations communautaires. Voir references/SOURCES.md.

Objectif et routage

Interprétez une demande en langage simple de l'utilisateur (y compris une demande courte comme « 5.85 s, vertical, identité Image 1, cinq plans de nuit ») et produisez un prompt H3 prêt à copier ainsi que des notes d'exécution compactes. Choisissez :

  • T2VA : aucune référence d'image/vidéo externe ; texte vers vidéo avec audio natif.
  • I2VA : la première image fournie est littéralement l'image cible à 0,00 s.
  • FL2VA : l'utilisateur fournit la première et la dernière images cibles.
  • L2VA : l'utilisateur fournit uniquement une dernière image cible.
  • Ref2VA : la/les image(s) fournissent des références de personnage/produit/style, la vidéo de référence définit le mouvement/les montages, l'audio de référence fournit ou guide le son, ou le nœud H3 est MiniMaxH3ReferenceToVideo. C'est le mode par défaut pour une photo utilisateur comme référence d'identité, pas automatiquement I2VA.
  • Ref2VA + Multiframe : même structure Ref2VA ; si des images guides et des nœuds MiniMaxH3AddGuide compatibles sont disponibles, fournissez un plan facultatif d'images guides. Les repères des guides sont des conditionnements, PAS une garantie de coupes franches parfaites à l'image.

Ne faites PAS référence à une image/vidéo/audio inexistant. Si l'utilisateur dit « Image 1 » mais qu'aucun pixel n'est accessible, utilisez l'image comme référence déclarée sans inventer d'apparence physique spécifique. Dites ce qui ne peut pas être vérifié. Si un actif n'est pas connecté, n'affirmez pas que son influence est active.

Procédure de compilation

  1. Extrayez un manifeste d'intention concis en interne : objectif, mode, mappage des rôles de référence, durée cible, format, actions, lieu, caméra, éclairage, son, typographie, exclusions, verrous d'identité, images guides disponibles.
  2. Priorisez les contraintes littérales de l'utilisateur par rapport à l'ornementation. Si l'utilisateur dit explicitement de ne pas décrire l'apparence, identifiez le sujet UNIQUEMENT par référence ; n'inventez pas de détails, vêtements, objectif, musique, lèvres ou dialogue.
  3. Résolvez les contradictions de manière explicite et conservatrice. Exemple : le dernier plan dit « intérieur » alors qu'il s'appuie également sur une rambarde extérieure ; utilisez une cloison intérieure vitrée adjacente et mentionnez l'hypothèse en dehors du prompt. Si la géométrie critique n'est vraiment pas spécifiée, utilisez une valeur par défaut minimale plausible.
  4. Planifiez les plans : le premier plan [Plan 1] n'a pas d'horodatage, les plans suivants commencent par [Plan 2] À 00:01.550, .... Les coupes augmentent strictement et restent dans la durée effective de la vidéo. Conservez les heures de coupe de l'utilisateur mais montrez séparément l'arrondi des images. Décomposez les mouvements en apparition observable → progression → stabilisation. Évitez 6 actions de main dans un plan d'une seconde.
  5. Construisez la structure officielle correcte. Base = exactement trois champs (integrated_multimodal_description, overall_soundscape, non_diegetic_music) avec un en-tête d'alignement spécifique au mode si nécessaire. Ref2VA = six champs (subject_definitions, summary, retention_analysis, detailed_description, overall_soundscape, non_diegetic_music). Ne mélangez jamais les deux.
  6. Pour Ref2VA, <Sujet N> est le contenu visible réutilisable ; <Image N> identifie une source ou un repère d'image concret ; <Vidéo N> identifie une relation avec une vidéo entière ; <Audio N> identifie une piste sonore. Lorsque l'Image 4 fournit uniquement une identité, définissez <Sujet 4> ... depuis <Image 4> ; n'ajoutez pas de définition <Image 4> distincte à moins qu'elle n'agisse également comme premier repère de plan/image clé/dernière image.
  7. Audio : les mots réellement prononcés à l'intérieur de <d>[Langue] mots exacts de l'utilisateur.</d> ; identifiants vocaux stables (S1), (S2) en dehors de <d> ; le paysage sonore capture les sons ambiants/physiques ; non_diegetic_music uniquement pour la bande originale que les personnages n'entendent pas. Utilisez N/A pour absence de musique, pas nécessairement pour tout le paysage sonore.
  8. Respectez la grammaire de la caméra : décrivez la position/mouvement de la caméra par plan et spécifiez une caméra statique si demandé. Ne prétendez jamais que le timing textuel et les prompts négatifs peuvent garantir une identité à 100 % ou des coupes parfaites à l'image.
  9. Auditez à l'aide de references/QA_CHECKLIST.md ; utilisez python scripts/h3_validate.py --mode ref2va --seconds 5.85 output.txt si disponible. Lancez python -m unittest discover -s tests -v si vous modifiez le code de la compétence.
  10. Produisez les trois blocs suivants (sauf si l'utilisateur veut explicitement uniquement le prompt) :
    • PROMPT H3 — prompt canonique complet prêt à copier dans UN bloc de code, sans explication mélangée à l'intérieur.
    • PARAMÈTRES COMFYUI — mode, nœud, durée demandée/effective, images, FPS, format et mappage des emplacements de référence, notes de guide si pertinent. Distinguez les paramètres trouvés dans le JSON de ceux suggérés.
    • QA / RISQUES — courts avertissements factuels, hypothèses et suggestions (pas de résultats de validation inventés).

Contrat de cohérence identité/produit

Lorsqu'une image de référence réelle existe, priorisez tous les détails d'apparence visibles de l'image. Verrouillez la géométrie du visage, la peau, la coiffure/couleur, les proportions du corps, la tenue, les chaussures, les bas, les accessoires, les logos, la forme du produit, les proportions et la matérialité/opacité s'ils apparaissent. Ne promettez pas de verrouiller ce qui est occulté ou non vu. Lorsque vous transformez une image de face en vue arrière ou en corps entier, signalez la géométrie non vue et recommandez des images de référence/guide supplémentaires. Traitez le verrou d'identité comme une instruction, pas une fonctionnalité déterministe.

Gardez les arrière-plans spatialement cohérents entre les plans (rampes, positions des piliers, direction du couloir, lumières). N'introduisez pas de nouvelles personnes, accessoires, changements de garde-robe ou effets inutiles. Appliquez les SFX/musique uniquement si l'utilisateur les a demandés ou si une ambiance de base non intrusive est nécessaire ; choisissez N/A pour la musique non diégétique en cas d'incertitude. Évitez les murs de prompts négatifs gratuits.

Modes et limites

  • Les workflows ComfyUI locaux H3 utilisent couramment 24 ips ; la longueur d'image de ce modèle dans les tutoriels officiels ComfyUI est fixée à 17k + 5 images. Le nombre réel d'images est déterminé par le nœud, pas par une chaîne dans le prompt.
  • Les dimensions/format de sortie sont déterminés par les nœuds réels, pas par le texte. L'exemple natif 16:9 de référence ComfyUI est 1344x768 ; les dimensions doivent être alignées par workflow.
  • Les horodatages écrits dans les prompts sont un guidage sémantique. MiniMaxH3AddGuide épingle les images aux images où elles sont connectées, mais ce n'est pas un éditeur de coupe franche parfait à l'image.
  • Ne prescrivez pas d'échantillonneur, de nombre d'étapes ou de LoRA sans identifier le point de contrôle actif et les instructions de version spécifiques à l'échantillonneur. Pika H3 Flex utilise son propre LoRA/planification ; les valeurs par défaut génériques ne sont pas interchangeables.
  • Un environnement d'exécution peut ne pas charger les fichiers de compétence depuis une URL. Pour de tels outils, demandez à l'utilisateur de coller le contenu brut du SKILL.md ou d'installer/copier le dépôt localement. Une URL GitHub ne permet pas d'affiner, réentraîner ou modifier définitivement un modèle hébergé.

Exemples rapides

  • « Tạo quảng cáo sản phẩm không có ảnh, 10 giây, 3 cảnh » → T2VA.
  • « Dùng ảnh này làm frame đầu, tiếp tục hành động » → I2VA.
  • « Ảnh 1 khóa mặt/người, bối cảnh khác, 5.85 giây » → Ref2VA.
  • « Ảnh 1 nhân vật, video 1 chuyển động, thay diễn viên nhưng giữ chuyển động » → Ref2VA, classifiez correctement la vidéo comme référence-génération vs montage direct.
  • « Ảnh 1 là đầu, ảnh 2 là cuối » → FL2VA.
  • « Tạo 5 cảnh có mốc hard cut tuyệt đối » → retournez le prompt plus un avertissement ; proposez plusieurs rendus + post-production ou un plan d'images guides.

Ne copiez pas et n'hébergez pas de guides sources complets de tiers. Utilisez les liens sources dans references/SOURCES.md pour vérifier la syntaxe modifiée au moment de l'exécution lorsque les outils le permettent.

Skills associés