alexey1312/Vibe-Editing-Agent-Skill

Vibe Editing: der Schnitt

Rohmaterial in einen Schnitt verwandeln, der die Bedeutung bewahrt, dann an die Engine für Grafiken übergeben. Der Agent schlägt vor und schreibt; der Renderer berechnet Frames; der Autor entscheidet und akzeptiert. Die Geschichte vor dem Design genehmigen: Jede Bedeutungsänderung nach den Grafiken erzwingt einen Neubau.

• Routen und Werkzeuge nach Material: references/routes.md
• Die EDL und die beiden Uhren: references/edl-format.md
• Transkripte und Erkennungsdienste: references/transcripts.md
• Sprache schneiden: references/cutting.md
• Untertitel: references/captions.md
• Ton: references/audio.md
• Einblendungen, Layouts, 9:16, andere Sprachen: references/inserts-and-layouts.md
• Bildschirmaufnahmen: references/screen-recordings.md
• Ordner, Brief und project.md: references/project-memory.md
• Anmerkungen des Autors: references/edit-requests.md
• Daten, Lizenzen und Geld: references/data-and-licences.md
• Planformat: references/plan-format.md
• Was dieses Repository gemessen hat: references/measured-behavior.md
• Versionen und Daten: references/versions.md
• Zitate: references/sources.md

Vertrag

• Phase 1 ist schreibgeschützt. Der Toolchain-Bericht, das Medieninventar, das Lesen vorhandener Transkripte und das Schreiben des Plans ändern nichts und senden nichts an irgendeinen Ort.
• Kein Schnitt, Render, Upload, Installation oder kostenpflichtiger Anruf ohne Genehmigung der Artikel-IDs (references/plan-format.md). „Mach es kürzer" vor einem Plan ist eine Bitte um den Plan.
• Originale werden nie verändert. Arbeitskopien gehen nach work/, Renderings nach renders/, Lieferungen nach exports/. edl.py render weigert sich, ohne --force über eine Quelle oder eine vorhandene Datei zu schreiben.
• Zwei Uhren. Quellzeit für Takes, Ausgabezeit für alles, was ein Zuschauer sieht; umrechnen mit edl.py map und edl.py retime, niemals von Hand.
• Zitieren oder kennzeichnen. Eine Behauptung über ein Werkzeug zitiert references/sources.md oder einen Gemessenen Abschnitt; Versionen und Preise stammen aus references/versions.md mit dessen Datum; ein Urteil über Geschmack oder Bedeutung wird als solches gekennzeichnet.
• Verifikation ehrlich melden. Eine Frame-Prüfung übersieht Rhythmus; ein Skript übersieht Bedeutung. Sage, was angesehen, angehört, überflogen wurde – und was nicht.

1. Preflight

python3 scripts/toolchain_report.py --format markdown
python3 scripts/media_probe.py originals/ --format markdown

• Der Toolchain-Bericht sagt, was diese Maschine kann: framegenaue Renderings, Untertitel brennen (viele FFmpeg-Builds können das nicht, Gemessen M7), Lautstärkemessung, lokale Spracherkennung, HyperFrames, Remotion; und welche API-Schlüsselnamen gesetzt sind (niemals deren Werte).
• Das Inventar markiert, was den Schnitt beeinflusst: variable Bildrate (MED001), Rotation (MED002), HDR (MED010), gemischte Bildraten oder Audioformate (MED004, MED005); Regeln in CHECKS.md im Repository dieses Skills.
• Lese die eigenen Anweisungen des Projekts und project.md, falls vorhanden.
• Schreibe den Brief oder frage nach dem, was fehlt: Zuschauer und Kernaussage, Lieferung, Muss-bleiben, Darf-nicht, Cloud (references/project-memory.md).

2. Route

Wähle die Route aus dem Material und dem Liefergegenstand (references/routes.md). Dieser Skill besitzt den Schnitt: Takes, Übergänge, die EDL, das Rendering, Untertitel und Ton auf der neuen Timeline. Grafiken gehören zu den Skills der Engine: HyperFrames (hyperframes, general-video, hyperframes-core) oder Remotion (remotion-best-practices). Untertitel oder Overlays auf Filmmaterial, das nicht verändert werden darf, gehören zu embedded-captions oder talking-head-recut.

3. Transkripte

• Wort-Zeitstempel pro Quelle, einmal erstellt, in transcripts/ aufbewahrt (references/transcripts.md).
• Erkennung in der Cloud sendet Audio aus und kostet Geld; lokale Erkennung erfordert eine Installation. Beide warten auf Genehmigung, mit dem Anbieter, den Kosten und den Daten, die im Plan genannt werden.
• Korrigiere Namen und Zahlen anhand eines Glossars, bevor du einen Schnitt planst.

