Communitygithub.com

video-shotcraft: Filmische Produktvideos erstellen

Erstelle kinoreife Produktvideos aus Shot-Rezeptkarten, einer validierten Vorlage und Code-/Audio-Assets (Remotion + echte Seiten-Screenshots + 2,5D-Kamerafahrten + beat-synchrone Schnitte + Sounddesign).

Was ist video-shotcraft: Filmische Produktvideos erstellen?

video-shotcraft ist eine umfassende Skill-Bibliothek zur Erstellung von Produktvideos mit Kinofeeling. Sie enthält 157 Shot-Rezeptkarten (mit Demo-Implementierungscode und einer dynamischen Sample-Galerie), eine validierte vollständige Werbevideo-Vorlage, wiederverwendbare Komponenten und Audio-Assets sowie einen sechsstufigen Workflow. Der Fokus liegt auf Web- und Desktop-Produktvideos, die Shot-Karten selbst sind universell für Einzel-Shots in beliebigen Videos einsetzbar. Der Skill unterscheidet drei Modi: direkte Nutzung der Vorlage (Ink Press), autonome freie Erstellung (der Agent entscheidet alle kreativen und technischen Aspekte) und gemeinsame Erstellung (schrittweise Freigabe durch den Nutzer). Er unterstützt Remotion als Render-Engine und beinhaltet Funktionen wie 2,5D-Kamerafahrten, Beat-Synchronisation, Sounddesign und die Erstellung von CapCut-Projektdateien.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/OXYGEN-CRO/adam-robinson-content-engine/tree/HEAD/raw/sources/2026-09-08-motion-quality/sources/Vincentwei1021--video-shotcraft

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht video-shotcraft: Filmische Produktvideos erstellen?

Eine eigenständige Produktionsbibliothek: 157 Shot-Rezeptkarten (mit Demo-Implementierungscode und dynamischer Sample-Galerie), eine validierte vollständige Werbevideo-Vorlage, wiederverwendbare Komponenten und Audio-Assets, sechsstufiger Workflow. Der aktuelle Fokus liegt auf Web-/Desktop-Produktwerbevideos, aber die Shot-Karten selbst sind ein universelles Bewegungsvokabular – sie können auch einzeln für beliebige Shots in anderen Videos verwendet werden.

Vor dem Aufruf: Modus bestimmen

Es gibt drei sich gegenseitig ausschließende Modi für vollständige Werbevideos. Bevor du mit der Materialerfassung, dem Storyboard oder der Implementierung beginnst, prüfe, ob der Nutzer bereits eine eindeutige Wahl getroffen hat; wenn ja, führe direkt aus, ohne erneut zu fragen oder in einen anderen Modus zu wechseln.

  1. Direkte Vorlagennutzung: Behalte den bestehenden Ink Press-Ablauf bei. Lese template/TEMPLATE.md und ersetze Screenshots, Text und Markeninformationen des Zielprodukts gemäß der bestehenden Shot-Struktur.
  2. Autonome freie Erstellung: Lese references/pipeline.md. Der Agent entscheidet basierend auf den Anforderungen des Nutzers und dem Projektinhalt selbstständig über visuelle Richtung, Shot-Mapping, Storyboard, Material und Audio und arbeitet kontinuierlich bis zum fertigen Video; unterbricht nicht in den Phasen Produkt-Briefing, Styleframe, Shot-Mapping oder Storyboard, um auf die Bestätigung des Nutzers zu warten.
  3. Gemeinsame Erstellung: Lese references/guided-free-creation.md. Der Agent legt zunächst fundierte Einschätzungen und Pläne vor, die vom Nutzer nacheinander für Produkt-Briefing, Anforderungsentscheidungen, visuelle Richtung, Shot-Mapping und endgültiges Storyboard bestätigt werden; nach Freigabe des Storyboards geht es in die finale Materialerfassung und Produktion gemäß references/pipeline.md.

