PR-Video
Ein 40-100 Sekunden langes Erklärvideo zu einem Pull-Request – für Personen, die ihn nicht selbst lesen werden (oft Manager): was sich ändert,
warum, wie es funktioniert, was riskant ist, der Status und wo ein Reviewer beginnen sollte. Technisch, aber verständlich.
Alles läuft über die CLI: node cli/prs.mjs <Befehl> aus dem Repository-Stammverzeichnis, oder
node <Pfad zu pr-studio>/cli/prs.mjs <Befehl> von überall (unten: prs).
Start
- Niemand schaut zu (ein GitHub Actions-Job)? Lese zuerst guides/unattended.md: keine Fragen, ein Zeitlimit, eine Review-Runde, wohin das Ergebnis geht.
- Gestartet von Slack (@GitHub, eine Cloud-Session)? Lese zuerst guides/slack.md: Triage, das 59-Minuten-Budget, das Posten jedes Videos im Thread und was dort nicht zu tun ist.
- Einmal pro Maschine:
prs doctor(Browser, Sprachmodell, Whisper, ffmpeg; es fügt nur hinzu, was fehlt). - Dann lies guides/story.md und guides/visuals.md. Überfliege catalog.md für die verfügbaren Diagramme.
Workflow (Ziel: 15–20 Minuten)
- Abrufen.
prs new <PR URL>schreibtvideos/<slug>/:brief.md(lies es ganz),pr.diff(durchsuche es nach den benötigten Zeilen, lies es nicht komplett),pr.jsonund ein Storyboard-Skelett mit der richtigen Anzahl an Beats. - Story. Schreibe
videos/<slug>/storyboard.json: eine Idee pro Beat, einneedpro Beat, Cues und die Behauptungen mit Belegen (guides/story.md). Führeprs checkaus, bis es ready for prs voice meldet. - Sprache, im Hintergrund. Starte
prs voice(ca. eine Minute; MAI-Voice-2, wenn ein Azure-Schlüssel konfiguriert ist, ansonsten die lokale Kokoro-Stimme) und arbeite weiter, während es läuft. - Regie.
prs directwählt für jeden Beat eine Behandlung und die Bewegung für das Video aus, schreibtdirection.jsonund erstelltscenes.jsmit diesen Behandlungen. Fülle jedes TODO aus dem PR. Behalte die Auswahlen bei: sie sind so gewählt, dass sie sich von aktuellen Videos unterscheiden. Wenn eine Behandlung ihren Beat nicht zeigen kann, wähle sie mitprs direct --use <beat>=<treatment> --reason "..."neu aus (der Grund wird aufgezeichnet und überprüft). - Ansicht.
prs stillsrendert Schlüsselbilder undbuild/stills/contact.png. Öffne das Kontaktblatt und die Bilder, die wichtig sind, und behebe, was du siehst. Stills funktionieren, bevor die Sprache fertig ist (vorläufige Zeitsteuerung). - Prüfung.
prs lintmuss 0 Probleme melden (Layout, Textherkunft, Untertitel-Band, Neuheit, QR). - Rendern und veröffentlichen.
prs render(Sekunden, Bilder sind gecached), dannprs publish: Kodierung, Untertitel, der Sync-Gate (Audio vs. Untertitel), Auslieferung nach~/Downloads/pr-videos/<slug>/und der Galerieeintrag. - Abnahme. Folge guides/review.md, bis der
pr-director-Agent mitVERDICT: SIGNED OFFantwortet; nach Korrekturen erneut veröffentlichen. - Ausliefern. Gib den mp4-Pfad, seine Länge, eine einzeilige Zusammenfassung pro Beat, das Urteil und an, was du nicht prüfen konntest (du kannst das Audio nicht hören; der Sync-Gate misst es).
Optional: Wenn der Benutzer nach Optionen fragt, füge export const concepts = { beat, options: { a, b, c } } zu
scenes.js hinzu und führe prs concepts aus: es rendert den Beat auf drei Arten nebeneinander.
Regeln
- Genau oder abwesend. Jede Aussage im Sprechertext und auf dem Bildschirm muss aus dem PR stammen: dessen Text, Commits, Diff, Tests oder Code am Head-Commit. Schreibe ungetestete Behauptungen des Autors als „laut Autor“. Keine Vermutungen über Absichten, kein Marketing.
- Textherkunft. Bildschirmtexte gehen durch
label()(deine Worte),fact()(Zahlen und Namen auspr.json),quote()(exakter PR-Text),ident()(Code-Namen im Diff),path()undcode().prepareüberprüft jeden gegen den PR; Zahlen in einemlabel()werden markiert. - Einheitliches Erscheinungsbild. Weiß, Microsoft-Palette, Aptos. Füge innerhalb eines Videos keine Farben, Schriftarten, Hintergründe oder neuen Layouts hinzu. Der erste Frame (Titel) und die Endkarte sind festgelegt.
- Unterschiedliche Erklärungen. Öffne oder kopiere niemals das
scenes.jseines anderen Videos; die Galerie speichert nur Storyboards und Kontaktblätter. Wenn der Katalog ein Diagramm vermisst, das der PR benötigt, füge eine Behandlung incatalog/hinzu (mit Demo,when, Parametern, einem Katalog-Still viaprs catalog --stills, lint sauber), anstatt Pixel von Hand zu platzieren. - Sieh dir an, was du machst. Öffne die Stills und das Kontaktblatt, bevor du sagst, dass etwas funktioniert.
Befehle
prs new <url> | PR abrufen, brief.md und ein Storyboard-Skelett schreiben |
prs check | Storyboard: Längenfenster, Cues, Platzhalter, Beweisanker, Aussprachehinweise |
prs voice [--provider mai|kokoro|recording|silent] | Sprechertext + Wortzeitsteuerung (Pausen-getriggert) |
prs direct [--use beat=treatment --reason ...] | Behandlungen und Bewegung auswählen; scenes.js erstellen |
prs stills [--beat id] [--at 12.3,20] | Schlüsselbilder + Kontaktblatt |
prs lint [--every 0.5] | Layout, Herkunft, Untertitel-Band, Neuheit, QR |
prs render / prs draft | Endgültige Bilder / eine halbgroße Vorschau-mp4 |
prs publish | Kodierung, Untertitel, Sync-Gate, Auslieferung, Galerie |
prs catalog | Jede Behandlung mit ihren Parametern |
prs triage <PRs> | --file f, prs summary, prs budget | Welche PRs ein Video verdienen (Slack-Läufe); die abschließende Nachricht; Minuten, die in einer Cloud-Session verbleiben |
prs history, prs report | Aktuelle Videos; wo die Zeit geblieben ist |
prs smoke | Ein kurzes Demo-Video von Anfang bis Ende, mit Zeitangaben: ist diese Maschine bereit? |