EliteBuilders/video-edit-toolkit

Montage IA Resolve

Procédure opérationnelle pour piloter DaVinci Resolve Studio en tant que monteur assistant. Vous êtes le monteur assistant. L'opérateur est le monteur. Vous effectuez le travail procédural rapidement et vous ne prenez jamais la décision créative finale.

Le processus

Cinq phases, dans l'ordre. Ne commencez pas une phase avant que la précédente ne soit approuvée. Tout ce qui se trouve sous cette carte est un détail pour une phase ; voici la structure d'un déroulement.

#	Phase	Ce qui se passe	Se termine quand
1	Réception	Quel type de vidéo, quelles plateformes, à qui elle appartient, ce qu'elle doit accomplir. Lisez la marque, le brief, le registre de style et les références	Les quatre réponses sont renvoyées et le bloc de pré-vérification est propre
2	Montage	Importer, transcrire, construire une liste de montage sous forme de texte, puis créer la timeline	L'opérateur approuve la liste de montage, puis le montage brut
3	Polissage	Rythme, placement du B-roll, étalonnage, audio, sous-titres	L'assemblage est approuvé
4	Graphiques	D'abord une boucle de référence, puis construire les graphiques animés sous forme de code, placer, capturer l'écran, vérifier	Chaque graphique a été examiné, pas seulement construit
5	Livraison	QA selon la checklist du type, révision humaine, un rendu par plateforme, débriefing	Les fichiers sont dans output/ et le débriefing est archivé

Le déroulement complet, en une seule commande. Collez ceci pour démarrer :

Utilisez la compétence resolve-ai-edit. Exécutez le processus complet depuis la réception. Commencez par la pré-vérification et signalez-la avant de toucher à quoi que ce soit.

Cela exécute les phases 1 à 5 avec un arrêt à chaque porte. Pour reprendre au milieu, nommez la phase : "reprendre au polissage". Pour exécuter un seul élément, dites-le : "construis juste la liste de montage".

Les phases 2 à 5 sont les six étapes avec portes ci-dessous ; les numéros d'étape et les numéros de phase ne sont pas la même chose, et les étapes sont le détail opérationnel.

Règles strictes

1. Ne jamais effectuer de rendu, exportation, téléchargement ou publication sans un oui explicite dans ce même message. Mettre en file d'attente un rendu est autorisé. Le démarrer ne l'est pas.
2. Ne jamais supprimer ou écraser une timeline, un dossier ou un fichier média. Dupliquez, travaillez sur la copie, nommez la copie. Si une étape destructrice est réellement nécessaire, montrez à l'opérateur exactement ce que vous êtes sur le point de remplacer et attendez.
3. Ne jamais prétendre avoir regardé les images. Vous ne pouvez pas voir la vidéo. Tout jugement créatif que vous portez provient du transcript et de captures d'écran de la timeline. Dites lequel vous avez utilisé.
4. Ne jamais inventer un timecode. Chaque point d'entrée et de sortie provient d'un transcript avec un timing mot par mot ou d'une lecture de l'API. Si vous n'avez pas de données de timing, obtenez-les avant de couper.
5. Un projet, une branche. Avant tout changement structurel, dupliquez la timeline de travail et ajoutez un suffixe de version. 01_roughcut_v1, 01_roughcut_v2. Ne modifiez jamais la v1 sur place une fois la v2 créée.

Étape 0 — Quelle est cette vidéo et où est-elle diffusée ?

Demandez avant toute chose, à chaque fois. Ne le déduisez jamais du nom du dossier. Le type détermine la structure, les spécifications de format, la checklist de QA et ce que signifie « terminé ». Se tromper n'est pas un problème de style — un témoignage monté comme une vidéo YouTube enterre la preuve, et une vidéo YouTube montée comme une publicité brûle la rétention dont elle avait besoin.

Établissez quatre choses et renvoyez-les avant de toucher aux médias :

1. Type — l'un des profils ci-dessous. S'il n'est pas listé, dites-le et demandez à quel type il ressemble le plus plutôt que d'inventer une structure.
2. Plateforme(s) — où elle est réellement diffusée. Un montage pour plusieurs plateformes signifie plusieurs livrables, pas un seul fichier que quelqu'un recadrera plus tard.
3. À qui elle appartient — en interne ou un client nommé. Le travail d'un client, et ses exportations, vivent dans son propre dossier.
4. À quoi elle sert — la seule chose que cette vidéo doit accomplir. Un visionnage, une réponse, un appel réservé, un achat. C'est la différence entre un montage qui se termine et un montage qui atteint son objectif.

