Ablation-Lab/video-review

Was macht video-review?

Das Tool wandelt eine Videodatei oder ein Remotion-Projekt in ein lesbares Prüfpaket um: PNG-Einzelbilder, Audio-Ergebnisse, die Erzählzeile und den per OCR erfassten Bildschirmtext für jedes Einzelbild, automatische Prüfungen und Änderungen seit der letzten Überprüfung, alles in report.md. Ihre Aufgabe ist es, das Tool auszuführen und dann das Video anhand des Pakets zu überprüfen.

1. Tool ausführen

Führen Sie es mit diesem genauen Befehl aus (funktioniert sowohl im Bash- als auch im PowerShell-Tool), wobei der Pfad des Benutzers in Anführungszeichen steht:

powershell -NoProfile -ExecutionPolicy Bypass -File "${CLAUDE_SKILL_DIR}/review-video.ps1" "<Videodatei oder Remotion-Projektordner>" [Optionen]

• Videodatei (MP4, MOV usw.): Einzelbilder alle 2 s, um jeden Szenenwechsel herum und am Ende.
• Remotion-Projektordner: Einzelbilder, die mit npx remotion still gerendert wurden (kein vollständiger Render erforderlich) und das Audio separat gerendert. Es verwendet die erste Komposition, sofern nicht -Composition <id> angegeben ist; die Ausgabe listet die anderen auf. Es muss npm install bereits im Projekt ausgeführt worden sein.

Nützliche Optionen (alle optional):

Option	Verwendung
-Composition <id>	Remotion: Welche Komposition gerendert werden soll.
-Frames 0,90,450	Remotion: Nur diese Einzelbildnummern rendern.
-Interval <s>	Sekunden zwischen regulären Einzelbildern (Standard 2). Für lange Videos 4 oder mehr verwenden.
-Narration <datei>	Erzählquelle, falls sie nicht automatisch gefunden wird: .srt, .vtt, .csv, .md-Aufnahmetabelle oder voiceover.json.
-Project <ordner>	Ordner, in dem nach der Erzählung gesucht werden soll, wenn sich das Video außerhalb seines Projekts befindet.
-OutDir <ordner>	Wohin das Paket geschrieben werden soll.
-CompareWith <ordner>	Mit einem älteren Review-Ordner (z. B. eines vorherigen Dateinamens) vergleichen. Standardmäßig vergleicht jeder Durchlauf mit dem letzten Durchlauf desselben Videos.
-ChangesPdf	Erstellt auch ein PDF nur der geänderten Einzelbilder, wenn der Benutzer nur die Änderungen möchte.
-KeyFramesPdf	Erstellt key-frames.pdf im Review-Ordner: etwa 15 bis 20 Einzelbilder, ein vollständig aufgebautes Einzelbild pro Szene plus markierte Einzelbilder, mit Zeitstempel, Szene und Fundstelle beschriftet, unter 10 MB. Wenn der Review-Ordner bereits eine vollständige Überprüfung enthält, wird daraus gebaut und sonst nichts geändert; andernfalls wird zuerst die Überprüfung durchgeführt. Fügen Sie -NoPdf hinzu, um das vollständige Kontaktblatt zu überspringen.
-KeyFramesMaxMB <n>	Größenlimit für key-frames.pdf (Standard 10).
-WordsPerSecond <n>	Lesegeschwindigkeit für die Lesezeit-Prüfung (Standard 3).
-NumberWordsFrom <n>	Gesprochene Zahlwörter werden ab diesem Wert aufwärts geprüft (Standard 10).
-SafeMargins o,r,u,l	Shorts-Safe-Area-Ränder bei 1080x1920 (Standard 288,192,672,48, Googles vorsichtige Werte).
-WordList <datei>	Zusätzliche Wörter, die die Rechtschreibprüfung akzeptiert.
-SceneThreshold 0.3	Für Kameramaterial (der Standardwert 0.02 eignet sich für Folien mit Überblendungen).
-NoOcr	Überspringt die Bildschirmtext-Prüfungen.
-NoPdf	Überspringt das PDF, wenn der Benutzer nur Ihre Überprüfung möchte.
-NoAudio	Remotion: Überspringt den Audio-Render.

Lange Videos dauern eine Weile: etwa 2 Minuten für 8 Minuten Video und etwa 4 s pro Remotion-Einzelbild. Verwenden Sie ein Timeout von 10 Minuten. Die letzten Zeilen der Ausgabe enthalten die Pfade von report.md, dem Einzelbilder-Ordner und den PDFs, sowie einzeilige Zusammenfassungen für Audio, Textprüfungen und Änderungen. Das Paket wird in <Video-Name>-review\ neben dem Video oder in out\<Komposition>-review\ innerhalb eines Remotion-Projekts abgelegt, sofern nicht -OutDir angegeben wurde. Jeder Durchlauf behält den vorherigen in previous\.