Wenn der Nutzer einen Projektpfad, eine URL, einen Screencast oder Screenshots bereitgestellt hat, aber noch keinen Modus gewählt hat, führe zunächst eine minimale, schreibgeschützte Produktprüfung durch: Verstehe die Produktpositionierung, Hauptfunktionen, visuelle Gestaltung der Seite, darstellbare Zustände und Materialrisiken; ändere das Geschäftsprojekt nicht, sammle keine sensiblen Daten und schreibe keinen Videocode. Gib nach der Prüfung die drei Modi an und erkläre:

  • Ob Ink Press für das Produkt geeignet ist, mit spezifischen Gründen für und wider;
  • Ob autonome freie Erstellung und gemeinsame Erstellung jeweils geeignet sind und welche visuellen Hinweise des Produkts voraussichtlich erhalten bleiben;
  • Welchen Modus der Agent empfiehlt, mit Begründung und Abwägung.

Frage dann explizit: „Basierend auf der obigen Produktprüfung empfehle ich den Modus ××. Soll es in diesem Modus weitergehen?“ Informiere den Nutzer gleichzeitig, dass er unter https://vincentwei1021.github.io/video-shotcraft/ die dynamischen Samples durchstöbern und Bewegungsshots auswählen kann, die im Video verwendet werden sollen.

Wenn der Nutzer noch kein prüfbares Projekt oder keine prüfbare Seite bereitgestellt hat, stelle die drei Modi kurz vor und frage dann; empfehle nicht automatisch Ink Press, nur weil es eine fertige Vorlage ist.

  • Nutzer wählt Vorlage: Vollständig template/TEMPLATE.md lesen, nach dem ursprünglichen Vorlagenablauf ausführen.
  • Nutzer wählt autonome freie Erstellung: Vollständig references/pipeline.md lesen, Agent arbeitet autonom, wartet nicht auf Bestätigung pro Phase.
  • Nutzer wählt gemeinsame Erstellung: Vollständig references/guided-free-creation.md lesen, gemäß den dortigen Bestätigungspunkten zusammenarbeiten.
  • Nutzer hat sich noch nicht entschieden: An dieser Stelle pausieren und auf die Wahl warten; nicht standardmäßig für den Nutzer entscheiden oder mit der Produktion beginnen.

Ausnahme 1: Wenn der Nutzer explizit die Ink Press-Vorlage genannt hat, gilt der Vorlagenmodus als ausgewählt. Zum Beispiel „Erstelle mit der Ink Press-Vorlage ein Werbevideo für mein Produkt“. Frage dann nicht erneut, lese direkt template/TEMPLATE.md vollständig und führe nach der Vorlagenroute aus.

Ausnahme 2: Wenn der Nutzer explizit bestimmte Shot-Karten verwenden oder als Referenz nutzen möchte, sind die Shot-Einschränkungen bereits festgelegt. Zum Beispiel „Verwende deck-deal-flyin und row-embed für dieses Video“ oder „Beziehe mich auf den Effekt von spotlight-hero-card“. Stelle dann die Vorlage nicht vor und frage nicht, ob die Vorlage verwendet werden soll; bestätige die angegebenen Shots gemäß den Gallery-Namensauflösungsregeln, lese jede Karte vollständig und lokalisiere den genauen Demo-Quellcode gemäß der „Referenzimplementierung“ der Karte. Einzel-Shots können nach Festlegung des Zielmaterials ausgeführt werden; für ein vollständiges Werbevideo, wenn noch nicht angegeben wurde, ob die autonome freie Erstellung oder die gemeinsame Erstellung verwendet wird, frage nur nach diesen beiden Modi, wobei die angegebenen Shots als spätere Produktionseinschränkungen dienen und nicht automatisch der gemeinsamen Erstellung gleichgesetzt werden.

