Chans-gh/ai-coding-video

AI Coding Video : Bibliothèque de styles pour créer des vidéos avec du code

Le contenu et la méthode de maintenance se trouvent dans README.md. Ce fichier explique uniquement comment l'assistant AI consulte et utilise la bibliothèque.

Quand l'utiliser

• L'utilisateur souhaite définir un style pour une vidéo, ou demande « Quels styles existent / quel style convient à X ? ».
• Il a besoin d'une description de style pour rédiger un prompt visuel ou écrire directement du code de rendu (Canvas, WebGL, SVG, Three.js, Manim, Remotion, etc.).
• L'utilisateur veut d'abord voir l'effet d'un style dans son propre projet (échantillon) ou souhaite figer le style choisi (pack de style).
• L'utilisateur dispose de séquences vidéo, d'enregistrements, de photos, de données, ou souhaite utiliser des médias générés par IA (images, vidéos, synthèse vocale) et les assembler par code.
• Il faut choisir une musique de fond, des effets sonores ou un timbre de voix off en chinois pour la vidéo.

Utilisation en trois niveaux : du choix du style au pack de style

Niveau	Que faire	Résultat	Quand
Niveau 0 : Dictionnaire	Sélectionner 2 à 3 candidats dans cette bibliothèque, donner le prompt et la justification	Liste de candidats + prompt de style et chemin technique pour chacun	L'utilisateur n'a pas encore choisi de style
Niveau 1 : Échantillon	Appliquer les candidats avec les couleurs, polices et contenu réels du projet, dans la stack technique du projet (3 à 5 secondes)	Un échantillon en paysage 16:9 et un en portrait 9:16 + mosaïque d'images clés, à montrer à l'utilisateur	Le projet change de style ou en ajoute un, en une seule conversation
Niveau 2 : Pack de style	Pour le style approuvé, couvrir les présentations courantes du projet (générique, explication, données, transitions, sous-titres, etc.)	Modules de code réutilisables + spécification de style intégrée aux règles du projet (palette, polices, mouvement, son, interdits)	Après approbation du niveau 1

Chaque niveau nécessite l'accord de l'utilisateur avant de passer au suivant. Avant l'échantillon de niveau 1, vérifier que le chemin technique fonctionne dans l'environnement de l'utilisateur (navigateur, GPU, environnement Python, etc.).

Comment consulter (dans l'ordre, ne pas tout lire d'un coup)