Wenn die Ausgabe mit FEHLGESCHLAGEN: endet, stoppen Sie und teilen Sie dem Benutzer den Grund mit. Falls ffmpeg fehlt, beheben Sie dies mit winget install --id Gyan.FFmpeg -e und starten Sie dann ein neues Terminal. Zeilen, die mit WARNUNG: beginnen, erscheinen auch oben im Bericht. Geben Sie sie weiter.

2. Überfliegen oder vollständige Überprüfung

Das Tool auszuführen ist günstig; Einzelbilder zu öffnen verbraucht Nutzung des Benutzers, weil jedes geöffnete Einzelbild ein zu lesendes Bild ist. Eine vollständige Überprüfung eines 15-minütigen Videos mit sechs Opus-Subagenten, die jedes Einzelbild öffnen, hat einmal eine ganze Nutzungssitzung verbraucht. Daher:

• Standardmäßig überfliegen, es sei denn, der Benutzer bittet um eine vollständige Überprüfung (mit Worten wie "vollständige Überprüfung", "jedes Einzelbild", "alles durchgehen"). Beim Überfliegen arbeiten Sie mit report.md: der Zusammenfassung, den Prüfungen, dem Erzählzeitstrahl und dem OCR-Text und den Markierungen jedes Einzelbilds. Betrachten Sie die Szenenwechsel-Einzelbilder (Szenenende und Szenenwechsel) durch ihre Zeilen im Bericht und öffnen Sie ein Einzelbild nur dort, wo etwas falsch aussieht: eine markierte Prüfung, eine Erzählzeile, die nicht zum Text auf dem Bildschirm passt, ein geändertes Einzelbild, ein Audioproblem zu diesem Zeitpunkt oder OCR-Text, der leer oder verstümmelt ist, wo eine Folie sein sollte. Sagen Sie am Ende, dass es ein Überflug war und wie viele Einzelbilder Sie geöffnet haben.
• Öffnen Sie immer einige echte Einzelbilder, sowohl beim Überfliegen als auch bei einer textbasierten Überprüfung oder einem reinen Zeitstrahl-Befund: etwa eine vollständig aufgebaute Folie pro Szene (das Szenenende-Einzelbild, sobald alles erschienen ist) oder 15 bis 20 über das Video verteilt, wenn es keine klaren Szenen gibt. Sie zeigen den visuellen Stil (Layout, Überlappungen, überlaufende Boxen, Kontrast, leere Einzelbilder), den der Text nicht zeigen kann. Bei einem langen Video lassen Sie den Sonnet-Subagenten dies beim Überfliegen erledigen. Geben Sie immer am Ende an, wie viele Einzelbilder geöffnet wurden.
• Nur auf Anfrage vollständig überprüfen. Wenn das Video länger als 5 Minuten ist (siehe Länge und Einzelbilder in der Zusammenfassung von report.md), stoppen Sie vor dem Öffnen von Einzelbildern: Teilen Sie dem Benutzer mit, wie viele Einzelbilder vorhanden sind und wie viele Sie öffnen würden, dass eine vollständige Überprüfung viel Nutzung verbraucht, und fragen Sie, ob fortgefahren werden soll, bieten Sie stattdessen ein Überfliegen an oder führen Sie mit einem größeren -Interval für weniger Einzelbilder erneut aus (-Interval 4 halbiert die regulären Einzelbilder). Warten Sie auf die Antwort.
• Bei einer vollständigen Überprüfung: Führen Sie maximal zwei Subagenten gleichzeitig aus und öffnen Sie insgesamt höchstens 100 Einzelbilder, sofern der Benutzer keine andere Zahl oder "jedes Einzelbild, kein Limit" angegeben hat. Verwenden Sie Sonnet für die Subagenten, es sei denn, der Benutzer wünscht Opus. Wenn ja, verwenden Sie es, erwähnen Sie jedoch einmal, dass es viel mehr Nutzung verbraucht. Geben Sie jedem Subagenten seinen eigenen Einzelbildbereich und die passenden Zeilen von report.md und lassen Sie ihn nur die gefundenen Probleme zurückgeben.

Ungefähre Einzelbildanzahlen: -Interval 2 (Standard) ergibt 30 reguläre Einzelbilder pro Minute Video, -Interval 4 ergibt 15 und -Interval 10 ergibt 6, plus bis zu zwei pro Szenenwechsel.

Wie Benutzer fragen

