Communitygithub.com

paper-explainer

Transforme un article (arXiv/PDF), un long texte technique ou une revue de plusieurs articles en une vidéo explicative horizontale de 6 à 8 minutes, en mandarin. Le processus comprend : fiche article → chaîne de questions du public → voix off (auto-vérification phrase par phrase) → test à l'aveugle + vérification des faits → relecture par l'auteur → alignement voix → plan de plans (déformation continue / plongée dans l'article / grand canevas) → rendu `render(t)` par chapitre → codage WebCodecs Chrome local → examen indépendant.

Qu'est-ce que paper-explainer ?

Paper-Explainer est une compétence d'agent qui transforme des articles de recherche (arXiv/PDF), des articles techniques longs ou des revues en vidéos explicatives horizontales de 6 à 8 minutes, en mandarin. Elle est conçue pour les créateurs de contenu technique qui souhaitent produire des vidéos de haute qualité expliquant des concepts de recherche complexes, en privilégiant la clarté et une narration structurée. La compétence est implémentée comme un flux de travail complet comprenant la lecture d'articles, la génération de voix off, la vérification des faits, le storyboard (avec des techniques comme la déformation continue, la plongée dans l'article et le grand canevas), le rendu piloté par `render(t)` et l'encodage matériel via WebCodecs dans Chrome. Elle prend en charge les articles uniques et les revues multi-sources, en utilisant un seul exemple concret et une seule image mère pour assurer la cohérence. L'architecture du projet comprend un moteur (`engine/`) avec des composants prêts à l'emploi pour le canevas, les transitions, le rendu, le mixage audio et l'alignement de la voix, ainsi que des exemples (`examples/demo`, `examples/always-on`) pour une prise en main rapide. Les règles strictes garantissent une sortie de haute qualité : vérification des faits indépendante, test à l'aveugle, relecture par l'auteur et approbation avant chaque étape. L'accent est mis sur une production fluide, évitant les retouches et garantissant que le produit final soit à la fois précis et engageant pour un public ayant une formation technique mais n'ayant pas lu l'article original.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ningcodes/paper-explainer-skill/tree/HEAD/skill

Demander à votre IA préférée

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

Documentation

Article → Vidéo explicative

Public cible : personnes ayant une formation technique mais n'ayant pas lu cet article. Après avoir regardé la vidéo, elles doivent pouvoir expliquer : ce qu'il modifie, pourquoi c'est efficace, ce qu'on peut en apprendre, et être capables de reformuler ce qu'il fait avec un exemple concret. Les formules ne sont pas dérivées, mais la logique est clarifiée.

Spécifications du produit final : paysage 1920×1080, 30 ips, H.264 + AAC, durée 6–8 minutes (priorité à la clarté, jusqu'à environ 10 minutes acceptables). La signature de fin et l'invitation à suivre sont des éléments de configuration (outro dans film.json du répertoire du projet), non codés en dur.

Cette compétence est associée au code dans le dépôt : engine/ (coque du canevas, papier physique, carte de style ④, page de rendu WebCodecs, concaténation et mixage, alignement voix, musique et effets sonores), examples/demo (exemple minimum de 25 secondes), examples/always-on (exemple complet d'un épisode). Documentation de l'interface : engine/README.md.


I. Règles strictes (chacune provient de retours, en cas de conflit, ce sont ces règles qui priment)

  1. Avant de commencer, charger le texte complet de cette compétence, et dans le brief envoyé au sous-agent, coller le texte original de la checklist, ne pas le reformuler de mémoire. Pour les briefs de rédaction et de relecture, coller également le texte complet de references/voiceover-selfcheck.md. La première ligne du brief doit indiquer le chemin de cette compétence, et exiger la lecture complète avant toute action.
  2. L'ordre ne doit pas être inversé : chaîne logique → voix off verrouillée → storyboard (plan de plans) → voix enregistrée → montage brut pour voir le flux → effets / finition artistique → vignette en dernier. Ne pas faire d'images tant que la voix off n'est pas verrouillée ; ne générer aucun matériel autre que la voix (comme un avatar optionnel) tant que le storyboard et le script ne sont pas verrouillés. Définir d'abord le style puis modifier le contenu = reprise.
  3. Le rédacteur ne fait pas la validation. Avant de soumettre la voix off à la relecture, elle doit passer par un test à l'aveugle « écoute unique » et une vérification des faits indépendants ; avant de montrer le produit fini à l'auteur, un agent n'ayant pas participé à la production doit regarder la vidéo dynamique complète, la vérifier par rapport à references/review-checklist.md, et soumettre le rapport de vérification en même temps.
  4. Un seul chemin de rendu : dans une page Chrome locale, render(t) image par image + encodage matériel WebCodecs (engine/common/shell-wc.html). Le brief ne mentionne que cette méthode, sans donner d'alternative de repli « capture d'écran headless image par image → ffmpeg ». Avant de lancer le rendu complet, tester 10 secondes (ms/image et renderer WebGL) ; si le renderer est un renderer logiciel comme SwiftShader / llvmpipe, s'arrêter et faire un rapport, sans changer de méthode de rendu. Interdire geq pour le mixage. Lancer le rendu sur des agents d'arrière-plan, en parallèle pour les chapitres indépendants, la session principale reste disponible pour discuter à tout moment.
  5. Voix : utiliser n'importe quel TTS pour obtenir un fichier wav → engine/voice/align.py pour l'alignement. Les phrases mal lues sont régénérées individuellement, sans modification manuelle des timings.
  6. L'image de la trame 0 doit avoir du contenu, les 20–30 premières secondes sont les plus importantes. L'accroche directe : un nom faisant autorité + le résultat le plus contre-intuitif + la confusion du public (ou « On vous explique tout sur X »), sans créer de suspense inutile.
  7. La durée suit la clarté, jusqu'à environ 10 minutes acceptables ; les pauses entre les phrases doivent être serrées (voir section 10).
  8. Images : la lisibilité avant tout, style éditorial blanc chaud / blanc crème ; carte de style par défaut ④ Presse (déjà utilisée dans les épisodes publiés). Privilégier les mouvements de caméra continus, les zooms dans les pages d'article, les fondus musicaux doux. Ne pas utiliser de fond sombre de type 3Blue1Brown comme fond principal de la vidéo, ni de style d'affiche à grille suisse ; ne pas faire de transitions brutales de type PPT entre des cartes statiques.
  9. Avatar optionnel : le sujet principal est le contenu. Si une image de l'auteur est ajoutée, la placer uniquement dans une petite fenêtre en bas à droite, uniquement au début / chapitre / fin, pas un gros plan ; la voix off n'est pas retranscrite en gros caractères.
  10. Fin : question de discussion (liée au mécanisme central de l'épisode, pouvant être répondue en une ou deux phrases) → signature + invitation à suivre (outro dans film.json) ; pas d'annonce pour le prochain épisode.
  11. Rédaction : professionnelle et concise, avec un processus de raisonnement, peu d'émojis ; éviter les structures « Ce n'est pas… mais… » ; ne pas décrire d'expériences personnelles qui n'ont pas eu lieu. Distinguer clairement les affirmations officielles, les mesures effectuées et les déductions. Soumettre la voix off par sections à l'auteur pour relecture. La checklist d'auto-vérification phrase par phrase se trouve dans references/voiceover-selfcheck.md (prioritaire sur toute autre formulation antérieure dans ce fichier).
  12. Baser les solutions sur des pratiques déjà éprouvées, ne pas inventer de nouveaux formats. Pour les nouveaux plans, chercher d'abord une implémentation similaire dans examples/.

Étapes que l'auteur doit effectuer lui-même (l'agent s'arrête ici, explique clairement ce que l'auteur doit faire, et attend confirmation) : relire la chaîne logique et la voix off (section 7), générer le fichier wav de la voix (section 9, sauf si l'auteur a déjà fourni une méthode TTS utilisable), regarder le plan de plans (section 8), regarder l'échantillon et le produit fini (sections 11–12), publier. Tant que l'auteur n'a pas fini la relecture, le même épisode ne passe pas à l'étape suivante (d'autres épisodes peuvent continuer).

Économiser les tokens : au maximum 1 série de vérification des faits et 1 test à l'aveugle par version soumise à validation ; regrouper les petits problèmes pour les corriger en même temps que les retours de l'auteur. Utiliser des petits modèles pour chercher et organiser les fichiers ; utiliser des modèles puissants pour la rédaction, les jugements factuels et la relecture. Écrire les longs contenus dans des fichiers, ne retourner que le chemin et la conclusion.


II. Vue d'ensemble du processus

  1. Sélection du sujet : aperçu de l'article + popularité du même sujet sur ta plateforme de publication ; seuil strict : l'article doit contenir une étude de cas complète.
  2. Lecture approfondie → Fiche article (references/paper-card.md)
  3. Trouver l'accroche
  4. Plan en trois questions + exemple fil conducteur + chaîne de questions du public (references/question-chain.md)
  5. Rédiger la voix off (section 4 + references/voiceover-selfcheck.md)
  6. Test à l'aveugle « écoute unique » (deux rôles, sous-agent, references/listen-test-brief.md) → compléter le script
  7. Vérification des faits indépendante + avis contradictoire (sous-agent, en parallèle, references/factcheck-brief.md) → modifier le script, puis retester la compréhension
  8. Relecture de la voix off par l'auteur, section par section (chaîne logique sur une page + voix off par section, attendre confirmation)
  9. Storyboard : choisir la carte de style + Plan de plans (references/shot-plan.md) + barre de progression de la colonne en haut → (L'auteur regarde le plan de plans)
  10. Voix (n'importe quel TTS)
  11. Alignement, pistes audio (voix + lit musical + effets sonores)
  12. Composants communs → écrire scene.js par chapitre en parallèle → échantillon → relecture indépendante → vidéo complète → finition artistique par chapitre → nouvelle relecture → révision .1
  13. Auto-vérification par décimation d'images → livraison ; après que l'auteur a regardé et posé des questions, faire d'abord une rétrospective avant de modifier.

Cette compétence s'applique également aux revues « on vous explique tout sur » en plusieurs sources

Les revues / séries d'articles en plusieurs sources suivent également les étapes 0–12. Les conséquences de ne pas charger cette compétence : phrases remplies d'« institution + année + chiffres » lues d'une traite, chapitres indépendants les uns des autres, pas de vraies pages d'article, pas d'animations ni de musique, pas de test de compréhension, reprise complète de la vidéo. Adaptations :

  • Utiliser un exemple fil conducteur + une image mère pour relier toute la vidéo ; chaque chapitre utilise le même vocabulaire pour repasser sur l'image mère. L'image mère doit de préférence utiliser une classification existante dans l'article ; le texte principal est organisé en chapitres selon cette classification, sans créer un cadre artificiel.
  • Chaque chapitre ne raconte qu'une seule histoire principale, un seul chiffre principal ; les autres chiffres sont placés sur une carte de provenance à l'écran, la voix off dit simplement « X a découvert ».
  • Progression des chapitres (du plus simple au plus profond / dans l'ordre de la chaîne de production), le dernier chapitre revient sur l'accroche du début.
  • Les institutions et les années ne sont pas incluses dans les longues phrases de la voix off ; une seule information par phrase.
  • L'autorité d'une revue vient de « l'article + le code open source des grandes entreprises » ; l'accroche ne doit avoir qu'un seul sujet principal.

0. Sélection du sujet

  • En cas de plusieurs candidats, consulter d'abord l'aperçu IA de l'article (par exemple alphaXiv), utilisé uniquement pour décider s'il faut lire en profondeur, pas comme source de faits.
  • Vérifier la popularité du même sujet sur ta plateforme de publication : y a-t-il quelqu'un qui a déjà bien expliqué le sujet ? Comment sont les retours sur ces vidéos ? La popularité académique (likes, citations, nombre d'articles) n'est pas égale à la popularité sur la plateforme ; ce qui est populaire sur la plateforme est généralement « un concept bien expliqué », « un seul article suffit », et les noms de personnes / d'entreprises. Sans preuve, ne pas dire « c'est très populaire récemment ».
  • Seuil strict : l'article doit contenir une étude de cas complète (entrée → ce qui est fait à chaque étape → scores avant/après), capable de soutenir un « suivi pas à pas ». Si ce n'est pas le cas, bien réfléchir avant de le sélectionner.
  • Avant de sélectionner un sujet, définir quatre choses : la question du lecteur, notre proposition, les preuves, la livraison (ce que le spectateur peut emporter après avoir regardé).

1. Lecture approfondie : Fiche article

  • Obtenir le texte complet : https://arxiv.org/pdf/<id> ; si possible, obtenir également le code source TeX (/src/<id>, plus précis pour les chiffres et les légendes des figures, les figures originales peuvent être utilisées directement) ; si le téléchargement du PDF échoue, lire d'abord arxiv.org/html/<id>. Ne télécharger que les documents que tu as le droit d'utiliser, et noter la licence (CC BY, etc.).
  • PDF : pdftoppm -r 150 pour rendre toutes les pages et voir le contenu ; utiliser 300 dpi pour les pages et les zones à utiliser dans les images, et 720 dpi pour les figures à zoomer (les plans doivent pouvoir être agrandis 2 à 3 fois, 150 dpi ou les captures d'écran vidéo deviendraient floues). Utiliser pdftotext -bbox pour les boîtes de mots (pour positionner le surligneur) ; cela peut planter sur certaines versions de poppler, utiliser PyMuPDF à la place (voir examples/demo/get-paper.sh, penser à la normalisation NFKC, sinon les ligatures comme fi ne seront pas trouvées). Pour le texte web, utiliser engine/tools/capture.mjs (capture d'écran 3× + boîtes de mots pour les phrases).
  • Lire l'intégralité du texte principal, des annexes et des légendes des figures. Les annexes, les ablations, les échecs, les limitations doivent être lus séparément. Les prompts, les règles de décision, le pseudo-code dans les annexes doivent être lus : le mécanisme central et le « sur quoi se base le jugement » sont souvent écrits uniquement ici.
  • Remplir la fiche article selon les 12 éléments de references/paper-card.md. Pour l'analyse d'un seul article, commencer par saisir la figure et la structure centrales de l'article original, sans imposer son propre cadre.

2–3. Accroche, trois questions, exemple fil conducteur, chaîne de questions du public

Accroche (chaque phrase ≤ 3 secondes, une seule information par phrase) :

  1. Mettre le nom faisant autorité en premier, raccourcir (par exemple « Nouvel article de Google : »).
  2. Enchaîner immédiatement avec le point le plus unique et le plus contre-intuitif de l'article, en utilisant un langage courant pour la situation (par exemple « Aide les producteurs à faire correspondre les plannings, le personnel et les budgets sur plusieurs feuilles, le score passe de 43 à 78 ») ; pour un seul cas, garder des limites comme « un vrai… », ne pas généraliser.
  3. Peut se terminer par une courte phrase de retournement (par exemple « Les poids du modèle n'ont pas été modifiés d'un iota. »).
  4. Donner ensuite le nom complet et l'institution, avec une phrase d'annonce (par exemple « Ensuite, nous allons décortiquer ensemble son architecture complète. »).
  • Ne pas mettre plusieurs grandeurs partageant un même chiffre dans une même phrase (par exemple « 8B », « un soixante-dixième », « 128 000 » peuvent être confondus à l'écoute).
  • Ne pas obliger le spectateur à comprendre un terme technique avant de pouvoir comprendre l'accroche : utiliser d'abord un langage courant pour décrire l'événement, la phrase anglaise originale n'apparaît qu'à l'écran ; les termes inconnus du public peuvent apparaître, mais ils doivent être définis dans le paragraphe suivant immédiatement.
  • Pour les comparaisons dans l'accroche, vérifier les éléments comparés et écrire les conditions limitatives ; pour chaque mot-clé dans l'accroche et le titre, il doit y avoir un paragraphe entier dans le corps du texte qui y répond (si on dit « auto-évolution », il doit y avoir un paragraphe « Est-ce que c'est une auto-évolution ? Où ça se voit ? »).
  • La trame 0 doit afficher le titre principal ou l'image la plus contre-intuitive en plein écran (132px, police Song Ti, déjà en place, ne pas faire apparaître depuis le blanc) ; les chiffres clés n'apparaissent que lorsqu'ils sont prononcés dans la voix off et deviennent le sujet principal de cette section (≥200px), ne pas les faire clignoter au début.

Portée des trois questions : Qu'est-ce qui est modifié (niveau) ? Pourquoi cela fonctionne-t-il (idée de l'auteur + mécanisme + pourquoi cela ne peut pas échouer, représente plus de la moitié) ? Que pouvons-nous apprendre ?

Exemple fil conducteur : choisir un exemple fourni par l'article lui-même, qui couvre chaque étape, tous les mécanismes y reviennent.

Chaîne de questions du public (à faire avant d'écrire le script) : écrire section par section « À cette écoute, le public se demandera quoi → comment répondre dans la phrase suivante », le modèle et les éléments obligatoires sont dans references/question-chain.md. La chaîne de questions et la chaîne logique sont soumises ensemble à la relecture de l'auteur. Il doit y avoir une section « eau froide ».

4. Voix off

Structure : accroche → problème (les prédécesseurs pointent un travail spécifique) → si tu étais l'auteur → essence en une phrase → architecture (selon la structure de regroupement de l'article) → parcourir un exemple de l'article étape par étape (chaque étape avec un « pourquoi ») → carte récapitulative (une phrase qui relie toutes les étapes) → questions-réponses sur le concept du titre → résultats (question → réponse) → eau froide (numérotée) → ce que nous pouvons apprendre → fin (question de discussion → signature + invitation à suivre).

Règles strictes pour la clarté

  • Donner un nom ne compte pas comme une explication. À la première apparition de chaque terme/mécanisme, donner une définition opérationnelle en une phrase : qui, regarde quoi, comment juge-t-il ? Traduire un terme d'article ne compte pas comme une explication.
  • Ne pas sauter d'étapes. Il doit y avoir un lien de cause à effet entre les actions (par exemple « Voir ces deux problèmes → modifier le fichier Harness »).
  • D'abord concret, puis abstrait. Dire d'abord quels fichiers ont été modifiés, ce qui a été écrit, puis dire à quelle catégorie cela appartient et comment cela s'appelle.
  • Préparer le terrain pour un nouveau concept avant de l'utiliser. Ne pas laisser des mots comme « candidat », « sélection à l'aveugle » apparaître pour la première fois dans la section eau froide.
  • Placer les preuves après la description des étapes, ne pas insérer de chiffres au milieu d'une étape ; pour une expérience comparative, dire d'abord comment le groupe témoin a été fait, puis le résultat.
  • Clarifier les rôles : lorsqu'il y a plusieurs modèles, dire explicitement « Il y a deux modèles ici : X fait le travail, Y modifie le Harness » ; préciser si les poids changent ou non, s'il y a de l'apprentissage par renforcement ou non.
  • À la première apparition d'un nom de benchmark, expliquer d'abord ce que c'est ; uniformiser les unités dans toute la vidéo (« points » pas « pourcentages ») ; éviter les ambiguïtés avec « il ».
  • Utiliser uniquement les appellations qui apparaissent dans la voix off pour les éléments à l'écran.

Style

  • Utiliser directement les termes techniques anglais familiers au public (Harness, agent, diff), avec une seule appellation pour toute la vidéo, sans créer de traduction chinoise alternative. Utiliser le vocabulaire standard du domaine (environnement RL, trajectoire, vérificateur), sans inventer de métaphores.
  • Parler en langage courant pour la situation ; traduire d'abord le nom de la tâche, du benchmark en une phrase en langage courant.
  • Si tu étais l'auteur : après avoir demandé « Qu'auriez-vous pensé ? », laisser une pause d'une seconde (l'écran affiche « ? »), puis dire « Je pense que… ». Les suppositions doivent être précédées de « Je pense ».
  • Essence en une phrase : doit pouvoir être reformulée, suivie d'une phrase de complément ; ne pas faire de phrases courtes de type slogan (voir la checklist).
  • Pour les longues listes, parler selon la propre structure de regroupement de l'article, en se basant sur le tableau original. Parler directement de l'article, ne pas le forcer à s'adapter aux outils du spectateur.
  • Parcourir une étape : diviser en « Première étape… Deuxième étape… », en précisant à chaque étape qui tient quoi, fait quoi, et ajouter un « pourquoi ». Pour les cas sélectionnés, préciser « c'est un cas choisi par l'article pour la démonstration, la moyenne n'est pas aussi élevée ».
  • Décrire chaque mécanisme selon le schéma « comment ça se faisait avant → quel était le problème → comment ça a été modifié → pourquoi c'est mieux ».
  • Pour les mécanismes techniques, fournir une comparaison de code avant/après la plus petite possible ; utiliser le code original si disponible (en le marquant « Extrait original · abrégé »), sinon écrire du pseudo-code marqué « Illustratif ».
  • Les analogies ne sont que des aides, placées après l'exemple. Parler des solutions « essayées mais non retenues ».
  • Avant de supprimer une information, se demander : si je supprime cela, le spectateur risque-t-il de comprendre de travers ?
  • Section résultats : chaque chiffre répond à une question, ne pas lire un bulletin de notes ; ne pas entasser plusieurs chiffres dans une même phrase. Lorsque le même « maximum / le plus » vient de comparaisons différentes, préciser le champ.
  • Section eau froide : « Il y a trois réserves. Premièrement… » numérotation complète ; le matériel provient du sous-agent de l'avis contradictoire ; lorsque des chiffres favorables sont cités, mentionner également les chiffres opposés.
  • Fin : ne pas faire la morale : « Que pouvons-nous en apprendre ? » « Ma plus grande leçon est… » ; éviter les phrases impératives comme « Ce que vous pouvez emporter ».
  • Langage oral, phrases courtes ; utiliser des chiffres arabes dans les sous-titres.
  • Passer en revue chaque phrase de references/voiceover-selfcheck.md avant de soumettre à validation.

Nombre de mots et rythme : environ 5,8 mots/seconde (caractères chinois, mots anglais, chiffres comptent chacun pour un) ; 6–8 minutes ≈ 2000–2700 mots. Ne pas compter sur l'accélération du débit, couper les pauses : dans une même section, les phrases sont enchaînées en une seule respiration, ne faire une pause complète qu'avant une question, un retournement, un chiffre clé ; dans le script, marquer les pauses complètes par « ‖ » (3 à 5 par chapitre). Objectif : les pauses représentent 10–12 % du temps, une pause toutes les 5 à 6 secondes en moyenne.

Format du fichier de voix off (lu directement par le moteur) : titre de section ## 00 · Nom de la section, les phrases à lire sur une ligne chacune, commençant par - ; les « > Cartes à l'écran » et les textes explicatifs ne sont pas lus. ID de phrase = s<section>-<numéro>.

5–6. Test à l'aveugle + Vérification des faits + Avis contradictoire (sous-agents indépendants, en même temps)

  • Test à l'aveugle « écoute unique » : deux rôles (A non expert, B expert), questions fixes, liste de malentendus, notation. Seuil : A ≥ 8 pour pouvoir passer à l'enregistrement vocal. Modèle de brief : references/listen-test-brief.md. Les problèmes soulevés lors du test à l'aveugle doivent être traités un par un, pas seulement une phrase ajoutée.
  • Vérification des faits : voix off + article, vérifier un par un les chiffres, l'intensité des attributions, les conditions limitatives, les éléments comparés, si les « suppositions » sont indiquées, si la structure de regroupement correspond au tableau original de l'article ; produire des must-fix (phrases directement remplaçables).
  • Avis contradictoire : ne donner que l'article, se placer du point de vue d'un relecteur : hypothèse la plus fragile, la comparaison est-elle équitable, les cases où il perd face à la baseline, la taille de l'échantillon, les contre-exemples, la reproductibilité en une semaine ; produire du matériel pour la section eau froide. Modèle de brief pour la vérification et l'avis contradictoire : references/factcheck-brief.md.
  • Chaque fois que le script est modifié (surtout si des chiffres et des conditions limitatives sont ajoutés après la vérification), relancer le test à l'aveugle et la vérification des phrases modifiées. La précision et la compréhension doivent être vérifiées ensemble. Calibrer le seuil par rapport aux scripts déjà publiés.

7. Relecture de la voix off par l'auteur (s'arrêter et attendre confirmation)

  • Donner d'abord une page de la chaîne logique : une ligne par section « Question du public → Réponse de cette section ».
  • Ne pas coller un bloc de texte entier : diviser par sections, avec un sous-titre, une phrase d'explication, une ligne par phrase de la voix off ; mettre en gras les conclusions clés.
  • Faire une relecture section par section, 1 à 3 sections à la fois, écrire « Maintenant → Problème → Après modification », poser des questions auxquelles on peut répondre directement par oui/non, utiliser un langage courant en donnant le contexte ; s'il y a un choix par défaut raisonnable, le suivre et dire une phrase sur ce qui a été fait.
  • Noter les préférences de l'auteur et mettre à jour cette compétence après la fin. Ne passer à l'enregistrement et à la production qu'après confirmation.

8. Storyboard : Carte de style, Plan de plans, Barre de progression

Carte de style

L'image = Squelette (structure, mouvements de caméra, plongée dans l'article, grand canevas, moments de transition, fixes pour toute la vidéo) + Carte de style (palette de couleurs, polices, matériaux, actions signature, style des éléments fixes). Changer de style ne change que la carte. Une seule carte par vidéo, rester sur la même carte au sein d'une série. Le rythme suit la voix off, la composition de chaque plan est redessinée selon la carte.

Carte ④ Presse données journalistiques (par défaut, engine/common/style.js déjà implémenté)

  • Palette : Papier #FFF1E5|Encre #33302E|Secondaire #66605C|Ligne fine #CCC1B7|Bordeaux #990F3D = amélioration / chiffres clés / nos annotations|Bleu Oxford #0F5499 = baseline / version originale|Cyan #0D7680 = correspondance, connexion, ✓|Gris #B9AFA6 = rejeté / neutre|Panneau de couleur blé #F2DFCE.
  • Polices : Titres chinois Noto Serif SC Black (accroche 132px, titres de chapitre / plan principal 92px, cartes 56–64px, interligne 1.1) ; corps de texte, étiquettes Noto Sans SC ; chiffres Inter 800 + tnum ; étiquette de colonne (kicker) Gras 28–30px, avec une courte ligne bordeaux de 56×5 au-dessus. Les polices sont téléchargées par style-cards/editorial/get-fonts.sh (OFL).
  • Mise en page : kicker + grand titre + introduction + figure ; marge gauche 120px, grille de colonnes stricte ; 1px ligne fine et 4px ligne épaisse pour la hiérarchie ; les graphiques ne montrent que des lignes de grille horizontales, les étiquettes sont directement placées sur les lignes et les points, sans légende ; annotations = ligne de guidage fine + une courte phrase d'explication ; ligne de provenance grise en bas à gauche de chaque écran (≥26px, dessinée uniformément par chrome.js).
  • Actions signature : le titre s'élève par un masque de ligne (easeOutQuart 0.55s, ED.maskLine) ; l'introduction apparaît par un balayage de gauche à droite (wipeText) ; la ligne fine pousse de gauche à droite (growLine) ; le contour du cadre se dessine dans le sens des aiguilles d'une montre (strokeCW) ; la ligne brisée se dessine de gauche à droite, les chiffres défilent de manière synchrone ; les phrases clés sont soulignées par un balayage bordeaux (underlineSweep) ; les plans de graphiques avancent doucement de 3–4%. Pas de rebond, pas d'incandescence.
  • Transitions : entre les chapitres, la page entière glisse horizontalement comme un journal (0.6s, dessiné uniformément par chrome.js) ; à l'intérieur d'un chapitre, déformation continue / grand canevas.
  • Éléments fixes : barre de progression de navigation en haut, style de colonne de journal ; barre de sous-titres de couleur blé (Song Ti Gras 44px) ; ligne de provenance — tous dessinés par engine/common/chrome.js, les chapitres ne les font pas eux-mêmes.
  • Inconvénients : plutôt froid, beaucoup de niveaux de texte, les annotations de 28px sur mobile restent trop petites, à supprimer si possible.

Autres cartes (pas d'implémentation dans le dépôt, écrire votre propre style.js si nécessaire) : ② Tableau blanc dessiné à la main (style Excalidraw, adapté à la décomposition d'architecture) ; ① Animation mathématique (style 3Blue1Brown, adapté à la dérivation de formules ; la règle stricte 8 ne recommande pas un fond sombre pour toute la vidéo, si vraiment nécessaire, réduire la luminosité des pages PDF blanches sur fond sombre et ajouter un vignettage) ; ⑤ Développeur sombre (adapté à la pratique d'ingénierie) ; ③ Nouveau brutalisme (adapté aux accroches courtes, fatigant pour une longue vidéo) ; A Explication blanc chaud (fond #FAFAF7, orange vif #D4552A = amélioration, bleu ardoise #3E6A8A en pointillé = baseline). En changeant de carte : les mouvements restent les mêmes, seuls le caractère d'assouplissement (④ ne rebondit pas) et l'apparence des transitions de chapitre changent ; la sémantique des couleurs est fixe : amélioré = couleur d'accentuation de la carte, baseline = couleur froide, rejeté = gris.

Règles pour les sections à haute densité (toutes les cartes)

  1. Un seul sujet principal par écran : ce dont on parle occupe environ 65 % de la largeur, la caméra s'approche d'un facteur 1.3–1.5 ; lorsqu'on change de sujet principal, le précédent se réduit en une fine barre récapitulative en haut ; ne reculer pour voir l'ensemble que pendant la phrase qui établit la relation, pendant 1–2 secondes.
  2. Limite de texte : en dehors des sous-titres, ≤ environ 25 caractères chinois, ≤ 4 blocs visuels par écran ; les paroles de la voix off ne sont pas réécrites en étiquettes ; un maximum d'une étiquette par élément.
  3. Ne pas utiliser d'étiquettes bilingues (chinois/anglais) ; tous les caractères à lire doivent mesurer ≥ 28px, la ligne de provenance peut mesurer 26px.
  4. Ne pas afficher de petits extraits d'article illisibles : si on veut citer, zoomer en taille réelle pendant ≥ 1.5s, ensuite ne laisser que la ligne de provenance ou un petit repère.
  5. Soyez sobre dans les espaces réservés : pour la colonne suivante, ne laisser qu'une fine ligne + un petit en-tête de colonne, ne pas déployer une grande structure grise.
  6. En haut, ne laisser qu'une seule barre de navigation : les étapes de ce chapitre sont transformées en sous-graduations dans la barre de progression, pas de ligne séparée.

Règles de storyboard communes à toutes les cartes

  • Rythmes clés : page originale → surligneur jaune rgba(250,199,117,0.7) qui suit la voix off de gauche à droite (avec un bruit de feutre) → l'original reste clairement visible ≥ 3 secondes (sans compter les entrées/sorties et les zooms) ; avant de redessiner un graphique, montrer d'abord l'original et entourer les points à expliquer.
  • Deux types de surligneur : pour souligner l'original = jaune (identique pour toutes les cartes) ; pour nos annotations (lignes de guidage, cercles, soulignements) = couleur d'accentuation de la carte (④ Bordeaux). Le spectateur distingue immédiatement ce qui est de l'original et ce qui est de l'interprétation.
  • Plans fixes : plan « parcourir une étape » | plan de comparaison de code | plan de tableau des niveaux | plan « dans la tête de l'auteur » (marqué « Supposition ») | plan d'expérience comparative (comment le groupe expérimental et le groupe témoin ont été réalisés) | carte récapitulative.
  • Opacité du fond de sous-titres ≥ 0.97, une ligne ≤ 22 caractères, cohérent mot pour mot avec la voix off.
  • Taille de police : les caractères à lire doivent mesurer ≥ 28px ; les caractères porteurs d'informations sont en couleur encre, le gris est réservé aux métadonnées.
  • Pas d'écran vide : le contenu remplit environ 70 % ; à tout moment (y compris pendant les images intermédiaires de déformation et de transition), une demi-part d'écran vide ne dépasse pas 2 secondes ; l'image à l'arrivée doit déjà avoir un sujet principal.
  • La sémantique de l'image ne doit pas induire en erreur : une chaîne de flèches verticales peut être lue comme un flux de données ; les éléments qui ne circulent pas vers le rôle suivant sont placés à côté, avec un cadre en pointillé et une annotation.
  • Marquer les schémas illustratifs par « Illustratif » ; les graphiques sont à l'échelle, les axes ont des étiquettes ; masquer le logo de l'article, n'utiliser que le texte pour le nom de l'institution.
  • Interdiction de remplir avec du bruit aléatoire (grilles de niveaux de gris avec Math.random, codes-barres, barres squelettiques) ; les schémas illustratifs utilisent 3–4 niveaux de dégradés lisses.
  • Interdiction de superposer des titres anciens et nouveaux (sortie d'abord, puis entrée) ; avant l'apparition d'une nouvelle image, l'ancienne image doit avoir complètement disparu, sans rémanence.
  • Les couches contenant du texte ne doivent pas être agrandies par scale()>1, mais reprises avec une nouvelle disposition et une nouvelle taille.
  • Pour la 3D, utiliser impérativement Three.js avec éclairage (boîtes aux coins arrondis, matériau mat, lumière hémisphérique + lumière principale + lumière de remplissage, ombres de contact cuites, rendu 2× puis réduction) ; CSS 3D interdit.

Zone de sécurité (à respecter lors du storyboard)

  • y 0–64 : réservé à la barre de progression ; la limite supérieure des éléments de la vidéo ≥ y80, le contenu normal est placé dans y 136–930, avec une marge gauche/droite de 96px.
  • y 900–940 : ligne de provenance ; y 952–1040 : barre de sous-titres. Les chiffres et étiquettes des graphiques n'entrent pas dans ces deux zones.
  • Avatar optionnel : en bas à droite, environ x>1660, y>840 ; le contenu à lire est placé dans x<1640, y<940.
  • Ne pas superposer ultérieurement la barre de progression / l'avatar sur la vidéo finie (cela réduirait le corps du texte et les sous-titres deviendraient plus petits).

Mouvements de caméra et transitions (trois techniques selon le contenu)

Interdire le « fondu vers une page blanche et reconstruction à partir de zéro » et les fondus croisés plein écran (comme un PowerPoint).

ContenuTechniqueMéthode
La majeure partie de l'explication : concepts, contexte, essence en une phrase, résultats, eau froideDéformation continue (style 3Blue1Brown)Les éléments du plan suivant émergent de ceux du plan précédent : une étiquette vole au centre pour devenir la forme principale, un mot de titre se réduit et s'intègre dans une formule, les sous-éléments jaillissent de l'élément parent lorsque la voix off les nomme, ? se transforme en ampoule, la carte question se transforme en carte eau froide. Chaque élément qui entre doit avoir une provenance
Citation du texte original de l'article, figure originalePlongée dans l'article (papier physique)L'article est une vraie feuille de papier avec une ombre, une inclinaison d'environ 1.5–2° (véritable page PDF, pas de barre grise de remplacement), habituellement repliée dans un coin ; lorsqu'on veut citer, elle glisse au centre, tourne la page (0.8s, en montrant le dos du papier), zoome 2–3 fois sur la phrase ou la zone, le surligneur passe ; lorsqu'on parle de la figure, la zone de la figure « flotte » et s'envole pour devenir une carte animée redessinée. L'extrait capturé s'arrête à côté sans couvrir la carte cible, et après utilisation, retourne dans une mini-carte dans le coin. Le zoom ne dépasse pas la résolution de la capture d'écran
Sections avec des étapes séquentielles (parcourir une étape, processus)Mouvement sur grand canevas (style Kurzgesagt)Les étapes sont disposées de gauche à droite sur un même grand canevas ; la caméra effectue un mouvement de translation entre les étapes (0.5–0.9s easeInOutCubic + whoosh) ; dans le coin, une mini-carte de l'article. Le squelette de la prochaine étape est préparé à l'avance, on peut voir la destination pendant la translation ; les cartes voisines, coupées en dehors de l'écran, sont assombries. N'utiliser que 1–2 segments par épisode, après avoir parcouru, reculer pour voir l'ensemble, puis se replier en une chaîne récapitulative
  • Squelette de toute la vidéo : déformation continue comme fondement → chaque fois qu'on mentionne l'article, y plonger → pour les étapes, utiliser le grand canevas → entre les grandes sections, utiliser des transitions de chapitre ≤ 0.6s, seulement 5–6 fois.
  • Syntaxe des animations : entrée ease-out (④ sans rebond), les sous-éléments sont décalés de 60–120ms ; mouvement de caméra easeInOutCubic ; un même objet reste le même élément à travers les plans (interpolation de position / échelle), pas de copie avec un nouveau fondu entrant ; lorsque la carte se réduit, le contenu doit suivre, pas d'abord vider puis réduire.
  • Flou de mouvement : 12–16 échantillons de poids égal, traînée ≤ la moitié du déplacement d'une image et ≤ 40px ; pas de flou directionnel lors des zooms avant/arrière ; flou plein écran pour les mouvements rapides ≤ 0.35s.
  • D'abord produire le plan de plans (references/shot-plan.md) : pour chaque segment, écrire la technique utilisée, ce que laisse le plan précédent, de quel élément le plan suivant émerge, la source dans l'article, le mot d'ancrage. Faire l'image seulement après que l'auteur l'a vu.

Barre de progression de la colonne en haut

  • Diviser en 6–8 colonnes selon les paragraphes de la voix off, utiliser un nom de colonne de journal en deux caractères à l'écran (Introduction / Contexte / Idée / Décomposition / Résultat / Doute / Enseignement…) ; « Accroche », « Eau froide » sont des appellations internes, pas à l'écran.
  • Configuration dans le répertoire du projet film.json sous nav : [{ "n": "01", "name": "Introduction", "sections": ["00"] }, ...] ; les temps de début et de fin proviennent de timeline.json. La colonne courante est en bordeaux, police Song Ti ; la progression déjà lue est une ligne bordeaux ; dans les 2 dernières secondes de chaque colonne, un pouls d'annonce pour la colonne suivante. Implémentation : engine/common/chrome.js.

Avatar (optionnel)

Par défaut, ne pas utiliser. Si on veut l'utiliser, utiliser une image que tu as le droit d'utiliser, préparer une piste d'avatar sur fond transparent, la superposer en dernière couche en bas à droite de la zone de sécurité lors du mixage ; présente en permanence dans toute la vidéo ou uniquement au début / chapitre / fin ; lorsque la caméra zoome dans l'article (≥ 1.4x, et que le texte original tomberait en bas à droite), l'avatar glisse complètement hors de l'image, et glisse de retour après que la caméra a reculé, en 0.35s chacun, pas de semi-transparence. Faire la mise en page selon la zone de sécurité dès le storyboard.

9. Voix (n'importe quel TTS)

  • Utiliser n'importe quel TTS capable de produire un fichier wav/mp3 (page web commerciale, API, modèle local), générer par sections (chaque lot ≤ environ 450 mots, les lots trop longs ont tendance à sauter des caractères). Écrire les chiffres, les numéros de version en lecture chinoise (quarante-trois virgule un, Opus quatre virgule huit) ; conserver les termes techniques anglais ; les sous-titres utilisent des chiffres arabes (numfix dans chapter.json).
  • Pour chaque lot, faire d'abord une reconnaissance vocale pour vérifier le premier et le dernier mot ainsi que les noms propres anglais (engine/voice/align.py asr), régénérer individuellement les phrases mal lues et les écrire dans overrides de voice.json.
  • Une méthode éprouvée (exemple) : sur une certaine page web TTS commerciale, choisir une voix de style technique explicatif, vitesse 1x ; pour chaque section, « coller le script → ajouter automatiquement des étiquettes d'émotion → générer → télécharger la 1ère version » ; lorsqu'on utilise l'automatisation du navigateur, ouvrir son propre nouvel onglet, ne pas toucher à l'onglet que l'utilisateur est en train de regarder. La voix et le compte sont à fournir par toi-même, ils ne sont pas distribués avec le dépôt.
  • Avant la livraison, retranscrire chaque section et vérifier le premier et le dernier mot de l'audio original ; fondu de sortie ≤ 2 images.

10. Alignement et pistes audio

  • uv run --with numpy python engine/voice/align.py voice.json : aligner le résultat de la reconnaissance avec la voix off caractère par caractère → les limites de phrases absorbent le silence → supprimer le silence au début et à la fin de chaque phrase, compresser les longues pauses à l'intérieur d'une phrase à ≤ 0.30s, atempo 1.05, fondu entrant/sortant de 8 ms → concaténer et sortir voice/voice.wav, timeline.json, clauses.json.
  • Paramètres de pause (dernier épisode publié) : début 0.3s, entre les phrases 0.35s, entre les sections 0.7s, fin 2.5s ; avant une question, un « ‖ », un chiffre clé, peut être augmenté à 0.8–1.0s.
  • timeline.json est la seule source de temps pour toute la vidéo : la barre de progression, les sous-titres, les mots d'ancrage, les cues d'effets sonores en proviennent tous. Pour ajouter une phrase, il suffit d'ajouter un segment et de relancer l'alignement. Quand il n'y a pas de voix, utiliser engine/tools/mk_dummy_timeline.py pour créer une timeline de remplacement et faire les images d'abord.
  • Musique de fond (engine/audio/audiolib.py music) : synthétisée avec numpy, pas de matériel protégé par des droits d'auteur. Pad chaud + arpèges doux + basse, F majeur Fmaj7–Dm7–Bbmaj7–C7, 84 BPM ; environ −28 LUFS ; lorsqu'une voix apparaît, ducking d'environ 7 dB (attaque 60 ms / relâchement 450 ms) ; fondu entrant/sortant au début et à la fin.
  • Effets sonores (sfx, environ 19 dB en dessous de la voix ; 24 dB ne s'entend pas sur un téléphone) : mouvement de caméra / transition de chapitre = whoosh ; surligneur = marker ; cartes / étiquettes / ✓✗ = pop (aligné sur la véritable image d'entrée de l'élément) ; défilement de chiffres = tick ; papier qui se soulève / tourne la page = paper. Pas de whoosh en l'absence de mouvement d'image. Les points de déclenchement sont enregistrés par data.cue() dans scene, et proviennent de la même source de temps que render(t).
  • Mixage (mix) : deux passes de loudnorm I=-16:TP=-1.8:LRA=11 → AAC 192k ; après encodage, mesurer le vrai pic ≤ −1.5 dBTP.
  • Avant la livraison, écouter une fois avec un casque et une fois avec le haut-parleur du téléphone (les mesures seules ne suffisent pas ; l'agent ne peut pas écouter, donc demandez à l'auteur d'écouter et de signaler les moments où la voix est la plus dense).

11. Production et rendu

Préparer d'abord les composants communs avant de déléguer le travail (documentation de l'interface engine/README.md)

  • timeline.json / clauses.json : temps de toute la vidéo ; le temps d'un chapitre = début et fin de sa section, en secondes locales.
  • film.json : ordre des chapitres, colonnes de la barre de progression, signature de fin.
  • engine/common/chrome.js : barre de progression, sous-titres, ligne de provenance, transition de journal au début du chapitre. Le chapitre ne dessine que renderContent, ne fabrique pas ses propres éléments fixes, de sorte que l'assemblage n'ait qu'un seul ensemble d'UI.
  • Brief du chapitre : texte complet de la carte de style + règles de haute densité + interface + règles factuelles + budget ; l'écrire dès le début, y compris « remplir environ 70 % de la surface, aucune image (y compris les images intermédiaires de déformation et de transition) ne doit être presque vide, titre principal du plan 92px, ne pas utiliser de barre grise de remplacement ».
  • Image mère : le code de l'image mère commune à toute la vidéo est écrit dans un fichier de spécifications (par exemple examples/always-on/MOTHER.md), chaque chapitre le copie sans modification.

En parallèle par chapitre : un agent de production par chapitre, le contrôleur principal ne fait que les composants communs, le rendu et l'assemblage.

  • renderContent(ctx, t, data) dans scene.js doit être une fonction pure de t : pas d'animations CSS, pas de minuteurs, les nombres aléatoires utilisent un PRNG avec seed. Les points de coupe ne peuvent être calculés qu'à partir des mots d'ancrage (data.A(ID_de_phrase, sous-chaîne)), pas de secondes écrites à la main.
  • Connexion des chapitres : à t=0 de chaque chapitre, la mise en page doit déjà être complète, les dernières 0.5s sont stables et immobiles ; engine/tools/prep_render.mjs exporte la dernière image sans chrome du chapitre précédent comme image de fond pour la page tournée du chapitre suivant (prev.png). Le premier chapitre peut implémenter renderPrev pour dessiner lui-même la « page précédente ».
  • Chapitre très long (>90s) : diviser en deux agents, utiliser une seule transition rapide pour la passation : les coordonnées des éléments sur l'image de passation, les coordonnées du canevas, la vitesse finale sont écrites en dur dans le brief.
  • En cas de modification des composants communs, les diffuser à tous les agents de chapitre ; les chapitres déjà rendus doivent refaire le rendu des images affectées ; en cas de doute, refaire le rendu de tout le chapitre.
  • L'auto-vérification de l'agent de production ne capture que des images fixes (ouvrir la page shell seek(t) en mode headless, faire une capture d'écran, ≤ 10 images par tour) ; le produit fini ne passe que par WebCodecs.

Rendu (chemin unique)

  1. node engine/tools/serve.mjs 8771 (écouter uniquement 127.0.0.1).
  2. Sur ce Chrome, ouvrir un nouvel onglet : http://127.0.0.1:8771/engine/common/shell-wc.html?ch=<répertoire_du_chapitre>.
  3. Dans la console await probe() : voir webglRenderer (doit être un vrai GPU, comme Apple M series / Metal, NVIDIA, AMD) et si prefer-hardware est pris en charge ; si software: true, s'arrêter et faire un rapport.
  4. startRender({ to: 10, download: false }) pour tester 10 secondes, voir __prog.msPerFrame (sur GPU généralement 5–15 ms/image).
  5. startRender({ name: 'chNN.mp4' }) → interroger __prog.state === 'done' → le navigateur télécharge. Chaque onglet ne télécharge qu'une seule fois (la deuxième tentative est silencieusement bloquée par Chrome), pour une sortie, créer un nouvel onglet, fermer après le rendu.
  6. Après le téléchargement, copier (ne pas déplacer avec mv) vers <chapitre>/build/video.mp4, ffprobe -count_frames vérifier que le nombre d'images = ceil(T×30).
  7. node engine/common/assemble.mjs --project <répertoire_du_projet> : concaténation image par image, musique et effets sonores, mixage, encapsulation, produire une version légère < 30MB. Ne pas utiliser -shortest pour le mixage, la différence audio/image doit être < 1 image.

Ordre : Échantillon → Relecture indépendante → Vidéo complète → Finition artistique → Nouvelle relecture → Révision .1

  1. Produire d'abord deux échantillons entièrement assemblés : A = accroche + première plongée dans l'article (environ 30 secondes) ; B = les premières étapes du grand canevas (environ 40 secondes). Montrer à l'auteur pour vérifier l'effet et le volume, et soumettre en même temps à l'agent de relecture.
  2. L'agent de relecture est indépendant de la production (ne regarde que le produit fini + cette compétence + la fiche article), vérifie un par un selon references/review-checklist.md, produit des must-fix / should / nice, avec les codes temporels et les modifications spécifiques.
  3. Les must-fix sont appliqués uniformément à toute la vidéo, pas seulement à la plage de l'échantillon.
  4. Finition artistique par chapitre : une fois le contenu et la timeline verrouillés, chaque chapitre est confié à un agent chargé uniquement de l'esthétique (ne modifie pas la voix off, l'ordre des plans, les chiffres), capture 3 images par plan (au milieu de l'entrée / à l'arrêt / avant la sortie), comme une affiche pouvant être capturée individuellement ; vérifier les quatre niveaux de hiérarchie des polices, si le sujet principal est suffisamment grand (chiffres clés ≥ 200px), si les actions signature sont utilisées, si la sémantique des couleurs n'est pas erronée, si les colonnes sont alignées, s'il n'y a pas de carte PowerPoint avec un cadre gris par défaut et de petits caractères. Les problèmes de contenu sont notés dans la relecture et renvoyés au producteur.
  5. Nouvelle relecture de toute la vidéo, corrections et sortie de la version .1 ; ne pas envoyer de « version finale » avant d'avoir eu une série de relecture.

12. Auto-vérification et livraison

  • Selon references/review-checklist.md, une auto-vérification exhaustive avant la livraison.
  • Utiliser engine/tools/dedup-frames.mjs pour détecter les images dupliquées (mêmes trames consécutives) ; si plus de 10 images consécutives sont identiques, marquer l'endroit pour une vérification manuelle.
  • Vérifier la synchronisation labiale et sonore : l'audio ne doit pas être en avance ou en retard de plus d'une image (environ 33 ms).
  • Vérifier la résolution et le format : 1920×1080, 30 ips, H.264 High Profile, AAC 192 kbps.
  • Vérifier l'intégrité : la vidéo doit contenir toutes les sections prévues, dans le bon ordre.
  • Vérifier les sous-titres : ils doivent correspondre mot pour mot à la voix off, sans erreur de transcription.
  • Vérifier les crédits de fin : ils doivent être conformes à la configuration de film.json.
  • Une fois l'auto-vérification terminée, produire un rapport et le soumettre à l'auteur avec la vidéo finale.

Règles supplémentaires pour les vidéos de type « on vous explique tout sur »

  • Une seule image mère : utiliser un schéma fondamental qui relie tous les chapitres, chaque chapitre le reprend avec le même vocabulaire.
  • Un seul exemple fil conducteur : choisir un exemple représentatif qui traverse l'ensemble de la revue, chaque chapitre y fait référence.
  • Ne pas créer de cadre artificiel : utiliser la structure de classification de l'article original (ou des articles) pour organiser les chapitres, ne pas inventer de nouvelle structure.
  • Ne pas surcharger d'informations : un seul chiffre principal par chapitre, les autres sont placés sur des cartes à l'écran.
  • L'accent sur la progression : les chapitres doivent aller du plus simple au plus complexe, ou suivre un ordre logique de processus.
  • Revenir à l'accroche : le dernier chapitre doit boucler la boucle en revenant sur l'accroche du début.
  • Autorité : l'autorité de la revue vient des articles originaux et du code open source, pas de l'opinion personnelle.

Règles pour les vidéos de type « une seule vidéo pour tout expliquer » (synthèse d'un long article)

  • Suivre la structure de l'article original : ne pas réorganiser arbitrairement, mais utiliser la logique de l'article lui-même.
  • Un exemple fil conducteur : choisir un exemple unique qui traverse tout l'article, toutes les explications y reviennent.
  • Gestion de la longueur : si l'article est très long, diviser en plusieurs vidéos, mais chaque vidéo doit avoir une autonomie suffisante.
  • Mettre en avant les points clés : ne pas chercher à tout couvrir, mais sélectionner les mécanismes et les résultats les plus importants.

Règles pour les vidéos techniques longues (articles techniques, documentation)

  • Définir le public : déterminer clairement le niveau de connaissance du public cible et ajuster la profondeur des explications en conséquence.
  • Mettre en avant la pratique : donner la priorité aux exemples concrets, aux extraits de code, aux cas d'utilisation réels.
  • Structure en chapitres : diviser le contenu en chapitres clairs, chacun avec un objectif d'apprentissage spécifique.
  • Récapitulation : à la fin de chaque chapitre, faire une récapitulation rapide des points appris.

Conclusion

Cette compétence fournit un cadre complet pour transformer des articles de recherche et des documents techniques en vidéos explicatives de haute qualité. En suivant ce processus, tu peux produire des vidéos à la fois précises et engageantes qui aident le public à comprendre des concepts complexes. N'oublie pas de toujours te référer aux règles strictes et aux checklists pour garantir la qualité de la production.

Skills associés