1. Je ne sais pas lequel choisir → Commencer par distinguer les trois catégories : image entièrement calculée par code (C), média réel (T), média généré par IA (G). Si l'utilisateur précise le type de vidéo (dialogue, vente, clip, actualité…), consulter d'abord la table « Par type de contenu » dans index.md en faisant correspondre les colonnes T et G. Pour du pur code, chercher la ligne correspondante dans les autres tables d'index (thème, usage métier, public, émotion, plateforme et format, source et condition). Les styles qui apparaissent dans plusieurs tables sont prioritaires. Présenter 2 à 3 candidats avec justification.
2. Je connais le nom ou le numéro du style → Trouver le numéro (ex. C-013, T-007) dans la « Table des styles » de index.md, ouvrir le fichier styles/*.md correspondant (C par technique, T dans styles/footage.md, G dans styles/generated.md) et localiser l'entrée via l'ancre #C-013.
3. Je dois rédiger un prompt complet ou un code de rendu → Lire prompting.md : 8 points de contrôle, modèle général, chemin de production, exemples, problèmes fréquents et solutions.
4. Je veux filtrer par technique (ex. « uniquement SVG », « ceux avec Three.js ») → Lire tags.md et data/styles.json. Chaque entrée contient id / name / theme / content_type / materials / fit / prompt / layer / suggested / verified / render_code / pack / refs (C a theme ; T et G ont content_type et materials).
5. Je dois ajouter du son → Lire sound.md : d'abord choisir la musique et les effets sonores selon le thème, puis choisir le timbre de voix off selon l'usage.
6. Je dois utiliser des médias (catégories T, G) → Lire materials.md : provenance des sources, vérification des licences, génération, traitement unifié avant passage au code, choix du son.
7. Je dois produire un échantillon (niveau 1) ou un pack de style (niveau 2) → Lire making.md : vérifications préalables, écriture de l'échantillon et auto-contrôle, 5 méthodes pour le pack et contenu de STYLE.md.
8. Je dois écrire du code de rendu → Consulter d'abord le code fourni par ce skill : samples/API.md (squelette d'échantillon et mémo des fonctions), samples/<numéro>/ (fichiers scene.js, sound.py pour chaque style vérifié), packs/<nom>/ (packs de style). Le chemin dans le texte de lien « code d'échantillon » ou « pack de style » correspond à son emplacement dans le répertoire du skill ; pas besoin d'aller sur GitHub.

Règles d'utilisation

• Le bloc de code text dans une entrée est la phrase de prompt du style. L'utiliser telle quelle, puis la compléter avec le modèle de prompting.md (sujet, spécifications, son et déroulement).
• « Technique (vérifiée) » signifie que le code présent dans le dépôt peut produire un échantillon ; « Technique (suggérée) » est une recommandation non vérifiée. Préciser la différence à l'utilisateur.
• Se contenter du nom du style risque de produire un style plat générique : il faut inclure 3 à 5 éléments emblématiques, des interdits et des œuvres de référence.
• Les œuvres de référence n'apprennent que la composition, le rythme et la logique des couleurs ; ne pas copier les personnages, logos ou musiques. Pour les styles « hommage » (ex. C-187 style Ghibli) : apprendre uniquement la technique, tout le reste (personnages, décors, logos, dialogues) doit être original.
• Le prompt ne fixe qu'une direction ; le rendu n'est pas identique à chaque exécution. Pour reproduire le même effet, utiliser le code d'échantillon de l'entrée « Technique (vérifiée) » en modifiant le contenu, sans se fier au seul prompt et sans repartir de zéro : d'abord copier samples/<numéro>/ dans le projet de l'utilisateur, exécuter, puis remplacer le contenu (voir making.md « Niveau 1 : échantillon »). Si un « pack de style » existe, l'utiliser directement.
• Le code d'échantillon fournit le pipeline et la technique, pas le contenu : le pipeline de sortie (lib.js, synth.py, batch.py) peut être réutilisé ; les techniques de découpe, d'éclairage, de texture peuvent être empruntées ; mais les personnages, compositions, couleurs et textes de l'échantillon ne doivent pas être recopiés dans la vidéo de l'utilisateur – les remplacer par le sujet et la marque de l'utilisateur.
• Les informations sur la chaîne d'outils, les coûts et les temps dans les exemples proviennent des auteurs d'origine et n'ont pas été vérifiées. Ne pas les garantir à l'utilisateur.
• Les catégories C produisent des images entièrement par code, sans aucun média. Les visages réalistes, les dialogues humains en direct ne sont pas réalisables en pur code : passer à la catégorie T (propres médias de l'utilisateur) ou G (médias générés par IA) et indiquer ce qu'il faut préparer.
• Catégorie T : utiliser uniquement des médias dont l'utilisateur a confirmé les droits, ou des médias en domaine public / licence ouverte ; documenter chaque source et licence. Catégorie G : utiliser n'importe quel service de génération d'image, vidéo ou synthèse vocale, configuré selon materials.md « Configurer les services de génération ». Si une catégorie n'est pas configurée, informer l'utilisateur de ce qui doit être configuré ; continuer normalement les parties qui ne nécessitent pas de génération. Ne pas générer de vraies personnes, ne pas cloner une voix réelle.

Modifier le contenu

Les étapes pour ajouter ou modifier un style sont dans README.md sous « Maintenance ». Après modification, exécuter et valider :

python3 scripts/build_index.py          # Génère data/styles.json et la table des styles dans index.md à partir de styles/*.md
python3 scripts/build_index.py --check  # Vérifie la cohérence des numéros, tags, images, liens et tables

Les numéros de style sont créés et jamais modifiés ; data/styles.json et la table des styles sont générés, ne pas les modifier manuellement.