Der Benutzer sagt	Tun Sie
"Überprüfe C:\pfad\zu\video.mp4"	Überfliegen.
"Führe eine vollständige Überprüfung von C:\pfad\zu\video.mp4 durch"	Vollständige Überprüfung, bis zu 100 Einzelbilder (bei über 5 Minuten zuerst fragen).
"...vollständige Überprüfung..., jedes Einzelbild, kein Limit"	Vollständige Überprüfung jedes Einzelbilds. Bei über 5 Minuten zuerst fragen und darauf hinweisen, dass dies eine ganze Nutzungssitzung verbrauchen kann.
"...verwende Sonnet-Subagenten" / "...verwende Opus"	Dieses Modell für die Subagenten (Sonnet ist ohnehin die Voreinstellung).
"Überfliege es mit Sonnet und schreibe eine Zeitstrahl-Datei, dann gib mir deine Gesamtmeinung anhand des Zeitstrahls"	Führen Sie das Tool aus, lassen Sie dann einen Sonnet-Subagenten das Paket überfliegen, die Beispiel-Schlüsseleinzelbilder öffnen (eine vollständig aufgebaute Folie pro Szene) und timeline.md im Review-Ordner schreiben: ein Eintrag pro Szene mit Zeitbereich, kurzer Erzählung, kurzem Bildschirmtext, visuellem Eindruck und etwaigen Problemen. Lesen Sie nur diese Datei (öffnen Sie selbst keine Einzelbilder) und geben Sie eine Gesamtmeinung ab: Struktur, Tempo, Klarheit, visueller Stil und ob die Folien die Erzählung unterstützen. Geben Sie an, wie viele Einzelbilder geöffnet wurden.
"Erstelle das Review-PDF für C:\pfad\zu\video.mp4, damit ich es einem Chat anhängen kann"	Führen Sie das Tool aus und geben Sie den vollständigen Pfad des PDFs an. Führen Sie keine Überprüfung durch und öffnen Sie keine Einzelbilder, es sei denn, Sie werden darum gebeten.
"Erstelle eine Zeitstrahl-Datei und ein Schlüsseleinzelbilder-PDF ... damit ich beide einem Chat anhängen kann"	Führen Sie das Tool mit -KeyFramesPdf aus (siehe "Teilen mit einem Chat-KI" unten) und schreiben Sie den Zeitstrahl wie oben.

Teilen mit einem Chat-KI

Hängen Sie bei einem langen Video nicht das vollständige Kontaktblatt-PDF (hunderte Einzelbilder) an. Geben Sie dem Benutzer zwei Dinge: eine Text-Zeitstrahl-Datei (timeline.md, wie oben) und das Schlüsseleinzelbilder-PDF, erstellt mit -KeyFramesPdf (fügen Sie -NoPdf hinzu, wenn das vollständige PDF nicht gewünscht wird; bei einem Ordner, der bereits eine Überprüfung enthält, werden die Einzelbilder wiederverwendet und es läuft in Sekunden). Es enthält etwa 15 bis 20 Einzelbilder: ein vollständig aufgebautes Einzelbild pro Szene plus die vom Review markierten Einzelbilder, jeweils mit Zeitstempel, Szenenname und Fundstelle beschriftet, unter 10 MB, gespeichert als key-frames.pdf im Review-Ordner. Geben Sie den vollständigen Pfad an. Wenn das Tool keine klaren Szenen finden konnte (keine nummerierte Fußzeilen-Marke), verteilt es die Einzelbilder gleichmäßig und gibt dies in den Beschriftungen an. Es kann selbst keine visuellen Probleme erkennen. Wenn Sie welche gefunden haben (eine Überlappung, ein leeres Einzelbild), geben Sie bei der Übergabe an, welche Zeitstempel zu betrachten sind. Das vollständige PDF eignet sich am besten für kurze Videos wie Shorts, oder -ChangesPdf für nur die geänderten Einzelbilder.

3. Das Video überprüfen

