Communitygithub.com

Remotion SRT 动画工作流

Vervollständigen Sie SRT-Skripte in animierte Remotion-Filme mit einem siebenstufigen Gate-Prozess von der Machbarkeitsbewertung bis zur Lieferung, inklusive Frame-für-Frame-Textüberlappungsprüfung, Blackframe-QA und getesteten lokalen Rendering-Rezepten.

Was ist Remotion SRT 动画工作流?

Dieser Skill beschreibt einen vollständigen, siebenstufigen Workflow, um ein SRT-Skript (Sprachskript) in einen animierten 2D-Remotion-Film zu verwandeln. Der Prozess wurde an einem echten Projekt mit 81 Sätzen / 193 Sekunden / 35 Szenen validiert und deckt 12 Rendering-Durchläufe sowie 11 echte Fehler ab, die durch strenge Gates erkannt wurden. Der Skill ist für Entwickler und KI-Agenten konzipiert, die Remotion-Projekte erstellen oder überprüfen, und stellt sicher, dass die Animationen deterministisch, pixelgenau und frei von Textüberlappungen sind. Er umfasst detaillierte Referenzen für Machbarkeitsbewertungen, Gate-Prüfungen (z. B. Überlappungsprüfung, Blackframe-Kontaktabzug), Remotion-spezifische Regeln (kein CSS-Animation, feste Seeds, Frame-basierte Zeitleisten) und eine wiederverwendbare `OverlapAudit.tsx`-Komponente. Der Workflow unterstützt die sofortige Bereitstellung mit einem 10-minütigen Setup und bietet getestete Rendering-Befehle für h.264-Videos und Einzelbild-Exporte.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add sangbiaolaoda-arch/remotion-srt-workflow

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Remotion SRT Animations-Workflow

Ein SRT-Skript (Sprachskript) in einen mit Remotion gerenderten 2D-Animationsfilm verwandeln. Dieser Workflow wurde an einem echten Projekt mit 81 Sätzen / 193 Sekunden / 35 Szenen vollständig validiert (einschließlich 12 Rendering-Durchläufen und 11 echten Fehlern, die durch die Rechen-Gates erkannt wurden).

Wann verwenden

  • Der Benutzer übergibt ein SRT / Skript / Sprachmanuskript, um ein "erklärendes Video mit Bildern" zu erstellen
  • Ein bestehendes Remotion-Projekt soll um neue Szenen erweitert oder geändert werden
  • Qualitätsprüfung der fertigen Filme anderer Remotion-Projekte

Kernprinzipien (Nichteinhaltung führt zum Scheitern)

  1. Beweisgrenze: Keine erfundenen ausgeführten Aktionen. Schlussfolgerungen werden in drei Kategorien eingeteilt: "Verifizierte Fakten / Gestaltungsvorschläge / Ungeprüfte Aspekte".
  2. Gates nicht überspringen: Am Ende jeder Phase gibt es ein G-Gate; ohne Benutzerbestätigung wird nicht fortgefahren. Der Benutzer sagt "Weiter" = Autorisierung für das aktuelle Gate.
  3. Alles auf einmal erledigen: Wenn der Benutzer explizit eine durchgehende Lieferung verlangt ("Kannst du das nicht auf einmal machen?"), werden die restlichen Szenen in einem Durchgang ausgerollt; die Prüfungstors übernehmen automatisch die Qualitätssicherung, nicht in mehrere Runden unterteilt werden.
  4. Frame-Determinismus: Die Zeitleiste arbeitet nur in Frames. Kein CSS animation/transition/@keyframes/Tailwind animate-*; keine setTimeout-gesteuerten Zeitleisten; Random muss einen festen Seed haben.
  5. Textabstand nach Zeilenbox berechnen: Bei chinesischen Schriftarten (Noto Serif SC usw.) beträgt die Zeilenbox ca. 1,44em; visuell überlappungsfreier Text kann sich tatsächlich überlappen. Textblöcke mit ≥0,3em Abstand; vertikaler Textabstand ≥1,55em.
  6. Bildschirmtext ohne Satzzeichen: SRT-Satzzeichen werden in der Rendering-Ebene durch Leerzeichen ersetzt; der Autor muss die Quelldatei nicht ändern.

