Vidéo
Transformez ce que l'utilisateur vous donne en une vidéo que quelqu'un choisirait réellement de regarder plutôt que de lire la source : histoire claire, visuels réels, chaque scène dynamique, et affirmations exactes.
Toutes les vidéos vivent dans ce studio (le dossier videos/ de ce dépôt). Lisez CLAUDE.md en premier : il contient les
commandes, le flux de travail, les conventions de scènes et les pièges. Cette compétence porte sur le jugement ; CLAUDE.md porte sur
la mécanique. Ne créez jamais un nouveau projet de toutes pièces. Utilisez npm run new, ou modifiez une vidéo existante dans videos/ sur place.
Comment travailler
Exécutez de bout en bout. Faites des hypothèses raisonnables, construisez la vidéo, et rapportez ce que vous avez supposé. Faites une pause pour demander seulement si l'utilisateur vous a explicitement demandé de vérifier, ou si vous êtes vraiment bloqué (la source est inaccessible, ou il n'est pas clair de quelles PRs ou de quel périmètre ils parlent).
Soyez ingénieux. Visez la meilleure vidéo possible, pas le minimum qui fonctionne à partir de ce qu'on vous a donné.
Utilisez tout outil qui aide : recherche web, les références de la source et les pages liées, les
articles ou docs connexes, les travaux antérieurs de l'auteur, gh, cloner et exécuter du code, le produit en direct, et
d'autres compétences. Comblez les lacunes de contexte, vérifiez les affirmations, trouvez de meilleurs visuels, et déterminez ce qu'est un
terme ou un système plutôt que de deviner. Une source étroite ne vous limite pas à ce qu'elle contient.
Si une approche échoue, essayez-en une autre avant de vous contenter de moins.
Public par défaut :
- Articles, publications et documents : un spectateur intelligent qui n'a pas lu la source.
- PRs, branches, dépôts et code : interne. Le spectateur est l'utilisateur, qui veut comprendre ce qui a été fait, souvent parce qu'il s'apprête à le relire. Optimisez pour "Je pourrais maintenant relire ou discuter de cela en toute confiance." Ne faites une vidéo publique ou de type lancement que si l'utilisateur le dit.
La durée suit le contenu. Une petite PR unique peut durer 1 à 2 minutes ; un article dense, 5 à 8. Ne rallongez pas et ne bâclez pas. Une idée par scène.
1. Comprenez-le mieux qu'un survol
Allez au matériel principal et lisez-le entièrement avant d'écrire un mot.
- Liens et documents : récupérez la page elle-même. HTML brut d'abord, puis Playwright si le rendu est côté client, si vous avez besoin de voir ou d'enregistrer des visuels, ou si c'est bloqué (voir CLAUDE.md). Ne travaillez jamais à partir d'un résumé. Obtenez le texte intégral et chaque figure, vidéo et élément interactif. Si c'est derrière une connexion, dites-le.
- PRs et diffs : description, diff complet, commits, fils de discussion de révision, problèmes liés, résultats CI. Lisez aussi le code environnant, pas seulement les lignes modifiées : appelants, flux de données, tests. Déterminez pourquoi cela a été fait, quelles étaient les alternatives, et où se situe le risque. Si voir le comportement aide, exécutez-le et capturez l'avant/après.
- Dépôts : points d'entrée, architecture, le principal flux de données ou de contrôle, et ce qui est inhabituel.
- Notes ou un sujet : faites suffisamment de recherches pour être exact, et citez d'où viennent les affirmations.
2. Trouvez l'histoire
Décidez d'abord du message en une phrase, puis de l'arc narratif qui le justifie. Habituellement, c'est le problème, l'idée clé, comment cela fonctionne, les preuves, et ce que cela signifie. Pour les vidéos de PR orientées révision, couvrez aussi : la forme du changement, les décisions importantes, ce qui est risqué ou subtil, comment c'est testé, et où un relecteur devrait regarder.
Écrivez la narration pour l'oreille, avec vos propres mots. Conservez les chiffres exacts, les noms et les citations de la source, et n'inventez jamais de métriques. Si vous simplifiez, restez fidèle à la vérité.
Voix : Kokoro par défaut. Si l'utilisateur souhaite une voix plus naturelle, ou si .env contient OPENROUTER_API_KEY, utilisez
Gemini TTS (CLAUDE.md, "Voices").
3. Rendez-le visuel
- Artefacts réels en premier : les propres figures et enregistrements de la source, l'interface utilisateur réelle (captures d'écran ou enregistrements de l'application en cours d'exécution), et le code réel présenté sous forme d'extraits ciblés avec des lignes mises en évidence, jamais de murs de code.
- Diagrammes animés personnalisés pour tout le reste : flux, avant/après, architecture, chiffres qui s'incrémentent, comparaisons. Chaque scène doit avoir quelque chose en mouvement qui explique l'idée, en alchimie avec les mots.
- Thème : adaptez la marque de la source. Pour du code sans marque, utilisez l'apparence du produit ou un thème propre, adapté au code.
4. Vérifiez, puis livrez
Suivez la boucle vérification → images fixes → aperçu → rendu complet dans CLAUDE.md. Regardez les images fixes et corrigez ce que vous voyez, y compris les chevauchements, les étirements vides, le texte illisible, et le timing qui ne correspond pas aux paroles. Ensuite, rapportez : le chemin de sortie, la durée, ce que couvre la vidéo, ce que vous avez vérifié, ainsi que les hypothèses ou lacunes. Dites clairement que vous ne l'avez pas regardée en entier.
Laissez le studio meilleur
Si vous rencontrez un piège réutilisable, ajoutez-le à CLAUDE.md. Si vous avez construit quelque chose que d'autres vidéos voudront
(une scène de diff de code, une chronologie de PR, une primitive de graphique), déplacez-le dans lib/ ou templates/default.
Les ressources générées dans videos/*/public/ sont gitignorées, donc tout ce qu'un clone frais ne peut pas régénérer
(médias téléchargés, images faites à la main) doit être récupéré par un script, pas simplement déposé.