Vier Verwendungsmöglichkeiten

  1. Vollständiges Werbevideo (Vorlagen-Route): Wenn ein dem Vorlagen-Video sehr ähnlicher Effekt gewünscht ist → lese template/TEMPLATE.md, befolge die „Anleitung zur Produktwiederholung“ und passe Material Shot für Shot an.
  2. Vollständiges Werbevideo (autonome freie Erstellung): Wenn ein neuer Stil gewünscht wird und der Agent die Entscheidungsfreiheit erhält → lese references/pipeline.md, arbeite vom Produktverständnis kontinuierlich bis zur Endkontrolle, ohne zwischendurch auf Bestätigung pro Phase zu warten.
  3. Vollständiges Werbevideo (gemeinsame Erstellung): Wenn der Nutzer an wichtigen Entscheidungen beteiligt sein möchte → lese references/guided-free-creation.md, bestätige Produkt-Briefing, Anforderungsentscheidungen, visuelle Richtung, Shot-Mapping und endgültiges Storyboard; nach Freigabe fahre mit der finalen Materialerfassung aus der Pipeline fort.
  4. Einzel-Shot/Einzel-Effekt: Wähle eine Karte aus references/shots/ (oder lass den Nutzer in der gallery/-Galerie wählen), lese den gesamten Karteninhalt und lokalisiere den genauen Demo-Quellcode gemäß der „Referenzimplementierung“, passe ihn an das Zielmaterial an.

Grenzen zwischen autonomer freier Erstellung und gemeinsamer Erstellung

Bei der autonomen freien Erstellung werden kreative und technische Entscheidungen an den Agenten delegiert. Der Agent leitet dynamisch aus dem Projektinhalt die Produktschwerpunkte, die visuelle Richtung, das Shot-Mapping, das Storyboard, die Materialbearbeitung und den Audio-Plan ab, dokumentiert die wichtigsten Entscheidungen und führt sie direkt aus; es sei denn, es fehlen notwendige Eingaben, die nicht sicher abgeleitet werden können – dann wird nicht gefragt, nicht pro Phase pausiert und keine Zwischenergebnisse zur Bestätigung vorgelegt. Explizite Anforderungen des Nutzers bleiben stets verbindlich und dürfen nicht durch die Standardwahl des Agenten überschrieben werden.

Die gemeinsame Erstellung verwendet die schrittweise Bestätigung. Standardmäßig wird references/guided-free-creation.md gelesen, pro Runde werden nur 1–3 Fragen gestellt, die am ehesten Nacharbeit vermeiden, und an den Punkten Produkt-Briefing, Anforderungsentscheidungen, visuelle Richtung, Shot-Mapping und endgültiges Storyboard wird pausiert, um auf die Bestätigung des Nutzers zu warten. Der Nutzer bestätigt die geschäftlichen und kreativen Richtungen; der Agent erledigt autonom die Erfassungsmethode, Implementierungsparameter, SFX-Frame-Hooks, das Remotion-Projekt, das Rendering und die technische Qualitätssicherung.

Wenn der Nutzer während der gemeinsamen Erstellung explizit sagt „Entscheide du alles“ oder „Überspringe die Bestätigung und mach einfach“, wechsle in die autonome freie Erstellung und dokumentiere diese Wahl; behaupte nicht, autonom zu arbeiten, während du weiterhin schrittweise Bestätigung verlangst.

Das Mapping von Funktionen zu Shots ist nur „welche Bewegungsgrammatik wird verwendet“, kein vollständiges Storyboard. Nach Bestätigung des Mappings in der gemeinsamen Erstellung muss der Agent weiterhin die Shot-Reihenfolge, -Dauer, konkrete Bilder, Seitenzustände, Materialquellen, Untertitel, Übergänge und SFX angeben; erst nach Bestätigung des vollständigen Storyboards geht es in die finale Materialerfassung. Wenn der Nutzer Shot-Namen aus der Galerie kopiert, reicht die Angabe des Kartennamens oder „Kartenname · Stilname“; der Agent liest die lokalen Rezeptkarten und den Demo-Quellcode.

