Communitygithub.com

Bewertung und Auslieferung

Der Kreislauf, der aus einem gebauten Film einen ausgelieferten macht. Rahmen ansehen, Ton messen, Prüfungen durchführen, Entwürfe und Muster der Person zeigen, auf ihr Feedback reagieren, das Master rendern, die fertige Datei überprüfen, den Projektbericht schreiben und melden. Nach jedem Build oder jeder Änderung, vor jedem Render und wenn Feedback eintrifft, verwenden.

Was ist Bewertung und Auslieferung?

Diese Fähigkeit definiert einen vollständigen und strengen Arbeitsablauf für die Überprüfung, Verfeinerung und Auslieferung von Videoprojekten – von der ersten Änderung bis zur Übergabe der endgültigen Datei. Sie ist für Entwickler und KI-Agenten gedacht, die mit Tools wie Hyperframes, FFmpeg und benutzerdefinierten Skripten arbeiten. Der Prozess ist als Schleife nach jeder Änderung aufgebaut: Linten, Schnappschüsse erstellen und prüfen, Korrekturlesen und Wiederholen, bis die Frames korrekt sind, dann Entwürfe mit geringer Qualität rendern und den Ton messen, bevor die teure Master-Renderung durchgeführt wird. Die Fähigkeit legt großen Wert darauf, Feedback in klare Aktionen umzusetzen und Änderungen konsequent und respektvoll anzuwenden. Sobald der Entwurf genehmigt ist, wird das Master mit hoher Auflösung gerendert, die fertige Datei wird mit ffprobe, einem vollständigen Sheet und Lautstärkemessungen verifiziert. Abschließend werden die Projektdokumente (SCRIPT.md, SPEC.md, CREDITS.md, REVIEW.md) aktualisiert und eine kurze Übergabenachricht mit den wichtigsten Punkten verfasst. Hinzu kommen Haushaltsregeln: Quellen und Manifests aufbewahren, alte Entwürfe löschen, das Repository des Kunden nicht ohne Aufforderung committen und Hilfsskripte im Projektverzeichnis behalten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/shubhamnshukla/video-agent-kit/tree/main/skills/video-review-and-delivery

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Bewertung und Auslieferung?

1. Die Schleife nach jeder Änderung

  1. npx hyperframes lint. Null Fehler.
  2. npx hyperframes snapshot --at 3.4,7.8,35.2,... an den Stellen, die Sie geändert haben, plus eine davor und eine danach. Öffnen Sie das Kontaktblatt und lesen Sie es tatsächlich: Ist jede Karte vollständig, ist ein Gesicht verdeckt, läuft Text aus seinem Feld, ist etwas halb gezeichnet, das fertig sein sollte?
  3. Korrigieren und wiederholen, bis die Frames richtig sind.
  4. npx hyperframes check --json (oder scripts/check.sh bei 4K-Material). Fehler korrigieren. Lesen Sie die Warnungen einmal und entscheiden Sie: Beheben oder beibehalten und Grund in REVIEW.md angeben. Warnungen, die es wert sind, bearbeitet zu werden: Nichts ändert sich länger als drei Sekunden, ein leerer erster Frame, Text läuft aus einem Container.

Schnappschüsse sind billig; Render sind es nicht. Machen Sie so viel Prüfung wie möglich vor dem Rendern.

2. Entwürfe

Ein Entwurf ist der gesamte Film in niedriger Qualität: npx hyperframes render --quality draft -o renders/draft-01.mp4, eine bis drei Minuten für einen 100-Sekunden-Film bei 1080p. Dann:

  • Erstellen Sie ein Blatt der gerenderten Datei (scripts/sheet.sh renders/draft-01.mp4 sheet.jpg 1/2.6 8x5) und lesen Sie es. Es zeigt den Film so, wie er codiert ist, einschließlich des Materials, das Schnappschüsse falsch darstellen können.
  • Lautstärke messen: ffmpeg -i draft.mp4 -af ebur128=peak=true -f null -.
  • Messen Sie den Pegel alle zwei Sekunden (scripts/levels.py draft.mp4 2) und vergleichen Sie ihn mit dem Plan: Ist der leise Teil leise, kommt der Aufschwung dort, wo das Produkt ist?

Geben Sie der Person den Entwurf mit einer kurzen Notiz, was darin ist und worauf Sie Ihr Augenmerk und Ohr lenken möchten. Der erste Entwurf existiert, um korrigiert zu werden; geben Sie ihn früh statt poliert.

3. Optionen zeigen

Wenn es um ein Aussehen geht (ein Highlight-Stil, eine Schriftart, ein Layout, eine Farbe), zeigen Sie Standbilder, keine Render.

  • Bauen Sie jede Option, machen Sie einen Schnappschuss von denselben drei oder vier Momenten und speichern Sie die Kontaktblätter nebeneinander mit einfachen Namen (A-underline.jpg, B-band.jpg).
  • Sagen Sie in einer Zeile, was A und B sind und welche Sie wählen würden und warum.
  • Warten Sie nur zu diesem Punkt auf die Antwort; arbeiten Sie weiter an allem, was nicht davon abhängt.

Wenn ihre Worte zwei Dinge bedeuten könnten, finden Sie es so heraus. Es kostet eine Minute. Ein falscher vollständiger Render kostet zehn und ihre Geduld.

4. Auf Feedback reagieren

