/video-new
Bevor irgendetwas gebaut wird, schreibe auf, was das Video erklären muss und was es behaupten darf, und lasse den Prüfer beides abzeichnen. Dann anhalten.
Warum es das gibt: In der Produktion, aus der diese Skills stammen, entstanden 9 von 26 Versionen, weil ein Video ein Feature nicht erklärte, das dem Prüfer wichtig war. Niemand hatte diese Features vor dem Bauen aufgeschrieben, also tauchte jedes in der Überprüfung auf, kostete einen vollen Render- und QA-Durchlauf, und musste dann von Hand auf jedes andere Video übertragen werden. Positionierung und Behauptungen verursachten auf die gleiche Weise 3 weitere Versionen. Zwei unterschriebene Blätter im Vorfeld sind billiger als jeder dieser Durchläufe.
Bevor du beginnst
PVS_HOME="$(cd "$(cd "${CLAUDE_SKILL_DIR}" && pwd -P)/../.." && pwd)"
Finde das Produkt: das nächstgelegene Verzeichnis oberhalb des aktuellen Pfades, das eine product.yaml enthält. Wenn es keines gibt, sage dem Benutzer, dass er /product-new zuerst ausführen soll (du kannst es nicht für ihn ausführen: es wird vom Benutzer aufgerufen). Lies product.yaml, kit/RULES.md und das BRIEF eines beliebigen Schwestervideos in videos/: Die Abdeckungsmatrix und die Behauptungen eines Schwestervideos sind der beste Ausgangspunkt, und der Cast muss über alle Videos hinweg identisch bleiben.
Die Video-ID stammt aus dem Argument (Kleinbuchstaben, Ziffern, Bindestriche). Wenn videos/<video>/ bereits existiert, brich ab: Ein bestehendes Video wird mit /video-review weiterbearbeitet, niemals durch Neustart.
1. Frage, wofür das Video ist
Eine Nachricht, höchstens vier Fragen, jede mit einem vorgeschlagenen Standardwert:
- Wer sieht es und wo wird es veröffentlicht (Pitch-Deck, kurze Produkttour, Dokuseite, Onboarding, Landing-Loop).
- Was der Zuschauer danach glauben oder tun können soll (ein Satz).
- Ungefähre Länge (Standardwerte: Pitch 90 s, Tour 30 s, Doku 120 s, Tutorial 240 s, Loop 15 s). Eine Tour ist ein Pitch, der auf ein oder zwei Features reduziert ist: gleicher Einstieg, Endscren und Verriegelung, weniger Kapitel. Wähle sie, wenn der Prüfer „kurze Tour“ oder eine Länge unter 45 s wünscht.
- Welche Features dem Prüfer am wichtigsten sind. Frage nach ihnen mit Namen und frage, welche davon funktionierend gezeigt statt nur erwähnt werden müssen.
2. Erstelle das Verzeichnis
"$PVS_HOME/bin/pvs-py" "$PVS_HOME/skills/video-new/scripts/new_video.py" <product_dir> <video> \
--format <format> [--title "<title>"] [--duration <s>]
Es kopiert _template/video, füllt die BRIEF-Frontmatter (Titel, Video, Format, Dauer, Sprache und Prüfer aus product.yaml, Version 1) und lässt beide Unterschriften leer. Es verweigert eine doppelte ID.
3. Schreibe die drei Blätter
Lies references/sheets.md für das Format jedes Blattes und ausgearbeitete Zeilen, bevor du schreibst.
- BRIEF.md: Absicht (zitiere die eigenen Worte des Benutzers), Zielgruppe, die vorgeschlagenen Kapitel, Notizen mit jedem fiktiven Namen und jeder Zahl, die das Video verwenden wird (aus dem Cast des Produkts, niemals neue ohne Nachfrage), und ein leerer Changelog-Eintrag für v1.
- COVERAGE.md: Eine Zeile pro Feature mit „muss auf dem Bildschirm erklärt werden? ja/nein“, dem Kapitel, das es erklärt, und dem Nachweis (was der Zuschauer geschehen sieht). Ein Feature, das nur auf dem Endscren genannt wird, ist nicht abgedeckt: Das ist genau die Lücke, die die meisten Versionen gekostet hat. Füge die konfigurierbaren Teile hinzu (Einstellungen, Trigger inklusive geplanter, Übergabe, Follow-ups), weil dies die Features waren, die Prüfer im Nachhinein immer wieder anfragten.
- CLAIMS.md: Die Positionierungszeile (aus
product.yaml, niemals aus einem Marketingdokument), die zu vermeidenden Phrasen (never_sayplus alles, was der Benutzer hinzufügt), jede Behauptung, die die Narration aufstellen möchte und eine Genehmigung benötigt, genehmigte Taglines und die kanonischen Produktnamen gegen ihre Legacy-Bezeichnungen.
Überprüfe jede Behauptung und jedes Feature anhand dessen, was du in sources/ und den Dokumenten sehen kannst. Wenn das Produkt etwas nicht tut, was der Benutzer gefragt hat, sage dies mit einer geschlossenen Frage und einer empfohlenen Option („nur zeigen, was existiert“ ist normalerweise die richtige Voreinstellung). Nimm kein Feature in die Matrix auf, das der Code nicht stützen kann.
4. Schlage die Kapitel vor
Füge die Kapiteltabelle zu BRIEF.md hinzu. Eine Idee pro Kapitel, eine Rahmung pro Kapitel, jedes „muss erklärt werden“-Feature einem Kapitel zugeordnet. Beginne mit dem Kontext (der Produktname und eine Zeile darüber, was es ist), niemals mitten in der UI. Rahme die gesamte Seite standardmäßig mit 1x ein; Tiefen-Zooms wurden in der ursprünglichen Produktion zweimal abgelehnt. Ende mit der Breite (was das Produkt sonst noch tut), dann die Verriegelung.
5. Halte an und bitte um die Unterschriften
Zeige dem Benutzer in einer Nachricht:
- Die Abdeckungsmatrix (die „ja“-Zeilen) und die Kapiteltabelle.
- Die Positionierungszeile, die genehmigungsbedürftigen Behauptungen und die vorgeschlagene Tagline.
- Höchstens drei geschlossene Entscheidungen, jeweils mit einer Voreinstellung (z. B. die Tagline, ein Cast-Name, Weglassen eines Features). Sage, was Schweigen bedeutet: die Voreinstellung.
Bitte dann den Prüfer um Unterschrift. Entweder sie schreiben ihren Namen selbst in coverage_signed_by und claims_signed_by in BRIEF.md, oder sie sagen dir in eigenen Worten, dass du unter ihrem Namen unterschreiben sollst, und du führst aus:
"$PVS_HOME/bin/pvs-py" "$PVS_HOME/skills/video-new/scripts/sign.py" <video_dir> \
--coverage "<Name des Prüfers>" --claims "<Name des Prüfers>"
Unterschreibe niemals aus eigener Initiative, niemals, weil die Blätter „vollständig aussehen“, und niemals mit einem Namen, den der Prüfer nicht angegeben hat. Die Unterschrift ist die Aussage des Prüfers, dass die Matrix das ist, wogegen sie das Video beurteilen werden. sign.py verweigert eine leere Matrix oder eine fehlende Positionierungszeile; ohne Flags zeigt es nur den Status.
Baue nicht, rendere nicht, nimm keine Narration auf und starte keine Unteragenten, selbst wenn der Benutzer in derselben Nachricht unterschreibt. Bauen ist /video-build, getippt vom Benutzer. Diese Trennung verhindert, dass der Agent einen teuren Build auf einem nicht unterschriebenen Brief startet.
Bericht
| Punkt | Wert |
|---|---|
| Video | videos/<video>/, Format, Ziellänge |
| Abdeckung | N Features auf dem Bildschirm zu erklären, M nur aufgelistet, Kapitel |
| Behauptungen | Positionierung, genehmigungsbedürftige Behauptungen |
| Entscheidungen | die bis zu drei geschlossenen Fragen und ihre Voreinstellungen |
| Unterschriften | nicht unterschrieben (oder unterschrieben von wem) |
Als Nächstes, sobald unterschrieben: /video-build <video>.