Formation vidéo : storyboard d'abord, puis l'application réelle à l'écran
Une vidéo de formation se compose d'un ensemble de cartes en forme de téléphone. Chaque carte comporte un titre, une ligne d'aide, une image clé de l'application réelle avec des légendes, et une ligne de narration. Certaines cartes diffusent un court clip de l'application au lieu d'une image fixe. Les mêmes cartes sont livrées sous forme de diapositives et d'un PDF.
Un seul fichier pilote tout : storyboard.json. Dave le modifie via un canevas de conception ; chaque script de construction le lit.
Quand l'utiliser
À utiliser pour :
- Une vidéo de formation, de démarrage, de démarrage rapide ou un didacticiel montrant l'application
- Des captures d'écran annotées ou un guide de diapositives pour les techniciens, conseillers ou personnel des pièces détachées
- Une révision d'une vidéo réalisée avec ce skill (nouveau texte, nouvelle carte, nouveau clip)
Ne pas utiliser pour :
- Une vidéo marketing ou promotionnelle (ton différent, règles différentes ; demander à Dave)
- Des vidéos d'inspection client enregistrées dans le produit
- Une maquette d'un écran qui n'existe pas encore (utiliser
/visual)
Principes
- Storyboard avant production. Rien n'est narré ou assemblé avant que Dave ait modifié le canevas du storyboard et dit qu'il a terminé.
- Montrer la vraie application, faisant la vraie chose. Vrai scan, vraie dictée, vraie histoire générée. Jamais d'écran simulé, jamais de résultats saisis.
- Dave décide sur le canevas, pas dans le chat. Relire le canevas et le différencier. Ne pas reconstruire ses instructions à partir de la conversation.
- Une prise approuvée est conservée. La narration n'est régénérée que pour les lignes dont les mots ont changé. Ne jamais écraser une version que Dave a révisée ; livrer
-v2,-v3. - Claude ne peut ni entendre ni regarder. Le dire à chaque retour. Prouver les mots par la transcription et les images par des exemples de frames, et nommer ce qui n'a pas été vérifié.
- Laisser le magasin tel qu'on l'a trouvé. Mode restauré et confirmé, bons de réparation de reprise fermés.
À lire d'abord
/Users/davidsonders/ro-bot/shared/product-facts.mdetshared/brand.md: noms, compteurs, mots interdits. Pas de tirets cadratins, pas d'émojis, « TenthGear » en un mot. Ne jamais dire « single player » ou « multi-player » dans tout ce que le spectateur voit ou entend.reference.mddans ce dossier : les pièges techniques, chacun déjà payé une fois.- Notes mémoire sur le canevas de conception :
reference_design_canvas_mechanics,reference_design_canvas_roundtrip,reference_design_canvas_entity_crash.
Où se trouvent les éléments
| Quoi | Où |
|---|---|
| Dossier du projet vidéo | /Users/davidsonders/ro-bot/training-videos/<slug>/ (jamais le scratchpad de session, qui meurt avec la session) |
| La seule source de vérité | <project>/storyboard.json |
| Images clés, clips, narration | <project>/frames/, footage/, narration/ |
| Constructions | <project>/out/ |
| Ce que reçoit Dave | ~/Desktop/<Titre>/ |
| Exemple pratique | training-videos/story-writer-getting-started/ et examples/story-writer/ ici |
Les scripts se trouvent dans scripts/ ici. Ils prennent le dossier du projet comme premier argument.
Flux de travail
Faire une liste de tâches pour ces étapes et les parcourir dans l'ordre.
Étape 0 : Définir le brief
Trouver ces éléments dans la demande. Ne demander que ce qui manque, une question, recommandation d'abord.
| Décider | Par défaut |
|---|---|
| Qui regarde, et dans quel rôle | Technicien |
| Téléphone ou bureau | Téléphone, 390 x 844 |
| Quel flux, du début à la fin | Le plan de Dave |
| Magasin et mode de flux de travail | Demander à Dave. Voir Étape 2. |
| Images fixes uniquement, ou images plus clips | Des clips partout où l'écran bouge : enregistrement, chargement, ouverture et fermeture |
| Durée | Moins de 2:30 |
Étape 1 : Storyboard sur un canevas de conception
C'est la première chose que voit Dave et l'endroit où il modifie le script et les légendes.
-
Créer le dossier du projet et générer les accessoires (
props/render-paper.mjsproduit l'exemple de bon de réparation papier). -
Explorer le flux pour les images clés. Les images clés proviennent de l'application réelle, donc cette étape nécessite une session de capture (Étapes 2 et 3, images fixes uniquement). Copier
examples/story-writer/capture-stills.mjsdans le projet et réécrire le flux. Regarder chaque image avant de continuer. -
Rédiger
storyboard.json. Une carte par action que le spectateur effectue. Format :{ "id": "write-story", "part": 2, "img": "10-write-story", "title": "Appuyer sur [[Écrire l'histoire]]", "body": "Le rédacteur IA examine vos notes et rédige les 3C pour vous.", "boxes": [[183, 400, 191, 44]], "arrow": [162, 768], "footage": { "clip": "C-write", "runs": [[15, 336]], "note": "Ce que montre le clip" }, "narration": "Lorsque vous êtes prêt, appuyez sur Écrire l'histoire." }boxesetarrowsont en pixels téléphone ; la capture écrit la zone de chaque contrôle à côté de son image.[[Étiquette]]dessine un bouton. Suivre les règles de style ci-dessous dès le premier brouillon. -
Créer le canevas. Outil d'artefact :
quickstartavec intentiondesign, puis publier avec l'type_urlqu'il renvoie et un titre. Enregistrer l'url dans<project>/storyboard/artifact.json. -
Télécharger les images clés sur le canevas en tant que ressources (JPEG, 1688 px de hauteur, mis en scène dans le scratchpad pour qu'elles soient envoyées en un seul appel). Enregistrer chaque url
/_blob/...retournée sousassetsdansartifact.json, indexée par nom d'image. -
Générer et publier.
node scripts/storyboard-canvas.mjs <project>écritstoryboard/project/. Copier ce dossier dans le scratchpad et le publier :canvas.jsoncommefile_path, chaque.dc.htmldansfiles. -
Donner le lien à Dave et s'arrêter. Lui dire : retaper les mots d'une carte, la note bleue sous chaque carte est la piste vocale, faire glisser les légendes jaunes, écrire toute autre chose sur une note. Ne pas commencer la production.
-
Récupérer ses modifications. Artefact
readavecpaths(l'index et chaque planche) et unout_dir, puisnode scripts/storyboard-harvest.mjs <project> <out_dir>. Lire le rapport en termes simples, agir sur les notes qu'il a ajoutées, puis relancer avec--write. -
Un autre tour ? Relire
project/canvas.json, régénérer avec--live <ce fichier>, republier. Une publication qui ne part pas de l'index en direct est refusée.
Étape 2 : Emprunter un magasin
L'application doit être dans le mode que la vidéo montre. Seuls les magasins de test peuvent être utilisés.
| Magasin | Id | Mode normal | Notes |
|---|---|---|---|
| Summit Auto Group (démo) | demo-dealership | flux de travail en équipe | Démo de prospection de Dave. Identifiants [email protected] (tech), marcus@ (conseiller), priya@ (pièces). Utilisé pour la première vidéo. |
| Concessionnaire de test 1 | mlTaPo12wbpUtJB9GXJM | flux de travail en équipe | Partagé avec les sessions de construction. Souvent occupé. |
ListAgents, puisSendMessageà chaque pair : utilise-t-il le magasin, et a-t-il besoin du mode ? Attendre la réponse. Si un pair en a besoin, utiliser l'autre magasin ou demander à Dave.- Lire d'abord le mode :
NODE_OPTIONS='-r dotenv/config' npm run --silent manage-org -- info <id>depuis le dossier de l'application. - Le modifier uniquement pour les minutes d'une session de capture, dans la même chaîne de commandes que la capture et la restauration. Puis le relire et confirmer.
- Ne jamais toucher à un magasin client. Ne jamais modifier les préférences d'un compte de test.
Étape 3 : Capture
- Images fixes :
dpr: 3. Une image par carte, prise après que l'écran se soit stabilisé. - Clips :
dpr: 2avecvt.recorder. Ouvrir chaque clip avec un temps d'arrêt, montrer le marqueur de doigt, puis agir. Liremarks.jsonpour choisirfootage.runs. - La dictée est réelle.
vt.dictationjoue un clip parlé dans un faux micro ; l'application l'enregistre et le transcrit. Imprimer chaque transcription et la lire : le transcripteur réécrit les nombres et les noms de marque. - Une reprise nécessite un nouveau bon de réparation. Les numéroter vers le haut et lister chaque identifiant dans
created-ros.txt.
Étape 4 : Diapositives
node scripts/build-slides.mjs <project> écrit out/slides/*.png, le PDF, et les couches nécessaires à la vidéo. Regarder une planche contact de chaque carte. Vérifier qu'aucune légende ne couvre l'élément qu'elle pointe.
Étape 5 : Narration
cd /Users/davidsonders/ro-bot/app
NODE_OPTIONS='-r dotenv/config' node ~/.claude/skills/video-training/scripts/narrate.mjs <project>
Voix ash, modèle gpt-audio-1.5 (remplacé gpt-4o-mini-tts, qu'OpenAI désactive le 2027-01-06). Une prise dont la transcription ne correspond pas aux mots de la carte est réessayée, puis refusée. Dave a approuvé cette voix et rejeté les voix intégrées du Mac comme robotiques. Elle utilise la clé OpenAI de l'application et coûte quelques centimes par construction : le dire dans le brief pour chaque nouvelle vidéo, pour que la dépense ne soit jamais une surprise. DRY=1 liste ce qui serait régénéré.
Écrire la narration pour l'oreille : « R O », « trois C », « tenthgear point A I ». Annoncer chaque partie sur sa première carte.
Étape 6 : Vidéo
node scripts/build-video.mjs <project>. La vitesse est de 1,25 (le « Rapide » de QuickTime), le rythme approuvé par Dave. Une carte avec un clip dure aussi longtemps que le plus long de sa narration et de son clip.
Étape 7 : Vérifier, et dire ce qui n'a pas été vérifié
check-audio.mjstranscrit la vidéo et note chaque carte. Lire chaque ligneLOOK.- Extraire une image de chaque carte qui a un clip ou une flèche et la regarder.
- Dans le retour, dire clairement : pas écouté, pas regardé en entier.
Étape 8 : Livrer
Copier la vidéo, le PDF et out/slides/ vers ~/Desktop/<Titre>/. Conserver les versions précédentes. Donner la durée, ce qui a changé, et tout ce que Dave pourrait remarquer (un numéro de bon de réparation différent dans un clip, une légende déposée sur une séquence).
Étape 9 : Nettoyer
- Mode du magasin restauré, puis relu et confirmé.
node scripts/close-ros.mjs <project> <email> <org-id>ferme les reprises. La suppression des bons de réparation est la décision de Dave.- Dire à tout pair à qui vous avez envoyé un message que le magasin est libre.
Règles de style (Dave, 2026-09-29)
| Règle | Exemple |
|---|---|
| Un bouton que le spectateur tape est dessiné comme un bouton | Appuyer sur [[Nouveau BR]] |
| Les en-têtes de partie sont courts, sans « of 3 » | PARTIE 2 : HISTOIRE DE GARANTIE |
| La couverture n'a pas de nombre d'étapes | |
| Une carte par étape. Fusionner les cartes qui montrent une seule décision. | Réviser et enregistrer sont une seule carte |
| Supprimer une carte dont le point est évident | Lire Cause et Correction |
| Dire qui agit et avec quoi | « Ajouter une note vocale », pas « Ajouter une note » |
| Lorsque deux choses à l'écran pourraient être visées, pointer sur l'une | Flèche sur le bouton vert |
| Tout ce qui bouge dans l'application doit bouger dans la vidéo | Forme d'onde, spinner, ouverture de carte |
| Mots d'atelier | BR, ligne, histoire, 3C, CP |
Dave donne les modifications de diapositives par numéro de page PDF. La page 1 est la couverture, donc « pg 7 » correspond à l'étape 6. Reformuler chaque modification par nom d'étape avant de l'appliquer.
Critères de succès
- Dave a modifié le canevas du storyboard et ses modifications ont été récupérées, pas devinées
- Chaque image et clip provient de l'application réelle, dans le mode de la vidéo concernée
- Diapositives, PDF et vidéo proviennent tous du même
storyboard.json - Narration vérifiée par transcription ; lignes peu claires nommées
- Le retour indique ce qui n'a pas été écouté ou regardé
- Mode du magasin restauré et confirmé ; bons de réparation de reprise fermés
- Dossier du projet conservé en dehors du scratchpad
Compétences associées
/visualpour les maquettes d'écrans qui n'existent pas encore/app-testingpour les comptes de test et le harnais de test en direct que cela emprunte/compoundensuite, si une capture a révélé un bug produit ou un nouveau piège