Kernprinzipien

  1. Für die Nachbildung bestehender Seiten müssen echte Screenshots verwendet werden; handgebaute UI ist auf Nicht-Nachbildungsszenarien beschränkt, wobei Qualität und Ausdrucksklarheit harte Grenzen sind. Starte für die Darstellung echter Produktseiten sofort einen lokalen dev server, verwende einen Headless-Browser, um die gesamte Seite als 2x-Textur zu erfassen, einschließlich elementweisem Freistellen und einer layout.json-Koordinatentabelle. In Nicht-Nachbildungsszenarien (abstrakter Einstieg/ Branding/ separate Demonstrationskomponenten) ist handgebaute UI erlaubt, aber wenn sie nicht veröffentlichungsreif ist oder der Betrachter nicht versteht, was sie ausdrückt, kehre zur Screenshot-Route zurück. Seitenmaterialien werden nach Risiko behandelt: Öffentliche Demodaten dürfen nur nach expliziter Bestätigung im Produkt-Briefing beibehalten werden; Kunden-, persönliche, interne, Schlüssel-, Echtzeit- oder andere sensible Daten müssen durch fiktive oder anonymisierte Inhalte ersetzt werden, und die Erfassung muss vorher eingefroren werden.

  2. Die visuelle Sprache des gesamten Videos muss aus dem Produkt selbst erwachsen, nicht aus einem nicht zusammenhängenden „Werbevideo-Skin“. Extrahiere und dokumentiere vor der Erstellung des Styleframes aus dem Designsystem, Quellcode oder den berechneten Styles des Produkts/der Website ein Design-Spec: Schriftfamilie und -stärke, Schriftgrößen-Hierarchie, Zeilenabstand/Laufweite, Raster, Abstände, Ausrichtung, Informationsdichte und Eckenradien sowie Hintergrund-/Oberflächen-/Text-/Akzent-/Statusfarben, Verläufe und Texturen. Alle Titel, Untertitel, Zahlen, Textkarten, Typografie, Übergänge, Partikel, Lichteffekte und andere Bewegungseffekte im Video müssen dieses Token-System wiederverwenden oder zurückhaltend erweitern und gleichzeitig den Ton, den Geschmack und die Textur des Produkts treffen. Bei der Verwendung der Vorlage oder der Shot-Karten-Route werden nur die Shot-Struktur, Bewegungsgrammatik, der Rhythmus und die abgestimmten Parameter übernommen; Schriftart, Layout, Farbschema und Textur müssen entsprechend dem Zielprodukt neu angepasst werden. Wenn die narrative Notwendigkeit eine Abweichung von der Produktvisualität erfordert, erkläre bei der gemeinsamen Erstellung den Grund und lass den Nutzer bestätigen; bei der autonomen freien Erstellung dokumentiere den Grund und die Abwägungen im Design-Spec und fahre fort.

  3. Kinofeeling entsteht durch das Zusammenspiel von Kameraführung, Licht, Rhythmus und Ton, nicht durch Effekthascherei. Was wiederholt geschätzt wurde: vollständige Bewegungsbögen eines einzelnen Protagonisten (Spotlight auf → Heranzoomen → Schweben → Rückkehr), durch physikalische Metaphern getriebene Beschleunigung (Karten austeilen), orbitale Close-ups mit seitlicher Kamera, rhythmische Satzstrukturen wie riser → impact → sparkle. Massenhafte Elementeinfügungen leben von der Bewegung selbst, nicht von einzelnem Aufleuchten – dekorative Glanz-/Lichtmassen wirken billig, einzelne hochwertige Lichteffekte sind in Ordnung.

  4. Jeder Shot erzählt nur einen Bewegungseffekt; nachdem die Schlüsselinformation gesetzt ist, muss geatmet werden. Eine Animationsmethode (Einfliegen/Stapeln/Umblättern) wird im gesamten Video nur einmal als Hauptakteur verwendet; wiederholte Shots und wiederholte Taglines werden gestrichen. Der Rhythmus ist einseitig: Das gesamte Feedback tendiert zu „langsamer/verweilen“, nie einmal „zu langsam“ – Marken-Logos halten nach dem Setzen ≥1s, am Ende von Masseneffekten gibt es 0,5s Ruhe, die Hauptaktion des Openings bekommt genügend 3s. Plane beim Timing von vornherein Budget für Hold/Rest ein.

  5. Bei Videos mit stark rhythmischer Hintergrundmusik müssen alle Übergänge und Effekte auf den Beat passen. Wenn der Nutzer die Musik bereits ausgewählt hat → führe vor Arbeitsbeginn eine Rhythmusanalyse durch (librosa-Rasteranpassung für echten BPM/Phase + Kick/Snare/Hi-Hat-Dreiklassenschlagzeug-Lokalisierung), bestätige das Raster erst nach Bestätigung der Transientenabdeckung, dann erstelle das Storyboard; die Timeline wird mit Taktangaben beatF(n) geschrieben, spärliche Akzente werden an echte Transienten geheftet, nicht an Rasterinterpolationspunkte, und nach dem Rendern wird die Audiospur des fertigen Videos extrahiert, um die Schnittfehler ≤3f zu überprüfen. Die Beat-Synchronisation betrifft den Zeitpunkt, nicht die Amplitude – Beat-Impacts, die auf der gesamten Bildebene/Kameraebene wirken, gelten als große Slams, maximal 3 im gesamten Video (aesthetic-rules R4); andere Beat-Effekte bewegen nur die Elementebene. Methodik siehe references/music-beat-sync.md. Videos mit BGM werden standardmäßig in zwei Versionen geliefert: mit BGM und ohne BGM (mit SFX), über die bgm inputProp aus derselben Timeline gerendert, damit der Nutzer später eigene Musik hinzufügen kann.

  6. Bevor Shot-Karten-Effekte verwendet werden, muss der Gallery-Index analysiert und der genaue Demo-Implementierungscode gelesen werden. Überprüfe zuerst den Kartennamen und den style-key mit gallery/api/library.json, dann lokalisiere das spezifische TSX gemäß der „Referenzimplementierung“ im Karten-Dokument. Die Rezeptkarten liefern Semantik und Parametertabellen; der genaue Demo-Quellcode ist die Wahrheit der abgestimmten Parameter (Easing, Zeitverhältnisse, Timing von Maskenaufhebungen, bekannte Fallstricke und deren Umgehung). Anpassungen sind erlaubt, aber die in der Karte als „bekannte Fallstricke/kritische Punkte“ markierten Parameter dürfen nicht herabgestuft werden – die Qualitätsstandards dürfen nur steigen, nicht fallen. Eine Neuimplementierung nur basierend auf dem Kartennamen und Verständnis bedeutet, die gesamte Abstimmungsarbeit aufzugeben.

  7. Die gemeinsame Erstellung priorisiert billige Bestätigungen, die autonome freie Erstellung dokumentiert dieselben Entscheidungen als Ausführungsnachweis. Die Reihenfolge Produkt-Briefing → Entscheidungstabelle von Anforderungen zur Ausführung → Textrichtung → Styleframe → Shot-Mapping → Storyboard bleibt gleich; bei der gemeinsamen Erstellung wird sie dem Nutzer schrittweise zur Bestätigung vorgelegt, bei der autonomen freien Erstellung wird sie vom Agenten autonom ausgewählt und kontinuierlich vorangetrieben. Keiner der beiden Modi sollte in die Shot-für-Shot-Implementierung einsteigen, bevor die Richtung festgelegt ist.

  8. Kontrolle während des gesamten Prozesses + unabhängige Prüfung vor Auslieferung. Ab Phase 5 wird jeder Shot mit npx remotion still als Standbild zur Selbstkontrolle ausgegeben, nach jeder Änderungsrunde wird das gesamte Video gerendert und mit ffmpeg Einzelbilder extrahiert zur Durchsicht; vor der Auslieferung muss ein Sub-Agent mit sauberem Kontext eine unabhängige Endkontrolle durchführen. Die Prüfungseingabe umfasst das fertige Video, Schlüsselbilder, das Produkt-Briefing, die Entscheidungstabelle von Anforderungen zur Ausführung, die im aktuellen Modus bestätigte oder dokumentierte visuelle Richtung/das Styleframe, das Funktion-zu-Shot-Mapping, die Gallery-Kartennamen/Varianten, den genauen Demo-TSX, die Gallery-Referenz-Samples/Einzelbilder, das endgültige Storyboard, die ausgewählten Shot-Karten und die ästhetischen Regeln; überprüfe gemäß references/final-review.md gleichzeitig die Konsistenz des Konzepts, die funktionale Vollständigkeit, die Genauigkeit der Shot-Umsetzung, die visuelle/audiotechnische Qualität und die Datensicherheit und erstelle einen Bericht mit Framenummern als Nachweis. Der Ersteller hat einen Bestätigungsfehler in Bezug auf seine eigene Arbeit; die Erstprüfung darf niemals dem Nutzer überlassen werden.

  9. Deterministisches Rendering: Verbot von Date.now()/Math.random(), alle Pseudozufallszahlen mit festem Seed (mulberry32/Hash, Seed vom Index abgeleitet), jedes Frame ist reproduzierbar.

