Expliqueur de Génie Logiciel Remotion (remotion-software-explainer)
Vue d'ensemble
Transforme toute conception système, architecture distribuée, patron de conception, mécanisme interne de base de données, ou flux DevOps en une vidéo explicative Remotion immersive, synchronisée sur les images, au format 1920×1080 30ips MP4, dans le Format Studio Log2Base2 à un seul volet.
Ne fractionnez jamais l'écran en volets concurrents côte à côte ou en murs de fiches textuelles empilées. Chaque vidéo utilise une scène visuelle unifiée (<SinglePaneStage>) :
- Barre supérieure minimale (
44px, intégrée àSinglePaneStage) :- Titre du sujet + pilule de section active à gauche ; compteur d'étapes subtil + barre de progression fine à droite.
- UNE Scène Log2Base2 Unifiée (
SinglePaneStage— 100% de largeur) :- En-tête de projecteur focalisé sur une seule ligne : met en surbrillance l'élément parlé actif (
replicas: 3,ConsistentHash,WAL,CircuitBreaker) dans la ligne de spécification/contrat active avecborderBottom: "2px solid #FACC15"(n'ajoutez jamais de remplissage horizontal) plus une pilule d'appel compacte active (terme→rôle architectural) àtriggerFrame. - Toile SVG immersive plein écran (
viewBox="0 0 1600 680") : Nœuds de service vectoriels progressifs (Client, API Gateway, Équilibreur de charge, Microservices, File de messages, Cache, Fragments de base de données, Pods K8s) apparaissant lorsqu'ils sont mentionnés, connectés par des pipelines animés en pointillés avec des paquets de requêtes voyageurs, des jauges de succès de cache/débit en direct, et des traces de requêtes qui s'écoulent directement sur la même toile ouverte.
- En-tête de projecteur focalisé sur une seule ligne : met en surbrillance l'élément parlé actif (
- Barre de sous-titres inférieure minimale (
VoiceoverCaptionBar—68px) :- Sous-titres karaoké nets centrés avec surbrillance mot par mot, pilotés par les horodatages précis
WordBoundaryde la synthèse vocale.
- Sous-titres karaoké nets centrés avec surbrillance mot par mot, pilotés par les horodatages précis
Dépendances
remotion-best-practices(~/.gemini/skills/remotion/SKILL.md)uv(~/.gemini/config/plugins/science/skills/uv/SKILL.md)
Démarrage rapide
# 1. Initialiser le projet
uv run python3 \
~/.gemini/config/skills/remotion-software-explainer/scripts/explainer_cli.py \
scaffold \
--project-dir "/chemin/vers/projet" \
--output "/chemin/vers/projet/scaffold-status.json"
# 2. Synthétiser la voix
uv run --with edge-tts python3 \
~/.gemini/config/skills/remotion-software-explainer/scripts/explainer_cli.py \
synthesize-voiceover \
--project-dir "/chemin/vers/projet" \
--beats-json "/chemin/vers/projet/beats.json" \
--voice "en-US-AndrewNeural" \
--rate "+2%" \
--pause-sec 0.40 \
--output "/chemin/vers/projet/public/voiceover/manifest.json"
# 3. Rendre la vidéo 1080p MP4
uv run python3 \
~/.gemini/config/skills/remotion-software-explainer/scripts/explainer_cli.py \
render-mp4 \
--project-dir "/chemin/vers/projet" \
--composition-id "SoftwareExplainer" \
--out-name "SoftwareExplainer.mp4" \
--concurrency 8 \
--output "/chemin/vers/projet/render-report.json"
Narration immersive et flux de travail
- Gardez le
snippetciblé (2–4lignes) afin que<SinglePaneStage>mette en avant une ligne de contrat active et révèle les nœuds d'architecture progressivement – ne déversez jamais 15 boîtes sur l'image 0. - Définissez
"motionStepFrames": 2dans les sections avec des paquets de requêtes voyageurs, des cascades de bascule, ou des animations d'auto-adaptation. - Montrez, ne dites pas : Animez les paquets de requêtes se déplaçant entre les nœuds avec des barres de latence, de file d'attente et de trace en direct directement à l'intérieur de la même toile SVG plein écran
1600×680(en utilisant<clipPath>si nécessaire), jamais dans des boîtes séparées en écran partagé. - Exécutez toujours
npm run lint, inspectez des images représentatives (npx remotion still) avecread_file, et sauvegardez le fichier.mp4final dansout/, la racine du projet, et la racine de l'espace de travail.