Communitygithub.com

federicobrancasi/pr-studio

Erstellt automatisch ein 40-100-sekündiges Video, das einen Pull-Request verständlich erklärt – für Personen, die ihn nicht selbst lesen (oft Manager).

Was ist pr-studio?

Dieses Skill ermöglicht es einem KI-Agenten (wie Claude Code, Cursor oder Codex) und dem Benutzer, aus jedem Pull-Request ein kurzes, professionelles Erklärvideo zu erstellen – ideal für Teammitglieder, die schnell verstehen müssen, was sich geändert hat, ohne den gesamten PR-Code zu lesen. Es deckt den gesamten Workflow ab: PR-Datenabruf, Erstellung eines Storyboards, Generierung einer Vertonung (lokal mit Kokoro oder Cloud-basiert mit MAI-Voice-2), Auswahl und Anpassung von Diagrammen sowie automatische Layout- und Text-Provenienz-Prüfungen. Das Skill läuft über die CLI (`node cli/prs.mjs <Befehl>`) und bietet spezielle Modi für unbeaufsichtigte GitHub-Actions-Ausführungen und Slack-gesteuerte Cloud-Sessions. Es folgt strengen Regeln: Jede Aussage muss durch den PR belegt sein, und die visuelle Gestaltung ist auf einheitliche professionelle Standards (weiß, Microsoft-Palette, Aptos-Font) beschränkt. Der Workflow ist in neun klare Schritte unterteilt, zielt auf eine Gesamtzeit von 15–20 Minuten ab und endet mit einem formalen Sign-Off durch den `pr-director`-Agenten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/federicobrancasi/pr-studio/tree/HEAD/.claude/skills/pr-video

In Ihrer bevorzugten KI fragen

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

Dokumentation

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)

  1. Abrufen. prs new <PR URL> schreibt videos/<slug>/: brief.md (lies es ganz), pr.diff (durchsuche es nach den benötigten Zeilen, lies es nicht komplett), pr.json und ein Storyboard-Skelett mit der richtigen Anzahl an Beats.
  2. Story. Schreibe videos/<slug>/storyboard.json: eine Idee pro Beat, ein need pro Beat, Cues und die Behauptungen mit Belegen (guides/story.md). Führe prs check aus, bis es ready for prs voice meldet.
  3. 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.
  4. Regie. prs direct wählt für jeden Beat eine Behandlung und die Bewegung für das Video aus, schreibt direction.json und erstellt scenes.js mit 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 mit prs direct --use <beat>=<treatment> --reason "..." neu aus (der Grund wird aufgezeichnet und überprüft).
  5. Ansicht. prs stills rendert Schlüsselbilder und build/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).
  6. Prüfung. prs lint muss 0 Probleme melden (Layout, Textherkunft, Untertitel-Band, Neuheit, QR).
  7. Rendern und veröffentlichen. prs render (Sekunden, Bilder sind gecached), dann prs publish: Kodierung, Untertitel, der Sync-Gate (Audio vs. Untertitel), Auslieferung nach ~/Downloads/pr-videos/<slug>/ und der Galerieeintrag.
  8. Abnahme. Folge guides/review.md, bis der pr-director-Agent mit VERDICT: SIGNED OFF antwortet; nach Korrekturen erneut veröffentlichen.
  9. 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 aus pr.json), quote() (exakter PR-Text), ident() (Code-Namen im Diff), path() und code(). prepare überprüft jeden gegen den PR; Zahlen in einem label() 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.js eines 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 in catalog/ hinzu (mit Demo, when, Parametern, einem Katalog-Still via prs 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 checkStoryboard: 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 draftEndgültige Bilder / eine halbgroße Vorschau-mp4
prs publishKodierung, Untertitel, Sync-Gate, Auslieferung, Galerie
prs catalogJede Behandlung mit ihren Parametern
prs triage <PRs> | --file f, prs summary, prs budgetWelche PRs ein Video verdienen (Slack-Läufe); die abschließende Nachricht; Minuten, die in einer Cloud-Session verbleiben
prs history, prs reportAktuelle Videos; wo die Zeit geblieben ist
prs smokeEin kurzes Demo-Video von Anfang bis Ende, mit Zeitangaben: ist diese Maschine bereit?

Verwandte Skills