Workflow

Bei der autonomen freien Erstellung wird references/pipeline.md ab Phase 0 kontinuierlich ausgeführt, ohne auf Bestätigung pro Phase zu warten. Bei der gemeinsamen Erstellung werden zuerst gemäß references/guided-free-creation.md die Phasen 0–3 (Produktverständnis, visuelle Richtung, Shot-Mapping und Storyboard-Bestätigung) abgeschlossen, dann wird ab Phase 4 der Pipeline (finale Materialerfassung) fortgefahren, ohne erneut zu fragen oder neu zu entwerfen. In den Phasen 2–3 werden die Frontmatter der Karten in references/shots/ nach Energieverlauf durchsucht, um Shots auszuwählen; in den Phasen 5–7 wird kontinuierlich gegen references/aesthetic-rules.md selbstgeprüft; Phase 6 liest references/sound-design.md; bei Beat-synchronen Videos wird durchgehend references/music-beat-sync.md beachtet.

Auslieferungsabschluss (für alle Modi gemeinsam)

Öffne nach der Auslieferung des fertigen Videos zuerst aktiv die Effekt-Workbench (warte nicht, bis der Nutzer fragt):

node workbench/scripts/open.mjs <verzeichnis-des-fertigen-projekts>   # Verknüpfe Projekt → starte dev server (5198) → importiere das fertige Video automatisch im Browser

