Communitygithub.com

federicobrancasi/pr-studio

Utilisez cette compétence lorsque l'utilisateur souhaite une vidéo expliquant une pull request (un explicateur de PR, une vidéo de révision, « crée une vidéo pour <URL de la PR> »). Elle couvre l'ensemble du workflow du dépôt : récupération de la PR, écriture du script, voix, choix et remplissage des diagrammes, vérifications, rendu, validation par le directeur de PR et livraison.

Qu'est-ce que pr-studio ?

Cette compétence automatise la création de vidéos explicatives de pull requests (PR) d'une durée de 40 à 100 secondes, destinées à des publics non techniques (souvent des managers). Elle couvre l'ensemble du pipeline : récupération des données de la PR, rédaction d'un storyboard basé sur des faits (sans supposition), génération vocale via Mai-Voice-2 ou Kokoro local, sélection de traitements visuels via des diagrammes depuis un catalogue, rendu vidéo, et publication avec sous-titres et validation automatisée. Le workflow est exécuté via des commandes CLI (prs) et chaque étape impose des vérifications de précision, de provenance du texte et d'originalité des explications. La compétence s'utilise sur machine locale (CLI) ou via Slack avec des contraintes de temps (59 minutes) et intègre un agent pr-director pour la validation finale. Le processus est conçu pour être rapide (15-20 minutes) tout en garantissant une qualité et une exactitude élevées.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/federicobrancasi/pr-studio/tree/HEAD/.claude/skills/pr-video

Demander à votre IA préférée

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

Documentation

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)

  1. Récupération. prs new <URL de la PR> écrit videos/<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.
  2. Histoire. Écrivez videos/<slug>/storyboard.json : une idée par temps, un besoin par temps, des indices, et les affirmations avec preuves (guides/story.md). Exécutez prs check jusqu'à ce qu'il dise prêt pour prs voice.
  3. 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.
  4. Direction. prs direct choisit un traitement pour chaque temps et le mouvement pour la vidéo, écrit direction.json, et échafaude scenes.js avec 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 avec prs direct --use <temps>=<traitement> --reason "..." (la raison est enregistrée et examinée).
  5. Visuels. prs stills rend les images clés et build/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).
  6. Vérification. prs lint doit signaler 0 problèmes (mise en page, provenance du texte, bande de légende, nouveauté, QR).
  7. Rendu et publication. prs render (quelques secondes, les images sont mises en cache), puis prs 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.
  8. Validation. Suivez guides/review.md jusqu'à ce que l'agent pr-director réponde VERDICT: SIGNED OFF ; republiez après les corrections.
  9. 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 de pr.json), quote() (texte exact de la PR), ident() (noms de code dans la diff), path() et code(). prepare vérifie chaque élément par rapport à la PR ; les nombres dans un label() 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.js d'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 dans catalog/ (avec démo, when, paramètres, une image du catalogue via prs 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 checkstoryboard : fenêtre de durée, indices, espaces réservés, ancres de preuves, indices de prononciation
`prs voice [--provider maikokoro
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 draftimages finales / un mp4 d'aperçu demi-taille
prs publishencodage, sous-titres, vérification de synchronisation, livraison, galerie
prs catalogchaque traitement avec ses paramètres
`prs triage --file f, prs summary, prs budget`
prs history, prs reportvidéos récentes ; où le temps est passé
prs smokeune courte vidéo de démonstration de bout en bout, avec chronométrage : cette machine est-elle prête ?

Skills associés