Communitygithub.com

Demo-Video

Plane und erstelle kurze, evidenzbasierte Videos über Softwarearbeit: Erledigt-Videos für einen einzelnen Change, Sprint-Demos, „Bisher“-Rückblicke, Forschungsergebnisse, Releases, Konzeptfilme, Walkthroughs und Bug-Repros. Eine Blaupause: Kurzbeschreibung, Anspruchstabelle, Storyboard, Taktung, Branding und Review für jeden HTML-zu-Video-Renderer.

Was ist Demo-Video?

Diese Fähigkeit definiert eine Blaupause für die Erstellung kurzer, evidenzbasierter Videos, die Softwarearbeit dokumentieren. Sie ist kein installiertes Tool, sondern ein methodischer Leitfaden, der für verschiedene Videomodi wie „Erledigt“, „Sprint-Demo“, „Bisher“, „Forschung“, „Release“, „Konzept“, „Walkthrough“ und „Repro“ ausgelegt ist. Der Kern liegt auf „Beweise vor Kunst“: Jedes Bild zeigt echte UI, echte Ausgaben und reale Quellseiten, wobei alle Fakten in einer Anspruchstabelle verzeichnet sein müssen, bevor die Szene gebaut wird. Die Fähigkeit beschreibt den gesamten Workflow vom Verfassen einer Kurzbeschreibung und eines Storyboards über die Aufnahme (z. B. mit Playwright) und Komposition (z. B. mit HyperFrames, Remotion oder Motion Canvas) bis hin zur Überprüfung und Lieferung. Sie betont strenge Qualitätsstandards wie Lesbarkeit auf dem Handy, scharfe UI-Aufnahmen, lizenzierte Musik und genehmigtes Branding. Diese Blaupause ist für HTML-zu-Video-Renderer gedacht und autorisiert lokale Aufnahme, Komposition und Überprüfung, jedoch keine Veröffentlichung ohne ausdrückliche Genehmigung.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jernejk/jkstack/tree/HEAD/blueprints/demo-video

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Demo-Video?

Ein Video hier ist zuerst Beweis und zweitens Film. Jedes Bild zeigt etwas Echtes, beschriftet für das, was es ist, lesbar auf einem Telefon und zeitlich so abgestimmt, dass das Ergebnis vor dem Detail landet.

Dies ist eine Blaupause, keine installierte Fähigkeit. Sie beschreibt eine Methode, die bereits echte Filme hervorgebracht hat, enthält jedoch keinen Renderer, Rekorder oder Prüfer. Verwende die Werkzeuge, die du hast; Erweiterungen beschreibt die, die es sich lohnt zu bauen. Löse Referenzpfade relativ zu diesem Fähigkeitsordner auf.

1. Wähle den Modus, dann schreibe die Kurzbeschreibung

ModusVerwendung fürLängeForm
erledigtein zusammengeführter Change oder Bugfix15–30 sEinleitungskarte → der Change in echter UI → Endkarte mit Issue oder PR
sprint-demoein Sprint-Review für Stakeholder2–4 MinSprint-Ziel → 3–5 erledigte Beats, die wertvollsten zuerst → nicht erledigt → als Nächstes
bishereine Episode eines laufenden Projekts1–3 Minletzter offener Thread → Teile: Frage → Ergebnis → was sich geändert hat → nächster Thread
forschungein Experiment, Spike oder Forschungstag1–2,5 MinFrage → Methode in einem Bild → Ergebnis mit seinem Nenner → Überraschungen → Entscheidung
releasewas ausgeliefert wurde und was als Nächstes kommt1–2,5 MinRückblickform mit den Zuständen zusammengeführt → released → Staging → Produktion
konzeptein Feature-Film, Mockup oder Vorschlag45–95 sErgebnishaken → ein durchgearbeitetes Beispiel → Beweis → ehrliche Grenze → Auszahlung
walkthroughwie man eine Aufgabe erledigt30–90 sfertiges Ergebnis → Schritte in echter UI → erneut fertiges Ergebnis
reproein Bugreport10–30 sUmgebung → Schritte → der Fehler, gehalten → erwartetes Ergebnis in Text

Modusdetails pro Modus: modi. Retrospektiven, Jubiläen und Verabschiedungen sind die Reiseerweiterung in Erweiterungen.

Vor jeder Aufnahme schreibe BRIEF.md im Filmordner: Modus, Zielgruppe, die eine Kernbotschaft, Betrachtungsbreite (Standard: ein Telefon, 844 px landscape und 390 px portrait Player), Markenprofil, die Beweiskategorie jeder Szene, Abgabetermin und Ausgaben. Frage nur nach dem, was du nicht aus der Anfrage oder den Quellen ableiten kannst.

