Vidéo de PR
Un explicateur de 40 à 100 secondes sur une pull request, pour quelqu'un qui ne la lira pas (souvent un manager) : quels changements,
pourquoi, comment cela fonctionne, quels sont les risques, le statut, et par où un relecteur devrait commencer. Technique mais simple.
Tout passe par la CLI : node cli/prs.mjs <commande> depuis la racine du dépôt, ou
node <chemin vers pr-studio>/cli/prs.mjs <commande> depuis n'importe où (ci-dessous : prs).
Début
- Personne ne regarde (un job GitHub Actions) ? Lisez d'abord guides/unattended.md : pas de questions, une limite de temps, un cycle de révision, où va le résultat.
- Démarré depuis Slack (@GitHub, une session cloud) ? Lisez d'abord guides/slack.md : triage, le budget de 59 minutes, publication de chaque vidéo dans le fil, et ce qu'il ne faut pas y faire.
- Une fois par machine :
prs doctor(navigateur, modèle vocal, Whisper, ffmpeg ; il ajoute uniquement ce qui manque). - Ensuite, lisez guides/story.md et guides/visuals.md. Parcourez catalog.md pour les diagrammes disponibles.
Workflow (visez 15-20 minutes)
- Récupération.
prs new <URL de la PR>écritvideos/<slug>/:brief.md(lisez-le entièrement),pr.diff(recherchez les lignes dont vous avez besoin ; ne le lisez pas en entier),pr.json, et un squelette de storyboard avec le bon nombre de temps. - Histoire. Écrivez
videos/<slug>/storyboard.json: une idée par temps, unbesoinpar temps, des indices, et les affirmations avec preuves (guides/story.md). Exécutezprs checkjusqu'à ce qu'il dise prêt pour prs voice. - Voix, en arrière-plan. Lancez
prs voice(environ une minute ; MAI-Voice-2 lorsqu'une clé Azure est configurée, sinon la voix Kokoro locale) et continuez à travailler pendant son exécution. - Direction.
prs directchoisit un traitement pour chaque temps et le mouvement pour la vidéo, écritdirection.json, et échafaudescenes.jsavec ces traitements. Remplissez chaque TODO à partir de la PR. Gardez les choix : ils sont choisis pour différer des vidéos récentes. Si l'un d'eux ne peut vraiment pas montrer son temps, re-sélectionnez-le avecprs direct --use <temps>=<traitement> --reason "..."(la raison est enregistrée et examinée). - Visuels.
prs stillsrend les images clés etbuild/stills/contact.png. Ouvrez la planche contact et les images qui comptent, et corrigez ce que vous voyez. Les images fonctionnent avant que la voix ne soit terminée (timing provisoire). - Vérification.
prs lintdoit signaler 0 problèmes (mise en page, provenance du texte, bande de légende, nouveauté, QR). - Rendu et publication.
prs render(quelques secondes, les images sont mises en cache), puisprs publish: encodage, sous-titres, vérification de synchronisation (audio vs légendes), livraison vers~/Downloads/pr-videos/<slug>/, et l'entrée de la galerie. - Validation. Suivez guides/review.md jusqu'à ce que l'agent
pr-directorrépondeVERDICT: SIGNED OFF; republiez après les corrections. - Livraison. Donnez le chemin du mp4, sa durée, un résumé d'une ligne par temps, le verdict, et ce que vous n'avez pas pu vérifier (vous ne pouvez pas entendre l'audio ; la vérification de synchronisation le mesure).
Facultatif : si l'utilisateur demande des options, ajoutez export const concepts = { beat, options: { a, b, c } } à
scenes.js et exécutez prs concepts : il rend le temps de trois façons côte à côte.
Règles
- Précis ou absent. Chaque affirmation dans le commentaire et à l'écran doit provenir de la PR : son corps, ses commits, sa diff, ses tests ou son code au commit de tête. Écrivez les affirmations non testées de l'auteur comme « selon l'auteur ». Pas de suppositions sur l'intention, pas de marketing.
- Provenance du texte. Le texte à l'écran passe par
label()(vos mots),fact()(nombres et noms provenant depr.json),quote()(texte exact de la PR),ident()(noms de code dans la diff),path()etcode().preparevérifie chaque élément par rapport à la PR ; les nombres dans unlabel()sont signalés. - Un seul aspect. Blanc, palette Microsoft, Aptos. N'ajoutez pas de couleurs, polices, arrière-plans ou nouvelles mises en page à l'intérieur d'une vidéo. La première image (titre) et la carte de fin sont fixes.
- Explications différentes. N'ouvrez et ne copiez jamais le
scenes.jsd'une autre vidéo ; la galerie ne conserve que les storyboards et les planches contact. Si le catalogue ne contient pas de diagramme dont la PR a besoin, ajoutez un traitement danscatalog/(avec démo,when, paramètres, une image du catalogue viaprs catalog --stills, lint propre) plutôt que de placer des pixels manuellement. - Regardez ce que vous créez. Ouvrez les images et la planche contact avant de dire que quelque chose fonctionne.
Commandes
prs new <url> | récupérer la PR, écrire brief.md et un squelette de storyboard |
prs check | storyboard : fenêtre de durée, indices, espaces réservés, ancres de preuves, indices de prononciation |
| `prs voice [--provider mai | kokoro |
prs direct [--use beat=treatment --reason ...] | choisir les traitements et le mouvement ; échafauder scenes.js |
prs stills [--beat id] [--at 12.3,20] | images clés + planche contact |
prs lint [--every 0.5] | mise en page, provenance, bande de légende, nouveauté, QR |
prs render / prs draft | images finales / un mp4 d'aperçu demi-taille |
prs publish | encodage, sous-titres, vérification de synchronisation, livraison, galerie |
prs catalog | chaque traitement avec ses paramètres |
| `prs triage | --file f, prs summary, prs budget` |
prs history, prs report | vidéos récentes ; où le temps est passé |
prs smoke | une courte vidéo de démonstration de bout en bout, avec chronométrage : cette machine est-elle prête ? |