Video-Training: Storyboard zuerst, dann die echte App auf dem Bildschirm
Ein Schulungsvideo besteht hier aus einer Reihe von telefonschirmförmigen Karten. Jede Karte hat eine Überschrift, eine einzeilige Hilfe, einen Keyframe aus der echten App mit Callouts und eine Erzählzeile. Manche Karten spielen statt eines Standbilds einen kurzen Clip der App ab. Dieselben Karten werden auch als Folien und PDF ausgeliefert.
Eine Datei steuert alles: storyboard.json. Dave bearbeitet sie über einen Design-Canvas; jedes Build-Skript liest sie.
Wann verwenden
Verwenden für:
- Ein Schulungs-, Erste-Schritte-, Schnellstart- oder How-to-Video, das die App zeigt
- Annotierte Screenshots oder ein Folienguide für Techniker, Berater oder Teilemitarbeiter
- Eine Überarbeitung eines mit diesem Skill erstellten Videos (neuer Wortlaut, neue Karte, neuer Clip)
Nicht verwenden für:
- Marketing- oder Werbevideos (anderer Ton, andere Regeln; Dave fragen)
- Kundeninspektionsvideos, die innerhalb des Produkts aufgenommen wurden
- Einen Mockup eines Bildschirms, den es noch nicht gibt (
/visualverwenden)
Prinzipien
- Storyboard vor der Produktion. Nichts wird vertont oder zusammengesetzt, bis Dave den Storyboard-Canvas bearbeitet und gesagt hat, dass er fertig ist.
- Zeige die echte App, die das Echte tut. Echter Scan, echte Diktierfunktion, echte generierte Story. Niemals ein gemockter Bildschirm, niemals getippte Ergebnisse.
- Dave entscheidet auf dem Canvas, nicht im Chat. Lies den Canvas zurück und diff ihn. Baue seine Anweisungen nicht aus der Konversation nach.
- Ein genehmigter Take wird behalten. Die Erzählung wird nur für Zeilen neu generiert, deren Wörter sich geändert haben. Überschreibe niemals eine Version, die Dave überprüft hat; versende
-v2,-v3. - Claude kann nicht hören oder zusehen. Sage das bei jeder Rückgabe. Belege die Wörter durch Transkription und die Bilder durch Beispiel-Frames, und nenne, was nicht überprüft wurde.
- Hinterlasse den Store wie vorgefunden. Modus wiederhergestellt und bestätigt, Wiederholungs-Aufträge geschlossen.
Zuerst lesen
/Users/davidsonders/ro-bot/shared/product-facts.mdundshared/brand.md: Namen, Zahlen, verbotene Wörter. Keine Gedankenstriche, keine Emojis, „TenthGear“ als ein Wort. Niemals „Einzelspieler“ oder „Mehrspieler“ in etwas, das ein Zuschauer sieht oder hört.reference.mdin diesem Ordner: die technischen Fallstricke, jeder bereits einmal bezahlt.- Memory-Notizen zum Design-Canvas:
reference_design_canvas_mechanics,reference_design_canvas_roundtrip,reference_design_canvas_entity_crash.
Wo die Dinge liegen
| Was | Wo |
|---|---|
| Projektordner eines Videos | /Users/davidsonders/ro-bot/training-videos/<slug>/ (niemals das Session-Scratchpad, das mit der Session stirbt) |
| Die eine Quelle der Wahrheit | <project>/storyboard.json |
| Keyframes, Clips, Erzählung | <project>/frames/, footage/, narration/ |
| Builds | <project>/out/ |
| Was Dave erhält | ~/Desktop/<Title>/ |
| Ausgearbeitetes Beispiel | training-videos/story-writer-getting-started/ und examples/story-writer/ hier |
Skripte liegen in scripts/ hier. Sie nehmen den Projektordner als erstes Argument.
Arbeitsablauf
Erstelle eine Todo-Liste für diese Schritte und arbeite sie der Reihe nach ab.
Schritt 0: Briefing klären
Finde diese Angaben in der Anfrage. Frage nur nach dem, was fehlt, eine Frage, Empfehlung zuerst.
| Entscheiden | Standard |
|---|---|
| Wer sieht zu und in welcher Rolle | Techniker |
| Telefon oder Desktop | Telefon, 390 x 844 |
| Welcher Ablauf, Anfang bis Ende | Daves Gliederung |
| Store und Workflow-Modus | Dave fragen. Siehe Schritt 2. |
| Nur Standbilder oder Standbilder plus Clips | Clips, wo immer sich der Bildschirm bewegt: Aufnahme, Laden, Öffnen und Schließen |
| Länge | Unter 2:30 |
Schritt 1: Storyboard auf einem Design-Canvas
Das ist das Erste, was Dave sieht, und der Ort, an dem er das Skript und die Callouts bearbeitet.
-
Erstelle den Projektordner und rendere alle Props (
props/render-paper.mjserstellt den Muster-Papier-Reparaturauftrag). -
Erkunde den Ablauf nach Keyframes. Keyframes kommen aus der echten App, daher braucht dieser Schritt einen Capture-Durchlauf (Schritt 2 und Schritt 3, nur Standbilder). Kopiere
examples/story-writer/capture-stills.mjsin das Projekt und schreibe den Ablauf um. Sieh dir jeden Frame an, bevor du fortfährst. -
Entwirf
storyboard.json. Eine Karte pro Sache, die der Betrachter tut. Form:{ "id": "write-story", "part": 2, "img": "10-write-story", "title": "Tippe auf [[Story schreiben]]", "body": "Der KI-Schreiber wird deine Notizen prüfen und die 3Cs für dich schreiben.", "boxes": [[183, 400, 191, 44]], "arrow": [162, 768], "footage": { "clip": "C-write", "runs": [[15, 336]], "note": "Was der Clip zeigt" }, "narration": "Wenn du bereit bist, tippe auf Story schreiben." }boxesundarrowsind in Telefon-Pixeln; der Capture schreibt die Box jedes Steuerelements neben seinen Frame.[[Label]]zeichnet einen Button-Chip. Befolge die Stilregeln unten ab dem ersten Entwurf. -
Erstelle den Canvas. Artifact-Tool:
quickstartmit Absichtdesign, dann veröffentliche mit dertype_url, die es zurückgibt, und einem Titel. Speichere die URL in<project>/storyboard/artifact.json. -
Lade die Keyframes als Assets auf den Canvas hoch (JPEG, 1688 px hoch, im Scratchpad bereitgestellt, damit sie in einem Aufruf gehen). Notiere jede zurückgegebene
/_blob/...URL unterassetsinartifact.json, mit dem Frame-Namen als Schlüssel. -
Generieren und veröffentlichen.
node scripts/storyboard-canvas.mjs <project>schreibtstoryboard/project/. Kopiere diesen Ordner in das Scratchpad und veröffentliche ihn:canvas.jsonalsfile_path, jede.dc.htmlinfiles. -
Gib Dave den Link und halte an. Sage ihm: Tippe alle Wörter auf einer Karte neu, die blaue Notiz unter jeder Karte ist die Sprachspur, ziehe die gelben Callouts, schreibe alles andere auf eine Notiz. Starte nicht mit der Produktion.
-
Ernte seine Bearbeitungen. Artifact
readmitpaths(das Index und jedes Artboard) und einemout_dir, dannnode scripts/storyboard-harvest.mjs <project> <out_dir>. Lies ihm den Bericht in einfachen Worten vor, handle alle Notizen ab, die er hinzugefügt hat, und führe dann mit--writeerneut aus. -
Noch eine Runde? Lies
project/canvas.jsonzurück, generiere mit--live <jene Datei>neu, veröffentliche erneut. Eine Veröffentlichung, die nicht vom Live-Index ausgeht, wird abgelehnt.
Schritt 2: Einen Store ausleihen
Die App muss in dem Modus sein, den das Video zeigt. Es dürfen nur Test-Stores verwendet werden.
| Store | Id | Normalmodus | Hinweise |
|---|---|---|---|
| Summit Auto Group (Demo) | demo-dealership | Team-Workflow | Daves Interessenten-Demo. Logins [email protected] (Techniker), marcus@ (Berater), priya@ (Teile). Für das erste Video verwendet. |
| Test Dealership 1 | mlTaPo12wbpUtJB9GXJM | Team-Workflow | Mit Build-Sessions geteilt. Oft ausgelastet. |
ListAgents, dannSendMessagean jeden Peer: Nutzt es den Store und braucht es den Modus? Warte auf die Antwort. Wenn ein Peer ihn braucht, verwende den anderen Store oder frage Dave.- Lies zuerst den Modus aus:
NODE_OPTIONS='-r dotenv/config' npm run --silent manage-org -- info <id>aus dem App-Ordner. - Ändere ihn nur für die Minuten, die ein Capture läuft, in derselben Befehlskette wie der Capture und die Wiederherstellung. Lies ihn dann erneut aus und bestätige.
- Berühre niemals einen Kunden-Store. Ändere niemals die Einstellungen eines Testkontos.
Schritt 3: Capture
- Standbilder:
dpr: 3. Ein Frame pro Karte, aufgenommen nachdem sich der Bildschirm beruhigt hat. - Clips:
dpr: 2mitvt.recorder. Öffne jeden Clip mit einem Schlag der Ruhe, zeige den Fingermarker, dann handle. Liesmarks.json, umfootage.runsauszuwählen. - Diktat ist echt.
vt.dictationspielt einen gesprochenen Clip in ein Fake-Mikrofon; die App zeichnet auf und transkribiert ihn. Drucke jedes Transkript und lies es: Der Transkribierer schreibt Zahlen und Markennamen um. - Ein Wiederholungsdurchlauf braucht einen frischen Reparaturauftrag. Nummeriere sie aufwärts und liste jede ID in
created-ros.txt.
Schritt 4: Folien
node scripts/build-slides.mjs <project> schreibt out/slides/*.png, das PDF und die Ebenen, die das Video braucht. Sieh dir ein Kontaktblatt jeder Karte an. Prüfe, dass kein Callout das bedeckt, worauf es zeigt.
Schritt 5: Erzählung
cd /Users/davidsonders/ro-bot/app
NODE_OPTIONS='-r dotenv/config' node ~/.claude/skills/video-training/scripts/narrate.mjs <project>
Stimme ash, Modell gpt-audio-1.5 (verschoben von gpt-4o-mini-tts, das OpenAI am 06.01.2027 abschaltet). Ein Take, dessen Transkript nicht mit den Karten-Wörtern übereinstimmt, wird wiederholt, dann verweigert. Dave hat diese Stimme genehmigt und die eingebauten Mac-Stimmen als robotisch abgelehnt. Es verwendet den OpenAI-Schlüssel der App und kostet ein paar Cent pro Build: Sage das im Briefing für jedes neue Video, damit die Ausgaben nie überraschen. DRY=1 listet, was neu generiert würde.
Schreibe die Erzählung für das Ohr: „R O“, „drei Cs“, „tenthgear punkt A I“. Kündige jeden Teil auf seiner ersten Karte an.
Schritt 6: Video
node scripts/build-video.mjs <project>. Geschwindigkeit ist 1.25 (QuickTimes „Schnell“), das Tempo, das Dave genehmigt hat. Eine Karte mit einem Clip läuft so lange wie die längere ihrer Erzählung und ihres Clips.
Schritt 7: Verifizieren und sagen, was nicht verifiziert wurde
check-audio.mjstranskribiert das Video und bewertet jede Karte. Lies jedeLOOK-Zeile.- Ziehe einen Frame aus jeder Karte, die einen Clip oder einen Pfeil hat, und sieh ihn dir an.
- Gib bei der Rückgabe klar an: nicht angehört, nicht bis zum Ende angesehen.
Schritt 8: Ausliefern
Kopiere das Video, das PDF und out/slides/ nach ~/Desktop/<Title>/. Behalte frühere Versionen. Gib die Länge an, was geändert wurde und was Dave auffallen könnte (eine andere Reparaturauftragsnummer in einem Clip, ein Callout, das über Footage gefallen ist).
Schritt 9: Aufräumen
- Store-Modus wiederhergestellt, dann zurückgelesen und bestätigt.
node scripts/close-ros.mjs <project> <email> <org-id>schließt die Wiederholungen. Das Löschen von Reparaturaufträgen ist Daves Entscheidung.- Teile jedem Peer, dem du eine Nachricht geschickt hast, mit, dass der Store frei ist.
Stilregeln (Dave, 2026-09-29)
| Regel | Beispiel |
|---|---|
| Ein Button, den der Betrachter tippt, wird als Button gezeichnet | Tippe auf [[Neuer RO]] |
| Teil-Überschriften sind kurz, ohne „von 3“ | TEIL 2: GARANTIE-STORY |
| Das Cover hat keine Schrittanzahl | |
| Eine Karte pro Schritt. Karten zusammenführen, die eine Entscheidung zeigen. | Überprüfen und speichern sind eine Karte |
| Eine Karte fallen lassen, deren Punkt selbsterklärend ist | Ursache und Korrektur lesen |
| Sage, wer handelt und womit | „Eine Sprachnotiz hinzufügen“, nicht „Eine Notiz hinzufügen“ |
| Wenn zwei Dinge auf dem Bildschirm gemeint sein könnten, zeige auf das eine | Pfeil auf den grünen Button |
| Alles, was sich in der App bewegt, sollte sich im Video bewegen | Wellenform, Spinner, Karte beim Öffnen |
| Werkstatt-Wörter | RO, Zeile, Story, 3Cs, CP |
Dave gibt Folienbearbeitungen nach PDF-Seitennummer. Seite 1 ist das Cover, also ist „S. 7“ Schritt 6. Gib jede Bearbeitung mit Schrittnamen an, bevor du sie anwendest.
Erfolgskriterien
- Dave hat den Storyboard-Canvas bearbeitet und seine Bearbeitungen wurden geerntet, nicht geraten
- Jeder Frame und Clip ist die echte App, in dem Modus, um den es im Video geht
- Folien, PDF und Video stammen alle aus derselben
storyboard.json - Erzählung per Transkription geprüft; unklare Zeilen benannt
- Die Rückgabe sagt, was nicht angehört oder angesehen wurde
- Store-Modus wiederhergestellt und bestätigt; Wiederholungs-Aufträge geschlossen
- Projektordner außerhalb des Scratchpads behalten
Verwandte Skills
/visualfür Mockups von Bildschirmen, die es noch nicht gibt/app-testingfür die Testkonten und den Live-Pass-Harness, den dieses Skill ausleiht/compounddanach, wenn ein Capture einen Produktfehler oder eine neue Falle aufgedeckt hat