1. Lesen Sie report.md. In der Reihenfolge: Warnungen; Änderungen seit der letzten Überprüfung (nur wenn es einen vorherigen Durchlauf gab: die geänderten Einzelbilder, mit einem Link zum alten Einzelbild und den hinzugefügten und entfernten Wörtern); eine Zusammenfassung; Audio-Ergebnisse; der Erzählzeitstrahl (jede Zeile mit Start, Ende und Übereinstimmungswert); die Bildschirmtext-Prüfungen (Rechtschreibung, Lesedauer, Zahlen, Shorts-Safe-Bereiche); dann eine Tabelle jedes Einzelbilds mit Zeit, Grund für die Aufnahme, Datei in frames/, der Erzählung zu diesem Zeitpunkt, dem OCR-Text und den Markierungen. "(Pause; letzte Zeile)" bedeutet, dass niemand spricht und die angezeigte Zeile die zuletzt gesprochene war.
2. Wenn der Benutzer gefragt hat, was sich geändert hat, oder ein Änderungsabschnitt vorhanden ist, beginnen Sie mit den geänderten Einzelbildern: Öffnen Sie jedes neben seinem vorherigen Einzelbild und sagen Sie, was sich geändert hat.
3. Vergleichen Sie jede Folie mit ihrer Erzählzeile. Beim Überfliegen tun Sie dies anhand des OCR-Textes im Bericht und öffnen nur die Einzelbilder, die falsch aussehen (siehe Abschnitt 2). Bei einer vollständigen Überprüfung öffnen Sie die Einzelbilder mit dem Lesen-Werkzeug, innerhalb der vereinbarten Grenze: zuerst die Einzelbilder mit der Markierung Szenenende (jedes ist eine fertige Folie kurz vor dem Wechsel) und Szenenwechsel (jedes ist die nächste Folie, sobald sie sich gesetzt hat), dann jedes markierte Einzelbild, dann die regulären Einzelbilder, wo immer sich die Erzählzeile ändert oder etwas auf dem Bildschirm aufgebaut wird.
4. Behandeln Sie die automatischen Prüfungen als Hinweise, nicht als Urteile, und bestätigen Sie jede im Einzelbild:
   • Rechtschreibung: OCR kann kleinen, blassen oder nichtproportionalen Text falsch lesen, und einige markierte Wörter sind beabsichtigt (Namen, absichtlich falsch gehörte Wörter). Melden Sie nur die, die das Bild bestätigt.
   • Lesedauer: Markierte Folien haben mehr neue Wörter, als in ihre Zeit bei der angegebenen Wort-pro-Sekunde-Geschwindigkeit passen. Erzählte Diagramme mit vielen Beschriftungen lösen dies leicht aus; sagen Sie, welche Folien wirklich mehr Zeit benötigen.
   • Zahlen: Eine gesprochene Zahl, die nicht auf dem Bildschirm gefunden wird, ist entweder ein echter Fehler (die Folie zeigt einen anderen Wert) oder eine von OCR übersehene Zahl, oft große Überschriftenziffern. Überprüfen Sie das Einzelbild.
   • Safe-Bereiche: Text innerhalb von YouTubes Overlay-Rändern bei vertikalen Videos. Die Standardränder sind die vorsichtigsten veröffentlichten, daher priorisieren Sie Text nahe der unteren und rechten Kante.
5. Überprüfen Sie in den geöffneten Einzelbildern auch visuell auf: Bildschirmtext, Zahlen, Namen oder Beschriftungen, die nicht mit der Erzählung übereinstimmen, abgeschnittenen oder überlappenden Text, geringen Kontrast, leere oder schwarze Einzelbilder sowie Platzhalter- oder übriggebliebenen Inhalt; Erzählzeilen, die mit "nicht gefunden" markiert sind; und Audioprobleme im Bericht (Übersteuerung, True Peak über -1 dBTP, Klicks oder Knackser, Stille in der Mitte des Videos, Lautstärke weit weg von etwa -14 LUFS).
6. Berichten Sie kurz: zuerst die Probleme, jeweils mit Einzelbildnummer und Zeitstempel (z. B. #14 00:22.00) und was falsch ist, dann die Audio-Ergebnisse, dann alles, was das Tool nicht prüfen konnte. Sagen Sie klar, wenn alles übereinstimmt. Ändern Sie das Projekt nicht, es sei denn, der Benutzer bittet darum; wenn ein markiertes Wort korrekt ist, können Sie vorschlagen, es zu review-words.txt im Projektordner hinzuzufügen.

Die PDFs

<Name>-review.pdf befindet sich im selben Ordner: eine Titelseite mit den Audio-Ergebnissen, den Prüfungen und etwaigen Änderungen, dann 6 bis 9 Einzelbilder pro Seite, jedes mit Zeitstempel, etwaigen gefundenen Problemen (rot), der Erzählzeile und dem OCR-Text (blau, Rechtschreibfehler unterstrichen). Es wird unter 20 MB gehalten. Mit -ChangesPdf gibt es auch <Name>-changes.pdf nur mit den geänderten Einzelbildern. Wenn der Benutzer etwas zum Anhängen an einen Claude-Chat oder zum Senden an jemanden möchte, geben Sie den vollständigen Pfad an. Verwenden Sie -MaxPdfMB <n> für ein kleineres Limit. key-frames.pdf (mit -KeyFramesPdf) ist dasjenige zum Anhängen für lange Videos.