/video-build
Du bist der Koordinator. Du prüfst das Tor, verteilst Unteragenten Stufe für Stufe, verifizierst jede Stufe anhand ihrer Dateien, führst die QA selbst erneut durch, lieferst aus und berichtest. Du schreibst keinen Kompositionscode, Spezifikationen oder Erzähltexte und renderst nicht.
Warum die Aufteilung: In der Produktion, aus der diese Fähigkeiten stammen, füllte sich der Kontext des Hauptagenten beim Erstellen von Videos achtmal, einmal mitten in einer Korrektur. Wenn er nur koordinierte (konsolidieren, Briefings schreiben, Belege prüfen, ausliefern), wurden drei Korrekturen in 70 Minuten ausgeliefert. Im Koordinator sitzt auch die Qualitätssperre: Unteragenten meldeten „saubere“ Render, die die eigene QA des Koordinators dann mit einem 0,3-Sekunden-Blitzer und einem abgeschnittenen Modal auffing.
0. Die Arbeit finden
PVS_HOME="$(cd "$(cd "${CLAUDE_SKILL_DIR}" && pwd -P)/../.." && pwd)"
PY="$PVS_HOME/bin/pvs-py"; S="$PVS_HOME/skills/video-build/scripts" # beide in Anführungszeichen bei Verwendung
- Mit
<video>:videos/<video>/im aktuellen Produkt. - Ohne
<video>: der Video-Ordner, in dem du dich befindest, oder andernfalls jedes Video des Produkts, dessen Blätter unterschrieben sind und dessen aktuelle Version keine Auslieferung hat. Zeige diese Liste und bestätige sie in einer geschlossenen Frage, bevor du irgendetwas verteilst.
Führe "$PY" "$S/stages.py" <video_dir> für jedes Video aus und zeige die Tabelle. Stufen, die bereits erledigt sind, werden
übersprungen, sodass /video-build einen Build fortsetzen kann, der auf halbem Weg gestoppt wurde.
1. Das Tor
"$PY" "$S/stages.py" <video_dir> --require signoff. Wenn eine der beiden Signaturen in BRIEF.md leer ist, stoppe und teile
dem Benutzer mit, was fehlt und wie er unterschreiben kann (der Prüfer schreibt seinen Namen oder sagt dir, du sollst
sign.py von /video-new ausführen). Dies ist die Prüfung, die die teuerste Art von Nacharbeit (eine
Funktion, die der Prüfer erklärt haben wollte und die niemand aufgeschrieben hat) daran hindert, einen Build zu starten.
--draft ist die eine Ausnahme, und zwar nur, wenn der Benutzer es eingegeben hat: Ein Entwurf kann gebaut,
gerendert und QA-geprüft werden, damit der Prüfer vor der Unterschrift etwas sieht, aber deliver.py
lehnt ihn ab. Sage dies im Bericht.
Lies auch product.yaml, kit/RULES.md, BRIEF.md, COVERAGE.md und CLAIMS.md selbst: Du
brauchst sie, um die Unteragenten-Aufforderungen zu schreiben und ihre Ergebnisse zu bewerten. Lies nichts anderes im Detail.
2. Verteilen
Verwende das Agenten-Werkzeug mit Hintergrund-Unteragenten. Aufforderungen für jede Stufe befinden sich in
references/stage-prompts.md und die Builder-Aufforderung befindet sich in references/builder-prompt.md; lies
sie vor der ersten Verteilung und fülle jeden Platzhalter. Nachdem jeder Unteragent berichtet hat, führe
"$PY" "$S/stages.py" <video_dir> --require <stage> aus, bevor du etwas startest, das davon abhängt.
| Welle | Stufe | Unteragenten | Benötigt | Schreibt |
|---|---|---|---|---|
| 1 | recon | 1 pro Video, source-recon | signoff | sources.lock, SOURCES.md |
| 2 | truth | 1 pro Video, product-truth | recon | TRUTH.md |
| 2 | specs | 1 pro Bildschirm, ui-spec-from-code (oder ui-reference-capture für Bildschirme ohne Code) | recon | specs/<screen>.md |
| 3 | voice | 1 pro Video, script-and-voice | truth | audio/lines.tsv, clips/, timings.json |
| 4 | compose + render | 1 Builder pro Video, ui-demo-composer + seek-safe-motion | specs, voice | video/, renders/<video>-v<N>.mp4 |
| 5 | qa | du | render | qa/REPORT.json |
| 6 | deliver | du | qa | deliveries/ |
Wellen laufen parallel über Videos hinweg und innerhalb einer Welle (truth und die Spezifikationen jedes Bildschirms gehen gleichzeitig raus). Mehrere Videos teilen sich eine Maschine: Sage in jeder Aufforderung, dass kein Agent einen Prozess tötet, den er nicht gestartet hat, und dass Render langsamer sein können, während andere laufen.
Vor Welle 3 auf Version 1, wenn der Sprachdienstleister kostenpflichtig ist, zeige dem Benutzer den Erzählplan in einer Nachricht: die Kapiteltabelle, die Tagline, die Stimme, höchstens drei geschlossene Entscheidungen mit Standardwerten. Das Aufzeichnen der Erzählung verbraucht gemeinsames Kontingent, und ein Ton oder ein Name, der dem Prüfer nicht gefällt, ist am günstigsten zu ändern, bevor er aufgezeichnet wird. Wenn der Benutzer bereits gesagt hat, geradeaus durchzugehen, überspringe dies und liste die Wahlmöglichkeiten für ein Veto im Abschlussbericht auf.
Während Unteragenten laufen, belästige sie nicht mit Nachrichten. Überprüfe den Fortschritt anhand von Dateien
(Änderungszeitpunkte, $STAGES, das Ende eines Render-Logs) und beantworte ihre Fragen, wenn sie sie
senden. Genehmigungen gehen an den Benutzer, Entscheidungen kommen zurück: Wenn ein Unteragent etwas fragt,
was nur der Benutzer erlauben kann (einen Download, eine neue Asset-Quelle), frage den Benutzer eine
geschlossene Frage und leite die Antwort weiter.
Wenn ein Unteragent nicht mehr reagiert, starte einen neuen mit derselben Aufforderung plus „Vorheriger Agent hielt bei an; fahre von den Dateien fort“. Der Zustand lebt in den Dateien, nicht in den Agenten.
3. Deine eigene QA, unabhängig vom Builder-Bericht
"$PVS_HOME/bin/pvs-py" "$PVS_HOME/skills/render-qa/scripts/qa.py" <video_dir> <mp4> \
--strip <name>:<t0>:<t1> ...
Lade die render-qa-Fähigkeit, um zu erfahren, wie das Ergebnis gelesen wird. Füge einen Strip um jeden Kapiteltitel,
jedes Modal und den Endbildschirm hinzu, um die Übergabe zu überprüfen (Zeiten aus der Kapiteltabelle des Builders). Sieh dir
dann selbst qa/REPORT.md, jedes Kontaktblatt und jeden Strip an. Überprüfe die Erzählung anhand
von COVERAGE.md: Jede „Ja“-Zeile muss in ihrem Kapitel erklärt werden.
Wenn etwas fehlschlägt, sende das genaue Problem an den Builder zurück (SendMessage, während er lebt,
das kondensierte Korrekturformat in references/stage-prompts.md), oder, wenn er weg ist, starte einen
Korrektur-Agenten mit der Aufforderung in $PVS_HOME/skills/video-review/references/fix-prompt.md (lies die Datei; rufe
diese Fähigkeit nicht auf, sie ist benutzergesteuert). Führe diesen Schritt auf dem neuen Render erneut aus. Liefere niemals
einen Render aus, den du nicht selbst QA-geprüft hast.
4. Ausliefern
"$PVS_HOME/bin/pvs-py" "$PVS_HOME/skills/render-qa/scripts/deliver.py" <video_dir> <mp4> --archive-previous
Es lehnt einen Entwurf, einen fehlgeschlagenen Bericht oder einen Bericht ab, dessen sha256 nicht mit der Datei übereinstimmt. Umgehe eine Ablehnung nicht: Behebe die Ursache. Überschreibe niemals eine ausgelieferte Datei; deliver.py erhöht stattdessen den Namen und warnt, und du sagst es.
5. Bericht
Eine Tabelle für die gesamte Charge, dann höchstens drei geschlossene Entscheidungen:
| Video | Version | Dauer | Kapitel | Abdeckung erklärt | QA | Ausgeliefert als |
|---|
Darunter: was real und was angenommen ist, alles Unverifizierte, die Namen, Stimmen und Tagline
für ein Veto, und der nächste Schritt (/video-review mit den Notizen des Prüfers). Schreibe in der Sprache
des Benutzers, kurz, zuerst die Tabellen.
Wann die Referenzen zu lesen sind
references/stage-prompts.md: vor dem Verteilen der Wellen 1 bis 3 und für jede Korrekturanfrage.references/builder-prompt.md: vor dem Verteilen von Welle 4.