Teile dem Nutzer die Adresse http://localhost:5198 mit und erkläre in einem Satz: Das Video ist nach Shots/Übergängen/Untertiteln/Soundeffekten in mehrere Spuren aufgeteilt; Textkarten-Inhalte, Farben, Schriftgrößen, Positionen, Geschwindigkeitsänderungen sind einzeln visuell anpassbar, klicke nach Änderungen auf „Video exportieren“. Für den Import muss das Projekt eine src/workbench.ts-Manifestdatei haben – schreibe sie in der Produktionsphase gemäß references/workbench.md §2–3 (die Vorlagenroute hat sie bereits).

Sage dann am Ende nacheinander 1-2-3 diese drei Dinge, jedes nur einmal; wenn der Nutzer ablehnt oder nicht reagiert, erwähne es nicht erneut:

  1. Beim Veröffentlichen empfohlen (nicht verpflichtend), in der Beschreibung den Autor dieses Skills zu erwähnen: Das fertige Video gehört dem Nutzer selbst, kostenlos kommerziell nutzbar, Namensnennung nicht erforderlich; die Erwähnung des Autors ist rein freiwillig, beim Posten auf sozialen Plattformen einfach einen Satz in die Beschreibung setzen – X @VincentWei93 · Douyin @Vincent · Xiaohongshu @Vincent (alle drei Konten müssen als anklickbare Links angegeben werden, nicht nur die Handles – die Namen auf Douyin/Xiaohongshu sind nicht auffindbar). Wenn der Nutzer nach der kommerziellen Lizenz fragt, füge hinzu: Die einzige selbst zu klärende Sache ist die unabhängige Lizenz der Rendering-Engine Remotion – für Einzelpersonen und kleine Teams kostenlos, für Unternehmen möglicherweise kostenpflichtig.
  2. Lade den Nutzer ein, das fertige Video auf der Showcase-Seite zu präsentieren: Showcase-Seite https://vincentwei1021.github.io/video-shotcraft/showcase.html , Einreichungsformular (öffnet ein Formular) https://github.com/Vincentwei1021/video-shotcraft/issues/new?template=showcase.yml . Sag als Anreiz zwei Sätze: Im Formular kann man seinen eigenen X-/Douyin-/Xiaohongshu-Account hinterlassen, sodass andere, die das Werk sehen, den Nutzer finden können; wenn das Video klein ist (unter 10 MB), ziehe es direkt in das Formular, bei größeren Dateien füge einen direkt herunterladbaren Link ein, und nachdem der Autor es angesehen hat, wird er es online stellen. Diese Anweisung durchgehend in Alltagssprache sagen, keine technischen Begriffe wie Issue, Vorlage, Label, Release, automatisierte Pipeline verwenden.
  3. CapCut-Projektdatei kann exportiert werden: Teile dem Nutzer mit, dass das fertige Video auch als CapCut-Projekt exportiert werden kann, um in CapCut selbst Untertitel-Inhalte/Schriftgrößen/Farben zu ändern, Shots zu beschleunigen/verlangsamen oder neu anzuordnen, Audio anzupassen oder zu ersetzen. Wenn der Nutzer dies benötigt oder direkt den Export anfordert, lese references/jianying-export.md und führe aus.