Prozessübersicht

PhaseErgebnisTor
S0Machbarkeitsbewertung (Einstufung / Technischer Pfad / Risikotabelle / Brief-Lücken), kein Code, keine AssetsG0 Benutzer wählt Pfad
S1Projektinitialisierung: npm Install Remotion-Familie, Schriftarten in public/fonts/, tsconfig, Root—
S2brief.md + beat-sheet.md (Satz→Szene, Framegrenzen aus SRT abgeleitet) + style-guide.md + 3 echte Styleframe-RenderingsG1 Visuelle Richtung
S3assets.md Asset-Planung (Liste der Grafikelemente + Parameter + Risiken; priorisiert 100 % programmatische SVGs, kein externer Einkauf)G2 Zusammenführung bestätigen
S4storyboard.md Szenen-Storyboards (Framegrenzen / Hauptvisual / Hauptbewegung / Übergangsbegründung / QA-Ankerpunkte)G3 Zusammenführung bestätigen
S5Vertikaler Schnitt: Auswahl von 3–4 datendichtesten Szenen für echte Renderings + Stichproben-Frame-QAG4 Muster
S6Vollständiges Szenen-Rendering (kann auf einmal erledigt werden); jede Szene durchläuft das Prüfungstor—
S7Gesamt-Rendering + Fünf-Stufen-Verifikation + LieferungG5 QA → G6

Statusdateien werden immer auf die Festplatte geschrieben (brief / beat-sheet / style-guide / assets / storyboard / progress / findings), lange Aufgaben basieren auf den Dateien als Faktenquelle.

Detailliertes Handbuch (bei Bedarf lesen)

  • references/workflow.md — Details jeder Phase, Methoden zur digitalen Neuberechnung, Literaturüberprüfungsstandards
  • references/qa-gates.md — Prinzip des Überlappungsprüfungstors, Blackframe, Kontaktabzug, Stichproben-Frame-Befehle, Rendering-Bereichsregeln
  • references/remotion-rules.md — Harte Regeln für Remotion und in diesem Projekt getestete Fallstricke (schwarze Frames zwischen Szenen, Schriftarteinladung, absolute Positionierung usw.)
  • assets/OverlapAudit.tsx — Frame-für-Frame-Textüberlappungsprüfungsschicht; direkt in das Projekt kopierbar, oben auf den Haupt-Composition-Baum hängen

New Project 10-Minuten-Start

  1. npm i remotion @remotion/cli @remotion/bundler react react-dom typescript (+ @remotion/renderer)
  2. Chinesische Schriftart: cp /c/Windows/Fonts/NotoSerifSC-VF.ttf public/fonts/ (variable Schriftart, einzelne Datei deckt alle Gewichte ab, SIL OFL, kommerziell nutzbar); mit staticFile() + FontFace + delayRender/continueRender lokal laden; keine Online-Google Fonts
  3. assets/OverlapAudit.tsx nach src/audit/ kopieren, oben auf den Haupt-Composition-Baum hängen
  4. Gemäß S2 ein beat-sheet erstellen, Framegrenzen in die einzige Faktenquelle src/acts/acts.ts schreiben

Rendering-Befehle (lokal getestet)

npx remotion render src/index.ts Main out.mp4 --codec h264 --crf 18 --frames=START-END --log=error
npx remotion still src/index.ts Main out.png --frame=N          # Einzelframe-Verifikation
npx remotion browser ensure                                     # Erstmaliges Herunterladen von Headless Shell

Rendering-Geschwindigkeitsreferenz: 1080p komplexe Effekte ≈17–27fps (5810 Frames des gesamten Films etwa 3–6 Minuten).

Verwandte Skills