Vidéo scriptée
Une vidéo ici est un script : un fichier qui dit ce qui est dit, ce qui est à l'écran et quand. Un petit
moteur (dans starter/) le transforme en images dans un navigateur et en fichier .mp4 avec son,
sous-titres et chapitres. Parce que la vidéo est du texte, vous pouvez l'écrire, la vérifier, la réviser ligne par ligne, regarder
chaque image, la traduire et corriger un mot sans tout remonter.
Le moteur est la moitié facile. Une vidéo qui enseigne a besoin d'une histoire vraie, racontée dans un ordre que le spectateur peut suivre, avec des mots qu'il connaît, et des images qui montrent ce que la voix nomme. La majeure partie de cette compétence porte sur cette moitié. Suivez les étapes dans l'ordre ; chacune laisse un fichier que la suivante lit, de sorte que le travail survive à une longue session et qu'un second agent puisse le reprendre.
Visez à remettre une vidéo que le demandeur n'aura pas à corriger. Son temps est le coût que vous économisez. Donc : décidez ce que vous pouvez décider et écrivez la décision ; utilisez tous les services, clés et faits qu'il a offerts ; avant de remettre, regardez la vidéo comme il le fera (voir "Avant de remettre"). Les premières choses qu'un demandeur remarque ne sont presque jamais des infractions qu'un vérificateur peut trouver. Ce sont une supposition que la vidéo n'a jamais répondu, un sujet qui ne contient rien de réel, et une vidéo qui sonne inachevée.
Trois principes s'appliquent à chaque vidéo sur le monde. Chacun est énoncé ici une fois ; les étapes
ci-dessous les appliquent et references/research.md donne la méthode.
- Racontez à la profondeur du noyau ; recherchez un niveau plus profond. La vidéo que vous remettez est le noyau : le
récit le plus court qui tient la promesse et qui est vrai et juste : environ 10 à 20 minutes pour un
sujet avec des histoires réelles, moins pour un mécanisme unique. Une longueur nommée par le demandeur est une limite et prime ; la profondeur de recherche se réduit alors avec elle. La recherche va un niveau plus loin, jusqu'à la profondeur d'un détail
(les personnes, les jours décisifs, les moyens exacts, les chiffres rivaux, ce que les enquêtes ont trouvé),
de sorte que le noyau soit choisi en connaissance de cause, et que des sujets voisins émergent : un
événement, une institution ou une idée qui touche le sujet principal et a sa propre histoire. Chacun
devient une ligne de
research/next-videos.mdavec ce qui est déjà connu, et n'est pas recherché plus avant. En dessous d'un détail (la vie ultérieure de chaque personne, chaque document en entier, l'histoire complète d'une institution) se trouve la recherche d'une autre vidéo : sur un projet, aller jusque-là a fait passer la vidéo à six heures alors que le noyau de 18 minutes était ce que le demandeur voulait. Les versions plus longues ne sont faites que sur demande. - Chaque exemple réel montre le sujet principal à l'œuvre. Une histoire réelle entre dans la vidéo seulement si la chose dont parle la vidéo s'y produit réellement, comme le racontent les sources : pour une vidéo sur les marchés à terme, des contrats à terme négociés sur une bourse, un appel de marge, un contrat réglé. Une histoire qui n'est qu'à proximité (les mêmes années, un nom célèbre, un pari qui semble similaire mais a été fait autrement) reste en dehors, aussi célèbre soit-elle et même si le demandeur l'a suggérée. Vérifiez cela aux sources au tour 1, avant d'y consacrer de la profondeur. Sur un projet, l'histoire la plus célèbre proposée pour une vidéo sur les contrats à terme s'est avérée être un pari fait par le biais d'accords privés avec des banques ; elle a été retirée après que deux éditions l'avaient racontée. Court n'est pas mince, cependant : dans le noyau, chaque exemple réel est raconté avec ses personnes, sa date, les moyens exacts, les montants, comment cela aurait pu tourner autrement, comment cela s'est terminé et ce que cela montre sur le sujet principal.
- La recherche a une limite et une fin. Chaque piste est testée par rapport au sujet principal avant qu'une recherche ne soit consacrée ; une qui échoue est écrite sur une ligne et laissée ("intéressant" ne l'ouvre pas). Il y a trois tours planifiés (le plan, le détail, et une double vérification, aux sources, de tout ce que la vidéo dira) et un quatrième court uniquement pour les éléments nommés dont le noyau a besoin. Plus est la décision du demandeur.
Spectateur par défaut : quelqu'un qui rencontre le sujet pour la première fois. Écrivez de sorte qu'un enfant de 8 ans puisse suivre, avec un ton calme et professionnel qu'un adulte ne trouverait pas enfantin. Simple n'est pas la même chose qu'enfantin : phrases courtes, mots de tous les jours, une idée à la fois, pas de langage bébé. Modifiez cela uniquement si le brief nomme un spectateur différent.
Configuration
Copiez le dossier starter/ de cette compétence dans le projet de l'utilisateur (par exemple sous video/), puis :
cd video
npm install # une petite dépendance ; elle utilise le Chrome déjà sur la machine
node tools/check.mjs # la vidéo d'exemple devrait passer
Nécessite : Node 18 ou plus récent ; Chrome, Edge ou Chromium (pour dessiner les images) ; ffmpeg (pour enregistrer la
voix et exporter). Si l'un manque, voir references/troubleshooting.md. Ne travaillez pas dans le dossier
skill lui-même ; travaillez dans la copie.
La copie contient un exemple, videos/hello.json : quinze secondes en données brutes, avec une
traduction et une disposition verticale, utilisé pour vérifier que la configuration fonctionne. Ce que chaque étape doit
produire se trouve dans les fichiers que node tools/new.mjs crée : chacun commence par sa propre liste de vérification.
Supprimez l'exemple lorsque la propre vidéo de l'utilisateur est en cours.
Les étapes
Commencez chaque vidéo avec node tools/new.mjs <id> "<Title>". Cela crée notes/<id>/ (les fichiers
nommés ci-dessous, avec leurs listes de vérification) et un squelette de script dans videos/<id>.mjs.
| # | Étape | Vous produisez | Terminé quand | Lire |
|---|---|---|---|---|
| 0 | Brief | notes/<id>/brief.md | Le spectateur, la promesse ("après avoir regardé, le spectateur peut…"), la durée, la forme et la langue sont écrits, avec tout ce que le demandeur a demandé par son nom. | ci-dessous |
| 1 | Méthode de recherche | research/00-how-to-research.md | Vous savez comment les personnes qui connaissent ce domaine trouvent les choses, et où les débutants se trompent. | references/research.md |
| 2 | Recherche, en trois tours | research/NN-name.md, research/leads.md, research/next-videos.md, research/index.md | Chaque piste dans leads.md est fermée (recherchée, non trouvée, vidéo suivante, hors sujet ou ouverte) ; chaque exemple réel passe le test de l'exemple et est connu jusqu'à la profondeur d'un détail ; les autres points de vue et mythes sont recherchés ; le tour 3 a relu à sa source chaque affirmation destinée à la vidéo, et chacune a une source et un indice de confiance ; ce dont le demandeur se souvient a un verdict. La liste complète : references/research.md, section 11. | references/research.md |
| 3 | Carte mentale | mindmap.json | Chaque idée recherchée est core (dans la vidéo), support (recherchée et vraie, exclue du noyau) ou cut (non confirmée, injuste ou hors sujet) ; les idées core seules tiennent la promesse ; node tools/mindmap.mjs <id> ne signale aucune erreur. | references/planning.md |
| 4 | Storyboard | storyboard.md, assets.md | Chaque battement a une image, un résumé, un composant et un son (généralement aucun) ; les vérifications en bas sont cochées. | references/planning.md |
| 5 | Script | videos/<id>.mjs | node tools/check.mjs <id> ne signale aucune erreur et vous avez lu chaque avertissement. Le script est à la longueur du noyau. | references/authoring-kit.md, references/components.md |
| 6 | Révision de précision | review/accuracy.md, research/index.md (review/coverage.md uniquement pour un compte rendu complet) | Chaque ligne de dump --claims a un verdict et une source ; pour chaque histoire réelle, un vérificateur qui ne l'a pas écrite a comparé le script, les notes et les sources (ou, sans second agent, vous l'avez fait, et le fichier dit "non indépendant") ; la recherche a été relue par rapport au script, et ce dont le noyau avait besoin et qui manquait s'y trouve maintenant ; les corrections sont réécrites dans les notes. | references/script-review.md |
| 7 | Révision de compréhension | review/WhatIHaveLearned.md, review/lost-points.md | Le journal atteint la promesse sans lacune, et chaque façon de se perdre a une correction ou une raison. | references/script-review.md |
| 8 | Révision visuelle | review/visual.md | Vous avez regardé chaque image fixe et rien n'est coupé, masqué, vide ou illisible. | references/visual-review.md |
| 9 | Voix et son | lignes enregistrées dans out/tts/, sons dans assets/<id>/ | Le script a passé les étapes 6 à 8 et la voix est enregistrée ; le timing suit maintenant la voix réelle. Les sons d'événement sont définis ; la musique, si elle existe, se trouve uniquement sous les parties narratives. | references/voice-and-assets.md |
| 10 | Exportation et visionnage final | out/<id>.mp4, .srt, .vtt, .chapters.txt | Vous avez regardé les images du fichier exporté lui-même et vérifié son son. | references/export-and-publish.md |
| 11 | Autres langues et formats (si demandé) | videos/i18n/<id>.<lang>.json | Chaque langue passe check, et ses images fixes ont été regardées. | references/localization.md |
| 12 | Kit de publication | publish.md | Titre, description, chapitres, sous-titres, miniature, sources et crédits sont prêts. | references/export-and-publish.md |
| 13 | Remise | le message au demandeur | La passe du point de vue du demandeur est faite ; le message dit ce qui a été décidé, ce qui a été corrigé et ce qui reste ouvert. | references/finishing-and-revising.md |
Les règles d'écriture qui s'appliquent à partir de l'étape 4 se trouvent dans references/writing-for-everyone.md
(mots et phrases) et references/teaching-techniques.md (comment faire atterrir une idée).
references/visual-design.md couvre la disposition, la couleur et le mouvement. Lisez ces trois avant d'écrire votre
premier script.
Étape 0 : le brief
Remplissez brief.md à partir de ce que l'utilisateur a dit. Pour tout le reste, écrivez votre meilleure hypothèse
et marquez-la "(supposé)" ; ne vous arrêtez pas pour demander (voir "Décidez, enregistrez, continuez").
La ligne la plus importante est la promesse : une phrase commençant par "Après avoir regardé, le spectateur peut…". Chaque décision ultérieure (quoi rechercher, quoi couper, quand la vidéo est finie) est
testée par rapport à elle. Enregistrez également ce que le spectateur sait déjà, car c'est là que la vidéo
commence.
Copiez dans le brief, dans les propres mots du demandeur, tout ce qu'il a demandé par son nom : un service à utiliser, une clé et où elle se trouve, un exemple ou un événement à inclure, un fait dont il se souvient, une partie qu'il a trouvée confuse, une limite ("la plupart sans musique"). Chacun de ces éléments est une ligne à cocher avant de remettre. Un service nommé est vérifié pour son accessibilité maintenant, pas à l'étape 9 ; un fait dont il se souvient va à la recherche comme quelque chose à vérifier, pas comme quelque chose à répéter.
Décidez ici si une recherche est nécessaire. Sautez les étapes 1 et 2 uniquement lorsque le contenu est entièrement donné (le propre produit de l'utilisateur, un script qu'il a écrit, un processus qu'il a décrit) et que vous n'ajoutez aucun fait personnel. Si vous ajoutez ne serait-ce qu'un nombre, une date, un nom ou un "parce que", recherchez-le.
Étapes 1 et 2 : recherche
Avant de rechercher le sujet, recherchez comment le rechercher : deux ou trois recherches sur la façon dont les gens apprennent et enquêtent dans ce domaine, et un niveau au-dessus (pour le marché obligataire : "comment comprendre le marché obligataire", puis "comment apprendre sur l'économie"). Elles vous disent quelles sources comptent, quels chiffres comptent et où les débutants se trompent. Ensuite, trois tours :
- Le plan. Une note par sujet, avec un résumé en haut : des faits avec des sources, des événements réels (d'abord testés par le test de l'exemple), des comparaisons quotidiennes, et les points de vue opposés les plus forts et les mythes, recherchés aussi soigneusement que la ligne principale.
- Le détail. Listez chaque personne, lieu, date, nombre, terme, mécanisme, cause et citation
que les notes mentionnent sans expliquer, dans
research/leads.md. Recherchez ceux qui portent sur le sujet principal, une fois, jusqu'à la profondeur d'un détail. Les sujets voisins vont dansnext-videos.md; le reste est marqué hors sujet. - La double vérification. Aucun nouveau sujet. Relisez, à sa source, tout ce que la vidéo dira ; trouvez une deuxième source indépendante pour les affirmations surprenantes, les chiffres qui donnent la taille de l'histoire, les citations et tout ce qui reflète mal sur une personne nommée.
Planifiez les recherches avant de commencer et gardez un tiers pour le tour 3. Si vous pouvez démarrer d'autres agents, confiez chaque événement réel à son propre agent, et la double vérification à un agent qui n'a pas écrit la note.
Deux choses sur lesquelles la vidéo finie doit pouvoir s'appuyer :
- Des événements réels, connus jusqu'à la profondeur d'un détail. Une personne inventée rend une idée facile à suivre ; un événement réel fait croire au spectateur et le fait s'en souvenir. Pour un sujet avec une histoire (un marché, une technologie, une institution), recherchez-en au moins deux. Si l'un montre quelqu'un gagnant, recherchez comment il aurait pu échouer, et trouvez-en un où quelqu'un a perdu : une victoire seule enseigne la mauvaise leçon. Pour un mécanisme de la nature ou une méthode (pourquoi le ciel est bleu, comment faire un nœud), une observation, une mesure ou une découverte réelle suffit, ou aucune : écrivez "aucun, parce que…" dans le brief.
- Ce dont le demandeur se souvient, vérifié. C'est une piste, et souvent partiellement fausse. Vérifiez chaque partie, utilisez ce qui tient, et dites-lui ce que vous avez corrigé et pourquoi ; ne répétez jamais une affirmation parce que "le demandeur l'a dit" et ne la laissez jamais tomber en silence.
Détails : references/research.md.
Étape 3 : la carte mentale
mindmap.json est un arbre court de chaque idée que la vidéo pourrait contenir (les types de nœuds sont listés dans
references/planning.md section 1 ; node tools/mindmap.mjs les nomme quand l'un est erroné). Chaque nœud dit en quelques
mots quelle est l'idée, où ses détails vivent dans la recherche ("file.md#Heading"), quelles idées
le spectateur doit connaître en premier, et à quelles autres idées ailleurs elle se connecte. Chaque idée est core (dans
la vidéo : la promesse en a besoin, une histoire réelle ne peut pas être racontée sans elle, ou l'équité en a besoin),
support (recherchée et vraie, exclue du noyau : matière pour la description, une version plus longue si le demandeur le demande, ou une vidéo suivante) ou cut (non confirmée, ne peut pas être racontée équitablement, ou
ne porte pas sur le sujet principal ; une histoire réelle qui échoue au test de l'exemple est cut). L'outil vérifie que chaque pointeur mène quelque part et que
rien n'est enseigné avant ce dont il a besoin. Détails : references/planning.md.
Étape 4 : le storyboard
Un tableau, une ligne par battement : ce que le spectateur voit, le résumé de ce que la voix dit, quel composant le dessine, si un nouveau mot arrive, et ce qui est entendu à part la voix (pour m
…
[tronqué pour la traduction]