4. Plane die Geschichte

1. Tabelle des Materials: Quelle, Eintritt–Austritt, wörtliche Phrase, Ton, was sichtbar ist, mögliche Rolle.
2. Drei Eröffnungen, jede mit dem, was der Zuschauer in den ersten Sekunden versteht.
3. Kandidaten: python3 scripts/edl.py candidates --words transcripts/<take>.json — Pausen, Wiederholungen und Füllwörter zur Prüfung, niemals automatisch zu schneiden (references/cutting.md).
4. Die Geschichte in Abschnitten, dann edit/edl.json: jeder Clip mit einem Grund (references/edl-format.md).
5. python3 scripts/edl.py check edit/edl.json --probe, table und cuts --probe: die Clips mit beiden Uhren und jedes entfernte Intervall zum Lesen durch den Autor.
6. Zweifelhafte Schnitte kommen in edit/edl_b.json, nicht in Version A.

5. Rendere den Entwurf

python3 scripts/edl.py render edit/edl.json -o renders/draft_v1.mp4 --size 640x360 --preset veryfast

• Jeder Clip wird auf Framegrenzen neu codiert, mit 10 ms Audio-Überblendungen, auf eine Größe skaliert (Gemessen M1, M3, M4). Ein Stream-Copy-Schnitt ist niemals framegenau (Gemessen M2).
• Der erste Entwurf hat keine Musik, Untertitel oder Effekte: nur Sprache und Bild.
• Höre jede Verbindung mit Kopfhörern ab; betrachte die Frames auf beiden Seiten. Korrigiere mit kurzen Notizen (references/edit-requests.md) und einer neuen EDL-Version.

6. Untertitel, Ton, Einblendungen

• Untertitel: edl.py retime verschiebt Wortzeiten auf die Ausgabe-Timeline; captions.py build gruppiert sie; captions.py check wendet die Grenzwerte an (references/captions.md).
• Ton: zuerst Sprache, dann Musik mit Ducking, dann Effekte; Lautstärke gegen das Ziel des Briefs messen und loudnorm-Ziele explizit setzen (references/audio.md).
• Einblendungen: markiere sie auf der Ausgabe-Timeline (edl.py map), genehmige ein Standbild, dann baue sie in der Engine; edl.py hyperframes und edl.py remotion übergeben den Schnitt (references/inserts-and-layouts.md).
• Andere Formate: Eine 9:16-Version ist ein neues Layout, kein Zentrums-Crop.

7. Übergeben

• Führe die Überprüfung durch, bevor du das Video als fertig erklärst: der vibe-editing-review Skill, oder zumindest python3 scripts/qa_scan.py mit dem Brief, der EDL und den Untertiteln.
• Aktualisiere project.md: genehmigte EDL-Version, letztes gutes Rendering, Befehle, Assets und Lizenzen, offene Fehler.

Arbeitsablauf

Phase 1 — Empfehlen

1. Preflight: Toolchain-Bericht, Inventar, Brief, Projektanweisungen.
2. Plan mit references/plan-format.md: Quellen und Konvertierungen; die Geschichte und EDL v1; entfernte Intervalle; zweifelhafte Schnitte; Untertitel, Ton und Einblendungen; Daten, Geld und Lizenzen; was hier nicht verifiziert werden kann.
3. Fragen, welche Artikel-IDs angewendet werden sollen.

Phase 2 — Anwenden und verifizieren

1. Nur genehmigte Artikel anwenden, jeweils eine Ebene: Geschichte, Tempo, Text, Bild, Ton.
2. Nach jeder Änderung den gleichen Bereich mit einer Sekunde Kontext rendern oder in der Vorschau anzeigen und abhören.
3. edl.py check und captions.py check erneut ausführen; qa_scan.py bei jedem Entwurf ausführen, der zum Autor geht.
4. Artikel-Status und project.md aktualisieren; melden, was nicht verifiziert wurde.

Leitplanken

• In Phase 1 nichts schneiden, rendern, hochladen, in der Cloud transkribieren oder installieren.
• Keine Dateien in originals/ ändern oder neu codieren.
• Keinen Schnitt per Stream-Copy durchführen, der framegenau sein muss.
• Keine Untertitel oder Einblendungen nach Quellzeit platzieren.
• Nicht jede Pause mit einem Schwellenwert entfernen oder ein fehlendes Wort ohne Entscheidung des Autors synthetisieren.
• Keinen Schlüssel oder Token im Chat, in einem Log oder einer Datei ausgeben.
• Keine Musik, Schriftarten oder Filmmaterial ohne aufgezeichnete Quelle und Lizenz hinzufügen.
• Nicht das Terrain der Engine übernehmen: Composition-Code gehört zu den HyperFrames- oder Remotion-Skills.