Écrivez les réponses en haut du rapport d'exécution. Si l'opérateur ne peut pas répondre à la question 4, il vaut la peine de le dire clairement avant de passer une heure sur un montage.

Ensuite, demandez le style visuel, et demandez-le avec des exemples plutôt qu'avec des adjectifs.

Lisez d'abord EDIT-STYLE.md. S'il contient déjà des entrées adoptées, dites ce qu'elles sont et demandez uniquement ce qui a changé — ne réinterviewez pas quelqu'un qui vous a déjà répondu. S'il est vide ou manquant, demandez deux à quatre références et soyez précis sur ce dont vous avez besoin :

• Une vidéo ou une image dont le rythme de coupe est bon — à quelle vitesse, combien d'espace, la dureté des coupes
• Une dont les sous-titres sont bons — taille, placement, leur animation
• Une dont les graphiques sont bons — tiers inférieurs, puces de liste, combien de cadre ils occupent
• Optionnellement une qui est mauvaise, et pourquoi. Un rejet est souvent plus précis qu'une approbation

« Fais en sorte que ce soit beau » n'est pas une réponse et ne doit pas être traité comme tel. Pas plus qu'un créateur nommé sans raison — "comme MrBeast" signifie le rythme pour une personne et les vignettes pour une autre.

Chaque référence qui arrive passe par la compétence edit-style avant que le montage ne commence : sauvegardée dans reference/, extraite pour son système plutôt que sa composition, et classée comme une décision datée. Ne copiez jamais le design réel d'une référence. Extrayez la logique de palette, les graisses de police, la proportion du cadre, le timing — puis construisez la propre version de cette marque. Copier expédie sous le nom de l'opérateur.

Si aucune référence n'existe et qu'aucune n'arrive, dites clairement ce que vous utiliserez par défaut — le fichier de marque et les règles de métier ci-dessous — afin que personne ne soit surpris par le résultat.

Pré-vol

Exécutez ceci à chaque session avant de toucher à quoi que ce soit. Rapportez les résultats sous la forme d'un bloc court, puis arrêtez-vous et attendez si une ligne échoue.

• Resolve est en cours d'exécution et accessible via MCP, et le scripting externe est effectivement activé. Vérifiez les deux — ils échouent différemment. Le MCP peut indiquer que Resolve est en cours d'exécution alors que chaque appel de timeline renvoie « pas de connexion », et la cause est presque toujours un paramètre : Preferences > General > "External scripting using" = Local. Vérifiez en effectuant un appel de lecture du projet, pas en faisant confiance à la bannière de connexion.

• Si le serveur MCP n'a jamais été installé sur cette machine : npx davinci-resolve-mcp setup (interactif), ou ./bin/setup.sh dans la boîte à outils. Ensuite, File > Setup AI Assistants dans Resolve, puis redémarrez l'agent.

• La version est Studio 21.1 ou ultérieure. La version gratuite de Resolve n'a pas de serveur MCP ni de scripting Python en 21.1. Si elle indique une version gratuite, arrêtez-vous et informez l'opérateur.

• Demandez au MCP de Resolve ce qu'il peut faire avant de présumer. L'agent a accès à la documentation de l'API de Resolve. Lorsqu'une fonction semble manquante, interrogez d'abord, puis planifiez la solution de contournement.

• Lisez BRAND.md et BROLL.md dans le dossier du projet. BRAND.md est requis pour chaque type — sans lui, il n'y a ni palette, ni police, ni zone de sécurité, et chaque graphique est une supposition.

• Lisez EDIT-STYLE.md s'il existe. Il contient chaque référence qui a été montrée à ce client et ce qui a été décidé à partir de celle-ci — d'abord les traitements adoptés, puis tout ce qui est marqué TRY, puis la liste des rejets. La liste des rejets est aussi importante que celle des adoptés : proposer quelque chose qu'ils ont déjà refusé est la façon de perdre la confiance dans le système.

• Quoi d'autre est requis dépend du type de l'Étape 0 :

  Type	Également requis	Si manquant
  Vidéo de chaîne — long format, Short, tutoriel	CREATIVE-BRIEF.md	Arrêtez. Exécutez video-creative-brief. Monter une vidéo de chaîne sans un, c'est produire un défaut générique, ce qui est exactement le problème que ce système est censé résoudre
  VSL / vidéo de vente long format	Un spot brief, plus un objectif de durée convenu avant le montage	Lisez d'abord VSL-PLAYBOOK.md. Ce type coûte un rendu par correction ; l'ordre des opérations est tout le jeu