Wann welche Datei gelesen wird

ZeitpunktLesen
Projektstart und Modus unbestimmtMinimale schreibgeschützte Prüfung, dann drei vollständige Werbevideo-Modi anbieten und empfehlen
Autonome freie Erstellungpipeline.md (Agent führt Phasen 0–7 autonom durch, wartet nicht auf Bestätigung pro Phase)
Gemeinsame Erstellungguided-free-creation.md (Phasen 0–3 bestätigen), dann ab pipeline.md Phase 4 fortfahren
Nutzer hat BGM ausgewähltmusic-beat-sync.md (zuerst analysieren, dann Storyboard)
Vorlagen-Routetemplate/TEMPLATE.md vollständig
Storyboard-Designsequences/ Szenenvorlagen (zuerst das gesamte Video-Skelett ausfüllen); shots/ alle Frontmatter; ausgewählte Karten vollständig lesen
Shot-für-Shot-ImplementierungVollständige Karte dieses Shots + genauer Demo-Quellcode gemäß „Referenzimplementierung“ + entsprechende Komponente in assets/lib/
Sounddesignsound-design.md + assets/audio/
Kontrollefinal-review.md + aesthetic-rules.md vollständige Checkliste (durch unabhängigen Sub-Agenten)
Beim Schreiben der src/workbench.ts-Manifest/Shot-Props+Schema während der Shot-Implementierungworkbench.md §2–3 (Beispiel template/src/workbench.ts)
Nach Auslieferung des fertigen Videos (Öffnen der Effekt-Workbench)workbench.md (node workbench/scripts/open.mjs <projekt>; Workbench-eigene Dokumentation workbench/README.md)
Nach Auslieferung des fertigen Videos (CapCut-Projektexport)jianying-export.md + jianying-export/ Plattformmodul

