Studio-Initialisierung (Kursschritt 02)
Erstelle ein Filmprojekt, das seine eigenen Bilder rendern, anhören und betrachten kann. Die Chat-App kann eine Animation schreiben; nur ein Agent mit einer Shell kann den Render schließen, schauen und die Schleife korrigieren. Diese Schleife ist der Unterschied zwischen einem „mittelmäßigen“ ersten Versuch und einem Film, der es wert ist, veröffentlicht zu werden.
Anforderungsargumente (können leer sein), einmal angezeigt:
1. Wähle das Verzeichnis und die Einstellungen
- Verzeichnis: das erste Argument; sonst
., wenn das Arbeitsverzeichnis leer ist; sonst frage (Standard./<slug-des-titels>). Niemals in das Plugin-Verzeichnis gerüsten. - Einstellungen aus der Anforderung: Titel, Dauer, Formate, FPS, BPM, Schleife, Marken-URL. Den Rest auf die Vorlagenstandards setzen (
studio.json: 12 s, 60 fps, 4 Unterbilder, 120 BPM,9x16primär).
2. Gerüst
npm install -g "${CLAUDE_SKILL_DIR}/scripts/init.mjs" <verz> --title "<Titel>" [--duration S] [--fps N] [--bpm N] [--formats a,b] [--loop] [--brand-url URL] [--install] [--json]
| Flag | Wirkung |
|---|---|
<verz> | Ziel; wird erstellt, falls nicht vorhanden |
--title T | studio.json Titel und Slug der Lieferdatei |
--duration S, --fps N, --bpm N | Zeitsteuerung |
--formats a,b | Teilmenge von 9x16, 1x1, 16x9, 4x5 (oder all); primaryFormat bleibt, es sei denn, es ist nicht aufgeführt |
--loop | Nahtlose Schleife (UI-Morphs) |
--brand-url URL | Speichert die Produkt-URL in brand.url. user:password@ und geheimnisaussehende Parameter (query, ;matrix, fragment: token, key, secret, password, auth, sig, session, code ...) werden entfernt, bevor etwas geschrieben wird; stderr nennt, was entfernt wurde und --json listet es in redacted. Gib trotzdem eine einfache öffentliche URL an: ein Geheimnis, das ein bloßer Pfadabschnitt ist (/reset/<token>), kann nicht erkannt werden. Eine einfache URL wird genau so gespeichert, wie sie eingegeben wurde |
--install | führt npm install im neuen Projekt aus (handhabt npm.cmd unter Windows) |
--force | aktualisiert ein älteres Projekt auf die aktuelle Vorlage (siehe Tabelle unten) |
--json | eine JSON-Ergebniszeile auf stdout |
Ein vorhandenes nicht leeres Verzeichnis wird zusammengeführt: nur fehlende Dateien werden hinzugefügt und übersprungene Dateien werden aufgelistet. Melde die übersprungene Liste dem Benutzer; lösche niemals seine Dateien.
--force bei einem vorhandenen Projekt (geprüft gegen init.mjs):
| Pfad | Mit --force |
|---|---|
studio.json, film/**, docs/**, assets/fonts/fonts.json | behalten und als kept aufgelistet; eine fehlende wird trotzdem erstellt. Flags wie --bpm patchen weiterhin studio.json |
package.json | zusammengeführt, nie ersetzt: setzt type: module, fügt private, engines und jedes Vorlagenskript oder jede Abhängigkeit hinzu, die dem Projekt fehlt. Ein Vorlagenskript, dessen Befehl abweicht, wird auf den Vorlagenbefehl zurückgesetzt (init gibt jedes als was ..., now ... aus und gibt sie in packageReset zurück). Abhängigkeitsversionen werden nie geändert, auch nicht Vorlagenabhängigkeiten: ein vorhandener Bereich bleibt bestehen, neuere, ältere oder festgeschriebene. Name, Version, andere Skripte und andere Felder bleiben erhalten |
.gitignore | zusammengeführt: fehlende Vorlagenzeilen werden unter # motion-studio angehängt, nichts wird entfernt |
alles andere (CLAUDE.md, lib/**, tools/**, prompts/**, index.html, .env.example, gebündelte Schriftarten) | überschrieben und als overwritten aufgelistet. Lokale Bearbeitungen dieser Dateien gehen verloren: committe oder kopiere sie zuerst |
| deine eigenen zusätzlichen Dateien | unberührt |
Ohne --force werden package.json und .gitignore auf die gleiche Weise zusammengeführt, außer dass ein abweichendes Skript deinen Befehl behält. Init listet jedes Skript und jede Abhängigkeitsversion, die von der Vorlage abweicht, unter kept your package.json values, which differ from the template auf (packageKept im --json-Ergebnis): diese npm run-Namen führen DEINEN Befehl aus, und --force setzt Vorlagenskripte zurück (niemals Abhängigkeitsversionen). Ein scripts-, devDependencies- oder optionalDependencies-Abschnitt, der kein Objekt ist, wird mit einer Warnung unverändert gelassen. Da docs/** behalten wird, erreicht eine neuere Vorlagendokumentation nie ein vorhandenes Projekt: vergleiche nach einem Update manuell mit dem template/docs/ des Plugins.
3. Installation, Browser, Arztlauf
- Ohne
--install, führenpm installim Projekt aus.playwrightist die einzige erforderliche Abhängigkeit;ffmpeg-staticist optional und kann hinter einem Proxy beim Herunterladen fehlschlagen. - Browser (
npm run setup:browserist derselbe Befehl wie dienpx-Zeile):- Windows: führe
npx playwright install chromium-headless-shellaus (ca. 115 MB Download, 270 MB auf der Festplatte).studio.jsonbrowser: "auto"startet nur diese gebündelte Headless-Shell, niemals das installierte Chrome oder Edge. Grund: Ein installiertes Chrome oder Edge, das mit einem neuen Profil (bei jedem Tool-Lauf) gestartet wird, veranlasst Chrome, das Windows-Konto auf ein leeres Passwort zu testen, was als fehlgeschlagene Anmeldung zählt. Der gemessene Laptop sperrt das Konto nach 10 fehlgeschlagenen Anmeldungen in 10 Minuten und protokollierte 464 in 24 h. Wechslebrowsernicht aufchromeodermsedgeund setzeMOTION_CHROME_PATHnicht auf einechrome.exeodermsedge.exe, es sei denn, der Benutzer fragt danach und akzeptiert das Risiko: es gibt eine Warnung pro Start aus und der 4. Start in 10 Minuten wird verweigert, 3 passieren (der Startschutz). Die Shell ist nicht signiert, daher kann eine Echtzeit-Antivirensoftware jeden Tool-Lauf um 15 bis 25 s verlangsamen (gemessen): teile dem Benutzer dies einmal mit; ein Antivirenausschluss für%LOCALAPPDATA%\ms-playwrightist seine oder die Entscheidung der IT. - macOS und Linux:
autoversucht das installierte Chrome, dann Edge, dann den gebündelten Browser, ohne Warnung. Wenn keines installiert ist, führenpx playwright install chromium-headless-shellaus (Linux:npx playwright install --with-deps chromium-headless-shell), oder setzeMOTION_CHROME_PATHauf eine ausführbare Datei der Chromium-Familie.
- Windows: führe
npm run doctor. Behebe jede FEHLER-Zeile vor der Übergabe und unter Windows auch eine WARN-Browser-Zeile (ein installiertes Chrome oder Edge wurde ausgewählt: lösche es und installiere die Headless-Shell); Korrekturen pro Betriebssystem findest du in references/troubleshooting.md. Python mit librosa ist optional (die JS-Beat-Engine deckt es ab). Node 22+ wird nur für Route-B-Tools benötigt.- Beweise es:
npm run stills, öffne dannout/review/9x16/contact.png(ein langer Film wird seitenweise ausgegeben:contact.pngist Seite 1, danncontact-2.png..., keine Seite höher als 1800 px; öffne jede Seite) und schaue es dir an. Die mitgelieferte 12-s-Demo muss ein zusammengesetztes Bild bei 0 s und eine Änderung bei jedem Downbeat zeigen.npm run previewöffnet die Live-Vorschau (Leertaste Abspielen/Pause, Pfeile Einzelbildschritte, F wechselt Formate, G Safe-Area-Richtlinien).
4. Erkläre das Projekt dem Benutzer
Fasse es in ein paar Zeilen zusammen und verweise dann auf die Referenzen:
- Layout und wer was bearbeitet: references/project-layout.md
- Jeder Befehl: references/commands.md
- Jede
lib/-Signatur und Standardeinstellung:docs/API.mdim neuen Projekt (die vollständige Referenz istdocs/ARCHITECTURE.mdim Plugin-Repository) - Die Hausregeln stehen in der
CLAUDE.mddes Projekts, die Claude Code bei jedem Lauf dort liest.
Wenn init eine ★ Sternzeile gedruckt hat (starHint im --json-Ergebnis; sie erscheint einmal pro Maschine, beim ersten neuen Projekt), beende deine Zusammenfassung mit dieser einen Zeile, wie sie geschrieben wurde. Gib niemals das Repository oder führe gh für den Benutzer aus.
| Befehl | Tut |
|---|---|
npm run preview | Live-Vorschau im Browser |
npm run stills | ein Standbild pro Beat als Kontaktbogen |
npm run critique | Kontakt, Streifen, Telefontest, Metriken, Review-Log-Block |
npm run gate | Kritik-Gate: 3 Runden, alle Achsen >= 8, kein P0 |
npm run render:final | jedes Format, endgültige Qualität (Gate erzwungen) |
npm run sfx / npm run mix | Cue-SFX synthetisieren / auf -14 LUFS mischen und muxen |
npm run deliver | Lieferprüfungen und out/deliver/-Paket |
npm run build | Partitur, falls fehlend, SFX, finaler Render, Mix, Lieferung |
5. Aufwand und Routen
| Arbeit | Aufwand | Einstellen mit |
|---|---|---|
| kleine Korrekturen, Neu-Render | mittel | /effort medium |
| ein neuer Film | sehr hoch | /effort xhigh (der motion-reel-Skill setzt es für dich) |
| Flaggschiff erste 3 Sekunden eines Starts | maximal | /effort max |
/model bietet auch die Aufwandswahl bei der Auswahl von Opus 5.5. Route A (diese Engine) ist die Standardeinstellung. Verwende Remotion oder HyperFrames nur, wenn der Benutzer eines nennt; /motion-studio:seek-engine hat die Übergabe, einschließlich der Remotion-Lizenzschranke.
6. Schlüssel
Kopiere .env.example nur dann nach .env, wenn ein Schlüssel benötigt wird (Sprache: ELEVENLABS_API_KEY; Route-C-Bilder/Video: FAL_KEY). Sage dem Benutzer, er solle den Wert selbst in .env einfügen. Verweise in Eingabeaufforderungen und Protokollen nur auf den Variablennamen. .env ist bereits im .gitignore des Projekts.
7. Optionale Begleiter
Erwähne diese nur, wenn sie relevant sind. Installationsbefehle und Hinweise: references/companions.md.
| Begleiter | Verwende für | Hinweis |
|---|---|---|
| claude-animation (buildwithhanif) | handgezeichnet, Pinsel, Märchenbuch-Optik | MIT; separater Node-Canvas-Renderer |
| HyperFrames (heygen-com) | HTML + GSAP-Kompositionen | Apache-2.0; Node 22+ |
| Remotion | React-Serien und -Vorlagen | Unternehmenslizenz für gewinnorientierte Organisationen mit über 3 Mitarbeitern |
Nächstes: Teste die Engine mit /motion-studio:showreel oder erstelle einen echten Film mit /motion-studio:motion-reel.