Feedback kommt kurz, informell und manchmal verärgert. Gehen Sie so damit um:

  • Formulieren Sie es als Aktion um, bevor Sie handeln, in einer Zeile: "Singapur-Foto: gleiche Kleinschrift wie die anderen, im Problem und im Schluss."
  • Wenden Sie es überall an, wo es zutrifft. Wenn ein Element falsch war, sind seine Geschwister an anderer Stelle im Film auf die gleiche Weise falsch.
  • Nehmen Sie Geschmack als gegeben hin. "Langsam", "langweilig", "sieht billig aus", "zu dick": Ändern Sie es; verteidigen Sie es nicht. Wenn Sie in einer sachlichen Frage anderer Meinung sind (es würde ein Gesicht verbergen, eine Behauptung wäre unwahr), sagen Sie es einmal, mit dem Grund.
  • Häufige Anmerkungen und was sie bedeuten:
Sie sagenTun Sie
langsam, verschlafen, langweiligkürzere Einstellungen, schnellere Stimme, Zeilen kürzen, energischere Musik; nicht mehr Effekte
sieht nicht echt aus, sieht nach KI ausechte Aufnahmen von echten Menschen; weniger erfundene Grafiken
sieht aus wie zusammengeklebte Stock-Clipseine Gradierung auf allem; wiederkehrende Personen; konsistente Karten
Ich kann mich nicht damit verbindenNamen, Berufe, spezifische Wünsche; das Problem in ihren eigenen Worten
der Ton ist flach, eintönignach Stimmung vertonen; leise vor dem Aufschwung
mach es eingängigden Haken und die Zusammenfassungszeile umschreiben; einen Rückbezug einfügen
dieses hier ist anders als die anderenes genau an die Geschwister angleichen
mehr Aufmerksamkeit auf diese Worteeine Betonungsmarkierung pro Zeile, zuerst als Standbilder zeigen
  • Mehrere Nachrichten auf einmal: jede einzeln behandeln; in einer Zeile sagen wie. Eine spätere Nachricht überschreibt eine frühere.
  • Entscheidungen dokumentieren in REVIEW.md und im Gedächtnis: was sie gewählt haben, was sie abgelehnt haben, in ihren Worten.

5. Das Master-Rendering

Wenn der Entwurf genehmigt ist oder die verbleibenden Änderungen klein sind:

  1. Freien Speicherplatz prüfen. Ein 4K-Render benötigt etwa 11 GB temporären Speicherplatz pro 100 Sekunden.
  2. npx hyperframes render --quality delivery --resolution landscape-4k -o renders/<name>-4k.mp4, im Hintergrund. --gpu hinzufügen, wenn sie Geschwindigkeit wünschen oder danach gefragt haben; sagen, was es kostet (etwa die halbe Bitrate).
  3. Wenn sie fragen, wie lange es dauert, den Fortschritt des Renders ablesen und mit einer Zahl antworten.

Versionen klar benennen (-v2, -v3). Wenn eine Version abgelehnt wird, löschen, damit niemand sie versehentlich öffnet.

6. Die fertige Datei überprüfen

Führen Sie dies an der Datei durch, die Sie übergeben werden, nicht am Projekt.

  • ffprobe: Auflösung, Bildrate, Dauer, Größe.
  • Ein Blatt der gesamten Datei: jeder Abschnitt vorhanden, keine leere oder eingefrorene Stelle, der letzte Frame korrekt.
  • Ein Vollformat-Ausschnitt von Text und einem Gesicht: scharfe Schrift, Material nicht verpixelt.
  • Lautstärke: etwa −16 LUFS integriert, True Peak bei oder unter −1 dBFS.
  • Der QR-Code, dekodiert von einem späten Frame (scripts/scan.py): der genaue Link, in voller und halber Größe.
  • Die Adresse auf der Endkarte antwortet, wenn sie angefragt wird.

7. Der Projektbericht

Aktualisieren Sie die vier Dateien vor der Meldung. templates/ enthält jede als Skelett.

  • SCRIPT.md: die Skripttabelle (Zeit, Bild, Stimme), die Personen, woher jede Zeile kommt, die Zahlen.
  • SPEC.md: Ziel, Ausgabe, Zeit- und Tonplan, Aussehen, Typ, Bewegung, die Einstellungsliste mit Frames, eine QA-Liste.
  • CREDITS.md: jede Quelle und ihre Lizenz.
  • REVIEW.md: getroffene Entscheidungen; gemessen, angesehen, nicht geprüft; offene Entscheidungen; schwächste Einstellungen; Warnungen absichtlich beibehalten; wie der Film geändert werden kann (welche Datei, welcher Befehl).

8. Die Übergabenachricht

Kurz, in dieser Reihenfolge:

  1. Die Datei: Pfad, Auflösung, Länge, Größe.
  2. Was sich seit der letzten Version geändert hat, als kurze Liste.
  3. Was Sie geprüft haben und wie; was Sie nicht geprüft haben (Sie haben es nie gehört).
  4. Was ihre Entscheidung erfordert, das Wichtigste zuerst: Dinge, die im Produkt nicht live sind, alles auf dem Bildschirm, das das Unternehmen möglicherweise nicht gezeigt haben möchte, Lizenzen zur Bestätigung, Aussprachen, auf die man achten sollte.

Keine Adjektive über Ihre eigene Arbeit. Wenn etwas fehlgeschlagen ist oder fehlt, ist das die erste Zeile.

9. Haushalt

  • Behalten Sie die Quellen-Downloads und Manifeste, aus denen der Film geschnitten ist; löschen Sie Kandidaten, die Sie nicht verwendet haben, alte Entwürfe und Caches, wenn der Platz knapp wird oder wenn darum gebeten wird. Sehen Sie sich an, was Sie löschen werden; löschen Sie nur, was Sie erstellt haben.
  • Comitten oder pushen Sie niemals deren Repository, es sei denn, Sie werden darum gebeten.
  • Behalten Sie Generator-Skripte und Hilfsskripte im Projekt, nicht in einem temporären Ordner, der durch einen Neustart gelöscht wird.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Verwandte Skills