super-video-cut

Was macht super-video-cut?

Positionierung

Behandle jeden Schnittauftrag als eine technische Lieferung mit einer Beweiskette, nicht als einen Haufen nach Gefühl zusammengesetzter Clips. Dieser Skill liefert reproduzierbare objektive Messungen, aufgeschlüsselte und begründete Bewertungen, wiederverwendbare Timeline-Vorlagen, eine Qualitätskontrolle vor der Auslieferung und urheberrechtliche Grenzen, die den gesamten Prozess durchziehen.

references/ enthält das tiefergehende Material, aufgeteilt nach Fähigkeitsbereichen (ca. 50 Dokumente, die meisten davon 100–250-zeilige Parametertabellen und Spezifikationen). Lies nicht alles vorab – folge der untenstehenden Routenführung und lies nur die 1–3 Dokumente, die die aktuelle Phase benötigt.

Im gesamten Dokument verwendete Volumen-Kurzform: 09/02 bedeutet references/09-material-memory/02-*.md.

Drei rote Linien

Wird auch nur eine davon verletzt, darfst du nicht ausliefern.

1. Referenzstil: erst bewerten, dann schneiden. Wenn der Nutzer ein Referenzvideo bereitstellt, musst du die dreidimensionale Bewertung (Schnitttechnik / Sound / Szene) mit einer aufgeschlüsselten Begründung für jeden Eintrag durchführen und die Nutzerbestätigung einholen, bevor du die Timeline berührst. Ein Schnitt ohne diese Bestätigung gilt als Nacharbeit.
2. Footage: Cache prüfen, bevor du ein Modell bemühst. Bevor du Videomaterial analysierst, führe material_cache.py lookup aus. Bei einem Treffer lies die Materialbeschreibungskarte direkt – ein erneuter Aufruf eines Videomodells ist verboten; nur bei einem Fehlschlag führst du eine vollständige Analyse durch und registrierst sie.
3. Compliance und Qualitätskontrolle haben Vorrang. Schneide keinen Plan, dessen Urheberrechtsrisiko ungeklärt ist, und übergib keine fertige Datei, die qc_scan.sh nicht bestanden hat. Das rechtliche Volumen ist Referenzmaterial, keine Rechtsberatung; bei kommerziellen oder risikoreichen Projekten sag dem Nutzer, er solle es von einem Anwalt prüfen lassen.

Haupt-Workflow M0–M6

Phase	Ziel	Muss gelesen werden	Ausgabe
M0 Aufnahme	Ausführbare Parameter festlegen	Diese Datei	Briefing
M1 Footage-Aufnahme	Nie zweimal für dieselben Tokens bezahlen	09/02 + scripts/material_cache.py	Materialkarte oder Cache-Treffer
M2 Stilbewertung	"Ein Gefühl" in Parameter übersetzen	08/02 + 08/03 + scripts/reference_probe.sh	Bewertungsbogen + Fingerabdruck + einseitige Zusammenfassung
M3 Edit-Plan	Fingerabdruck → Timeline	08/04 + das passende Genre-Volumen	Sekundengenauer Plan
M4 Produktion	Schnitt / Voice / Untertitel / Grading	01 / 02 / 03 nach Bedarf	Rohschnitt und Projekt
M5 Liefer-QC	Technische + Compliance-Prüfung	06/01 + 06/02 + 06/03	QC-Bericht + Erkennungsprotokolle
M6 Feedback	Nur Kandidaten erstellen, niemals Regeln automatisch ändern	08/05	Selbstverbesserungsprotokoll

M0 Aufnahme: nach fehlenden Parametern fragen, maximal 3 Fragen

Du musst Folgendes ermitteln: Plattform und Seitenverhältnis (bestimmt Safe Area und Dauer), Gesamtdauer, ob Voice-Over/Dubbing benötigt wird, ob es kommerziell ist, Liefer-Spezifikation (Auflösung / Bitrate / Container).

Leite alles ab und nenne es, was aus dem bereits Vorhandenen abgeleitet werden kann; befrage den Nutzer nicht Punkt für Punkt. Ob die Arbeit kommerziell ist, bestimmt direkt, welche Musik und welches Footage du verwenden darfst – wenn dies unklar ist, musst du fragen.

M1 Footage-Aufnahme: die Aktion für jeden der fünf Zustände ist fest codiert

SK="$HOME/.workbuddy/skills/super-video-cut"
export MDC_HOME="$PWD/material-cache"     # Cache im Projektverzeichnis halten, niemals im Skill-Verzeichnis
python "$SK/scripts/material_cache.py" lookup "<Footage-Pfad>"