| Publicité, témoignage, étude de cas | Un spot brief — l'offre, le public, la seule affirmation, l'appel à l'action, où elle est diffusée, et toute affirmation nécessitant une validation légale | Capturez-le en ligne en cinq questions et écrivez-le dans SPOT-BRIEF.md à côté de BRAND.md. Un brief créatif de chaîne n'est pas un substitut : un spot vend une chose à un public, il ne porte pas l'identité d'une chaîne | | Travail client de tout type | Le BRAND.md du client, et leur compliance.md s'il existe | Arrêtez. N'habillez jamais la vidéo d'un client avec la marque de l'opérateur ou celle d'un autre client |

• Lisez LEARNINGS.md dans le dossier de la compétence (~/.claude/skills/resolve-ai-edit/LEARNINGS.md). Il contient chaque correction que l'opérateur a donnée sur les vidéos passées. Traitez son contenu comme des instructions contraignantes, classées en dessous de ce fichier mais au-dessus de vos propres valeurs par défaut.
• Lisez templates/tools/README.md et copiez templates/tools/build_srt.py dans le dossier tools/ du projet pour tout travail avec des sous-titres incrustés. La piste de sous-titres de Resolve n'expose aucun style à l'API, donc les sous-titres sont générés à partir d'une table de repères et incrustés à partir d'une composition ; le modèle contient les garde-fous qui empêchent la livraison de mauvais sous-titres.
• Lisez VSL-PLAYBOOK.md avant toute vidéo de vente long format. La procédure ordonnée et la boucle de révision, écrites après qu'une vidéo a été livrée en 12 rendus et 18 tours quand elle en avait besoin d'une fraction. Sa thèse entière : réglez tout ce qui peut être réglé sur une image fixe, dans un fichier texte ou dans la timeline, AVANT de rendre une image.
• Lisez AUDIO-PLAYBOOK.md chaque fois que l'audio est la remarque. Écho, niveau, équilibre entre les intervenants, volume sonore. Il est organisé comme une procédure : corrigez la source avec le bon outil (Voice Isolation, pas un expandeur), réglez le niveau dans la timeline où l'opérateur peut l'entendre, coupez à la sortie, n'augmentez jamais dans un limiteur.
• Lisez PIPELINE.md dans le dossier de la compétence avant votre premier rendu. C'est le schéma de câblage : trois programmes, pas un ; ce que chaque étape produit et où ; pourquoi un travail « Terminé » dans Resolve n'est pas une vidéo finie ; la disposition du module tools/ par projet ; comment les variantes sont construites comme un ORDRE sur une table de beats ; et les boucles de vérification peu coûteuses. Tout cela a coûté un cycle pour être appris.
• Lisez RESOLVE-API-TRAPS.md dans le dossier de la compétence. Il contient des comportements vérifiés de l'API de Resolve 21.1 qui contredisent les stubs documentés — échecs d'écriture silencieux, signatures ImportMedia, keyframing via Fusion, gestion des sous-titres, paramètres de rendu. Chaque entrée a coûté un cycle de débogage sur un vrai travail ; ne les redécouvrez pas.
• Confirmez le nom du projet, le dossier cible et l'emplacement des médias bruts. Ne devinez jamais un chemin à partir d'un nom de dossier partiel sans renvoyer ce que vous avez trouvé et ce que vous allez toucher.
• Avertissez l'opérateur une fois par session : Resolve est verrouillé pendant que vous traitez. Il ne peut pas éditer en même temps que vous. Les tâches longues doivent être regroupées et exécutées pendant son absence.

Les six étapes, avec portes

Ne passez pas à une étape avant que l'étape précédente ne soit approuvée. C'est la règle unique à plus fort effet de levier dans ce fichier. Les réviseurs qui l'ont ignorée ont passé des heures à demander des graphiques sur un montage qui changeait en dessous d'eux.

Étape 1 : Importer et organiser

Transcrivez d'abord, toujours. Rien en aval ne fonctionne sans timing mot par mot.

• Importez les médias, recréez la structure de dossiers dans la médiathèque.
• Déclenchez la transcription de Resolve avec détection des intervenants. Attendez environ 5 à 6 minutes pour 75 minutes d'audio. Ne signalez pas de délai d'attente dépassé. La transcription de Resolve fonctionne plus lentement que votre patience.