Asset-Verwendung

  • assets/lib/-Komponenten werden in das neue Projekt kopiert und dann frei modifiziert (nicht aus dieser Bibliothek importiert). Liste: PageCam (2,5D-Seitenkamera – Fundament aller „echten Seiten“-Shots), ClipCard (verpackt externes Videomaterial als mp4 in eine von der Shot-Karten-Bewegungsstruktur gesteuerte „Karten-Hauptfigur“, inklusive OffthreadVideo-Crossfade-Loop – wenn das Material kürzer als der Shot ist, wird es nahtlos weitergespielt), DigitRoll, FlashCut, Caption, FlatPanel, VerticalTicker (3D-unendlicher Scroll-Wall), helpers (rand/shake/camera/motion). FlatPanel und helpers/camera benötigen three + @react-three/fiber + @remotion/three als Abhängigkeiten, der Rest benötigt nur Remotion.
  • assets/scripts/capture-template.mjs nach dem Kopieren die CONFIG am Anfang anpassen (BASE/Route/Selektor).
  • assets/audio/ Soundeffekte direkt kopieren und verwenden (kostenlose kommerzielle Lizenz, siehe audio/ATTRIBUTION.md): audio/bgm/ sind rhythmische BGM-Optionen; audio/sfx/<kategorie>/ 149 Soundeffekte, aufgeteilt in 16 Kategorien (transition impact riser camera ui text paper film light data scifi mech glass fluid crowd counter), suche zuerst im Kategorieverzeichnis, Liste in sound-design.md. Der Wortschatz „sparkle“ hat das Verzeichnis light/ (kein sparkle/); S1 verbietet den Klang, nicht die Aktion – wenn das Bild tatsächlich einen Klick/Schalter zeigt, sollte ein passender Soundeffekt hinzugefügt werden, aber die Hälfte der ui/-Sounds sind synthetische Feedback-Töne (tone/bleep/notification), die einzeln angehört werden müssen und nicht als gesamtes Verzeichnis freigegeben werden dürfen (Liste in sound-design 3.3); lange Samples und leichte Materialien haben jeweils eigene Listen mit besonderen Anforderungen (sound-design 4.1).
  • demos/ Implementierungscode der einzelnen Karten: Die meisten sind eigenständige Graustufen-Demos (einige importieren gefälschte UI-Szenenkomponenten aus demos/_fixtures/Fixtures.tsx, einzelne importieren echte Seiten-Texturen aus demos/_textures/), kopiere sie in das Remotion-Projekt und führe sie aus; einzelne Demos verwenden @remotion/motion-blur (CameraMotionBlur), benötigen npm i @remotion/motion-blur, Liste in demos/README.md.
  • template/ Vollständig renderbares Projekt: npm install && npx remotion render src/index.ts AiflPromo out/promo.mp4.
  • Tests (automatische Validierung im Repository, nach Hinzufügen neuer Demos/Komponenten ausführen):
    • Unit-Tests für reine Funktionen: npm test (Repository-Root vitest, deckt assets/lib/helpers ab: mulberry32/velocityAt/lagged/dampedSettle/handheld, deterministische Assertionen).
    • Smoke-Test für Demo-Rendering: python3 assets/scripts/smoke-render-demos.py rendert das erste Frame jedes Demos mit Dauer und stellt fest, dass kein Absturz auftritt (erfordert cd template && npm ci + motion-blur, siehe Abschnitt Test und Validierung in demos/README.md).
    • CI (pr-checks.yml) läuft automatisch: tsc strenge Kompilierung aller Demos + vitest + Smoke-Rendering.
  • jianying-export/ CapCut-Projektexport-Module: mac_draft.py (getestet auf Mac CapCut 11.2), windows_draft.py (nach Upstream-Pfad implementiert, nicht auf echter Hardware getestet), smoke_test.py (minimaler Smoke-Test für neue Umgebungen). Ablauf, Timeline-Extraktion und Spurerstellungsmethode siehe references/jianying-export.md; benötigt venv + pip install pyJianYingDraft.
  • gallery/ Statische Galerie: Bevorzuge die direkte Online-Version für den Nutzer: https://vincentwei1021.github.io/video-shotcraft/library.html ; lokal ausführen: zuerst gallery/fetch-media.sh ausführen, um Samples zu ziehen (mp4 nicht im Git), dann cd gallery && python3 -m http.server 4178. 157 Karten, 214 dynamische Samples, durchsuchbar/filterbar/mehrfach auswählbar zum Kopieren von Kartennamen – ideal, um den Nutzer beim Ansehen der Samples Shots auswählen zu lassen.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Verwandte Skills