2. Nicht verhandelbare Punkte

  • Beweise vor Kunst. Zeige echte UI, echte gespeicherte Ausgaben und echte Quellseiten. Male niemals einen Zustand, der nicht stattgefunden hat, erfinde eine Zahl oder impliziere Geschwindigkeit, Release oder Produktionseinsatz. Jede Tatsache auf dem Bildschirm hat eine Zeile in der Anspruchstabelle, bevor ihre Szene gebaut wird (Beweise).
  • Beschrifte es, was es ist, auf dem Bildschirm, die ganze Zeit. Eine Schiene außerhalb der Kamera gibt die Beweiskategorie an: Lokaler Build, Konzept-Demo · Beispieldaten, Aufgezeichnete Antwort · wiederholt, Staging, Produktion. Konzepte und Mockups geben sich niemals als ausgelieferte Funktionen aus.
  • Ergebnis zuerst. Die Kernbotschaft und eine Heldenzahl oder ein sichtbares Ergebnis landen innerhalb von etwa 1,5 s nach Szenenbeginn und bleiben bis zum Schnitt. Szenenlänge ≥ 1 s + Wörter ÷ 3 + 1,5 s Haltezeit (Taktung).
  • Lesbar auf einem Telefon. Heldentext ≥ 80 px bei 1080p; alles, was ein Betrachter lesen muss, ≥ 36 px. Zu viele Wörter: Wörter kürzen oder neu komponieren, niemals verkleinern.
  • Scharfe UI. Aufnahmen mit 2× Dichte erfassen und bei ≥ 1,0 Maßstab zeigen oder hineinzoomen. Skaliere niemals einen dichten 1080p-Bildschirm hoch und nenne es eine Nahaufnahme.
  • Nur genehmigtes Branding. Persönliches oder Firmenbranding stammt aus einem Markenprofil und den genehmigten Assets dieser Marke (Branding). Zeichne niemals ein Logo neu, färbe es um oder nähere es an.
  • Lizenzierte Musik. Musik und Effekte benötigen eine verifizierte Lizenz und die erforderliche Quellenangabe.
  • Erledigt bedeutet verifiziert. Melde technische Prüfungen, überprüfte Frames, Abspielen in voller Geschwindigkeit und Zuhören separat. Die Annahme durch den Anfragenden ist ein eigener Zustand (Review).

3. Arbeitsablauf

  1. Kurzbeschreibung und Ansprüche. BRIEF.md und die Anspruchstabelle. Für Filme mit Zahlen bitte einen unabhängigen Prüfer, idealerweise eine andere Modellfamilie oder eine Person, den endgültigen Text auf dem Bildschirm überprüfen lassen, einschließlich Text in Screenshots, vor dem vollständigen Rendern.
  2. Storyboard in Worten. Eine Zeile pro Szene: Zeitfenster, Heldenzeile, Bild, Beweisetikett, Audiohinweis, wie es übergibt. Wähle die 3–5 Übergangsarten aus, die der Film verwendet und was jede verursacht.
  3. Aufnahme (Aufnahme). Skriptgesteuerte Browserabläufe für interaktives Filmmaterial, Fake-Clock-Frame-Erfassung für die eigene Animation einer Seite, 2× Element-Screenshots für Standbilder.
  4. Komposition (Komponist). Kurze Modi eignen sich für einen spezifikationsgesteuerten Komponisten; längere Modi eignen sich für eine manuell erstellte Komposition auf einer pausierten Zeitleiste mit Szenen auf einem Balkenraster.
  5. Prüfen vor dem Rendern. Mache Schnappschüsse vom ersten lesbaren Moment jeder Szene, Mittelpunkt, späten Haltepunkt und beiden Seiten jedes Schnitts. Behebe Kollisionen, abgeschnittenen Text, leere Frames und alles, was ein Fremder nicht lesen könnte.
  6. Rendern, mischen, überprüfen. Rendere, kodiere, mische Musik und Effekte, führe die technischen Prüfungen durch, lies dann das Kontaktblatt, die Schnittstreifen und die Telefonblätter selbst (Bewegung und Ton).
  7. Liefern. Stille, Musik- und Webkopien plus ein Poster, die Musikquellenangabe neben dem Player und eine REVIEW.md: was gemessen wurde, was nur angesehen wurde und die schwächste Aufnahme.

4. Toolchain

Jeder Renderer, der Frames deterministisch produziert, ist geeignet. HyperFrames (Apache-2.0) und ein Frame-Erfassungsskript, das an FFmpeg weitergeleitet wird, rendern HTML-Kompositionen direkt. Remotion (React; überprüfe zuerst die Unternehmenslizenzbedingungen) und Motion Canvas (TypeScript-Szenen) haben eigene Szenenmodelle; der Kompositionsvertrag in Komponist übersetzt in diese. Browser-Automatisierung wie Playwright steuert die Aufnahme. FFmpeg kodiert, mischt und misst. Fixiere Renderer-Versionen und schalte Telemetrie aus, wo sie angeboten wird.

5. Autorisierung

Die Erstellung eines Films autorisiert lokale Aufnahme, Komposition und Überprüfung. Sie autorisiert keine Uploads, Nachrichten, PR- oder Issue-Kommentare, Produktänderungen oder Veröffentlichungen. Verwende Beispiel- oder genehmigte fiktive Daten; zeige niemals Client-, Kunden- oder Mitarbeiternamen ohne Genehmigung und zoome niemals in eine angemeldete Identität hinein.

Referenzen

BedarfLese
Modusprofile und Storyformenmodi
Ansprüche, Etiketten, Statuszustände, Faktencheckbeweise
Lesezeit, Textgrößen, Telefonbreitentaktung und telefon
Bewegung, Übergänge, Musik und Effektebewegung und ton
Persönliche und Firmenmarkenprofilebranding
Aufnahmetechniken und Fallstrickeaufnahme
Erledigt-Video-Spezifikation und Kompositionsvertragkomponist
Review-Stufen und Liefervorschlägereview und lieferung
Rekorder, Prüfer, Rückblicke aus einer Zeitleiste, Reisefilmeerweiterungen

Verwandte Skills