Zustand	Aktion
HIT	Rufe kein Video-Modell auf. Lese $MDC_HOME/cards/<MID>.yaml und führe nur eine Themenanpassung durch
MISS	Lokale E1-Sonde → eine vollständige Analyseanfrage mit references/09-material-memory/templates/model-analysis-prompt.md → Karte ausfüllen → validate → register
STALE	Das Footage hat sich geändert; markiere die alte Karte als superseded und wiederhole wie bei MISS
HIT_BLOCKED	Rechtestatus ist nicht geklärt; nicht verwenden – zuerst die Rechte klären
Not-Aus	Wenn _config.json cache_enabled=false hat, behandle alles als MISS; das Umgehen ist verboten

Die Beschreibungskarte hat drei Ebenen: L0 Identität (Hash / Spezifikationen), L1 Materialbeschreibung (was es zeigt / wo es aufgenommen wurde / welchen Stil es hat / ob es verwendbar ist), L2 Themenanpassung (welche Sekunden für welches Thema verwendet werden und welche narrative Rolle sie spielen). "Funktioniert gut als Eröffnung für Thema X" gehört nur in L2 – wenn es in L1 steht, verunreinigt es jedes andere Thema.

Das Ortsfeld ist eine harte Regel: ohne Bildschirmtext, ein Wahrzeichen oder eine Aufzeichnung des Drehorts setze place_name: null. Leite niemals eine Stadt aus "es gibt Meer und eine Palme" ab.

M2 Stilbewertung: sechs Schritte, wenn der Nutzer ein Referenzvideo bereitstellt

S1 Compliance-Vorprüfung → S2 objektive Sonde → S3 zwei vollständige Durchgänge → S4 dimensionale Bewertung
→ S5 einseitige Zusammenfassung → S6 ★Nutzerbestätigungs-Tor★

• S1 Nur analysieren, niemals den Ausdruck übernehmen. Vor- und Abspanne, Dialoge, Musik, kinetischer Text und Einstellungsinszenierungen sind alle mit protected: expression gekennzeichnet.
• S2 Führe das Sonden-Skript für reproduzierbare Zahlen aus (Schnittpunkte, Einstellungslängen, Lautheit, Stille, Farbstatistiken, Kontaktabzüge).
• S3 Sieh dir das ganze Video zweimal an: einmal nur für das Bild, einmal nur für den Ton. Durchzuspulen bei hoher Geschwindigkeit verliert Rhythmus und gehaltene Schläge – dies ist der häufigste methodische Fehler.
• S4 Bewerte Punkt für Punkt in den drei Kernbereichen – A Schnitttechnik / B Sound / C Szene (jeweils 10 Unterpunkte) – plus D Untertitel, E Narrativ, F Plattformkontext und G Compliance-Grenze (obligatorisch).
• S5 Erstelle eine einseitige Zusammenfassung: 3 Schlüsselmerkmale, 3 nicht übertragbare Punkte, Gesamtvertrauen.
• S6 Lege sie dem Nutzer zur Bestätigung vor. Ohne diese Bestätigung darfst du nicht in M3 eintreten.

Jeder Bewertungseintrag muss alle fünf Teile ausfüllen; ein fehlender Teil macht den gesamten Eintrag ungültig:

① Beobachtung (Zeitcode + konkretes Phänomen) ② Grundlage (Beweis-ID) ③ Schlussfolgerung (warum es so gestaltet wurde) ④ Aktionspunkt (wie dieser Schnitt es nutzt) ⑤ Vertrauen (hoch/mittel/niedrig + Grund)

Gegenbeispiel (darf niemals ausgegeben werden): "Der Schnitt ist flüssig und sehr filmisch." – kein Zeitcode, keine Grundlage, kein Aktionspunkt, nichts Ausführbares.

Jeder Aktionspunkt muss ein Übertragungs-Tag tragen: transferable: parameter (Rhythmus, Dauer, Lautheit, Einstellungsgrößen-Sequenz – lernbar) oder protected: expression (spezifische Einstellungen, Dialoge, Musik, kinetischer Text – nicht reproduzierbar). Stil und Formel liegen im Bereich der Ideen und können übernommen werden; Ausdruck darf nicht kopiert werden. Das ist der urheberrechtliche Mindeststandard dieses Skills, kein Vorschlag.

M3 Edit-Plan: übersetze den Fingerabdruck in eine sekundengenaue Timeline

Lies die Zuordnungsregeln in 08/04 und erstelle eine direkt ausführbare Timeline: In/Out-Punkt für jeden Clip, Einstellungsgröße, Überblendungstyp und -dauer in Bildern, Sound-Effekt-Cue-Punkte, Untertitel In/Out-Punkte und Lautheitsziel.

Konfliktlösungsreihenfolge: explizite Nutzeranfrage > harte Plattformgrenzen > Merkmale des Referenzvideos > Standard-Ästhetik. Wenn das Footage etwas nicht unterstützt, sag es klar – "das Referenzvideo verwendet Technik X; dieses Projekt hat kein passendes Footage, daher ersetzt Y sie" – anstatt es zu erzwingen.

M4 Produktion: lies genau ein Volumen pro aktueller Aktion

Tätigkeit	Lesen
Rhythmus, Übergänge, Achse	01/01, 01/02
Projektorganisation, Proxys, Conform, Lieferung	01/03
Farbkorrektur, Log/LUT, HDR	01/04
Sprachaufnahme, Lieferung, ADR	02/01
Mischung, Lautheit, EQ/Kompression	02/02
Partitur, Soundeffekte, Sounddesign	02/03
KI-Stimme, TTS, SSML	02/04
Untertitel-Layout und -Dauer	03/01
SRT/VTT/ASS/TTML-Formate	03/02
Transkription, Ausrichtung, Einbrennen	03/03
Mehrsprachigkeit, CC/SDH, Barrierefreiheit	03/04
Wie man ein bestimmtes Genre schneidet	04/01–04/06

Lautheitsanker (vollständige Zieltabelle in 02/02): Streaming ca. −14 LUFS, Podcast/Apple ca. −16 LUFS, Broadcast EBU R128 bei −23 LUFS, mit True Peak generell erforderlich bei ≤ −1 dBTP. Halte dich an die offizielle Dokumentation der Zielplattform; wenn unsicher, zuerst messen, dann entscheiden.

M5 Liefer-QC: führe zuerst das Skript aus, beurteile dann als Mensch

bash "$SK/scripts/qc_scan.sh" "<fertige Datei>" "<Ausgabeverzeichnis>"

Ein Durchlauf liefert ein Spezifikations-JSON, Decode-Integrität, Black-Frame/Freeze-Erkennung, Stille, Lautheit und einen Kontaktabzug. Das Skript kann nur technische Anomalien finden – Inhalt und Compliance müssen manuell anhand der Tabellen geprüft werden:

• 06/01 technische Spezifikations-Checkliste (Auflösung / Bildrate / Farbe / Bitrate / Audiospuren / Dauer / Benennung)
• 06/02 Inhalts- und Compliance-Prüfung (Fakten, heikle Inhalte, verbotene Werbeaussagen, Rechtedokumentation)
• 06/03 Tabellen A–G Ausfüllvorlagen (für das Archiv)

QC-Schweregrad: blockierend (Black Frames, fehlende Audiospur, Lautheit außerhalb der Toleranz, Verletzungsrisiko) muss behoben werden; Verbesserungs-Punkte können nach Protokollierung ausgeliefert werden; Vorschlags-Punkte warten auf die nächste Version.

M6 Feedback-Schleife: ein einziges erfolgreiches Video ändert nie eine Regel

Sobald echtes Feedback eintrifft (Abschlussrate, Conversion, Kundennotizen), führe eine Fehlerzuordnung gemäß 08/05 durch und schreibe sie in 08/case-library/<CASE-ID>/self-improvement-record.md.

Harte Regel: ein einzelner Fall erzeugt nur Kandidaten; eine Änderung tritt erst in Kraft, nachdem ≥5 gleichgerichtete Stichproben, ein eingefrorener Regressionstest, menschliche Freigabe, Versionierung und eine Canary-Veröffentlichung vorliegen. Die Selbstverbesserungs-Engine darf nicht automatisch die E1/E2-objektiven Felder einer Materialbeschreibungskarte umschreiben – der Cache würde einen Fehler auf jedes spätere Thema verbreiten, während die Trefferprotokolle immer noch perfekt normal aussehen.

Kürzester Weg nach Auslösung

Der Nutzer sagt	Mach dies
"Schneide etwas im Stil dieses viralen Videos"	Vollständiger M2-Ablauf → S6 Bestätigungs-Tor; beginne nicht mit dem Schneiden
"Bearbeite dieses Video für mich"	M0 frage Plattform/Dauer/kommerziell → M1 Footage → M3 Plan
"Ist dieses Footage verwendbar, was zeigt es?"	M1 lookup; bei HIT sofort antworten, nur bei MISS analysieren
"Füge Untertitel hinzu"	03/01 Layout + 03/03 Transkription und Ausrichtung; Lese- und Mindestdauer prüfen
"Das Voice-Over klingt schlecht"	02/01 Aufnahme → 02/02 Verarbeitungskette → Lautheit messen
"Exportiere für Douyin / WeChat Channels / Bilibili"	04/01 Plattformspezifikationen + 06/01 Lieferprüfung
"Würde dieser Schnitt etwas verletzen?"	05/02 Entscheidungsbaum + Dimension G in 08/02; gib eine Risikostufe, kein abschließendes Rechtsgutachten
"Ist der fertige Schnitt in Ordnung?"	qc_scan.sh + 06/01 / 06/02 Punkt für Punkt

Skripte

Skript	Zweck	Abhängigkeiten
scripts/material_cache.py	Footage-Fingerabdruck, Cache-Suche, Registrierung, Wiederverwendung, Validierung, Statistik (8 Unterbefehle)	Python 3, keine Drittanbieter-Pakete
scripts/reference_probe.sh	Objektive Sonde einer Referenz- oder Footage-Datei: Schnittpunkte, Einstellungslängen, Lautheit, Stille, Farbe, Kontaktabzüge	bash + ffmpeg/ffprobe
scripts/qc_scan.sh	Technische QC einer fertigen Datei: Spezifikationen, Decode, Black Frames, Freezes, Stille, Lautheit, Kontaktabzug	bash + ffmpeg/ffprobe

Prüfe zuerst die Umgebung: ffmpeg -version && ffprobe -version && python --version. Ohne ffmpeg ist jede objektive Messung nicht verfügbar – sage dem Nutzer in diesem Fall klar, dass nur eine manuelle Bewertung möglich ist und keine reproduzierbaren Metriken geliefert werden können. Erfinde niemals Zahlen.

Selbstprüfung vor der Lieferung

• Das Referenzvideo durchlief S1–S6 und der Nutzer hat bestätigt (falls ein Referenzvideo verwendet wurde)
• Jedes Footage-Stück kann im Cache auf seine Quelle und seinen Rechtestatus zurückgeführt werden
• Keine nicht unterstützten Phrasen wie "flüssig", "hochwertig" oder "texturiert" erscheinen in der Bewertung oder dem Plan
• Die Lautheit wurde gemessen und liegt innerhalb der Zieltoleranz; True Peak liegt unter dem Grenzwert
• Untertitel überlaufen nicht die Safe Area, enthalten keine Tippfehler und erfüllen die Lesegeschwindigkeitsgrenze
• qc_scan.sh meldet keine blockierenden Punkte, und Tabellen A–G sind ausgefüllt
• Die Rechtedokumentation für Musik / Schriftarten / Ähnlichkeiten / Stockmaterial ist vollständig oder die Risikostufe ist angegeben
• Dateibenennung, Container und Bitrate der Lieferung entsprechen den Plattformanforderungen

Umfang des Materials (muss dem Nutzer mitgeteilt werden)

• Das rechtliche Volumen ist keine Rechtsberatung. Artikel und Rechtsprechung ändern sich; bei kommerziellen oder risikoreichen Projekten lasse es von einem Anwalt prüfen und verlasse dich auf den neuesten offiziellen Text.
• Plattformparameter ändern sich. Dauer, Bitrate, Safe Area und Lautheitsziele widersprechen sich je nach Quelle, daher sind sie immer mit "vorbehaltlich der neuesten offiziellen Dokumentation der Plattform" gekennzeichnet – vor der Auslieferung hochladen und Vorschau prüfen.
• Die Selbstverbesserungsparameter haben keinen Industriestandard. η, δ, N_min und der Rest in Volumen 08 sind die eigenen Startwerte dieser Bibliothek; sie existieren, um den Prozess ausführbar zu machen, nicht, weil es validierte Optima sind.
• Etwa 190 "TO VERIFY"-Punkte sind im Text oder am Ende jedes Dokuments aufgeführt, konzentriert in references/00-overview/sources-and-reliability.md (mit A/B/C/D-Beweisnoten und P0/P1/P2-Prioritäten). Überprüfe die Beweisnote dieser Datei, bevor du etwas zitierst.

Routenführung und Indizes

• references/INDEX.md – kürzester Weg und minimale erforderliche Lektüre pro Phase oder Aufgabe
• references/00-overview/knowledge-map.md – vollständige Fähigkeitsbereichszuordnung und schnelle Problemlösungs-Übersicht
• references/00-overview/sources-and-reliability.md – Beweisnoten, Quellenverzeichnis, TO VERIFY Punkte
• references/00-overview/manifest.csv – maschinenlesbarer Dateiindex

Wenn du eine große Datei durchsuchst, suche nach Schlüsselwörtern anstatt sie ganz zu lesen, z.B. grep -n "LUFS" references/02-audio-and-voice/02-audio-post-and-mixing.md.