Communitygithub.com

notivn/AIEV

Anfängerfreundlicher End-to-End-Video-Ersteller für HyperFrames. Nutze dies, wenn der Nutzer sagt „Mach ein Video“, „Erstelle ein Video“ oder Hilfe beim Erstellen eines fertigen MP4 aus einem Konzept, Skript oder einer groben Idee benötigt. Führt den Nutzer in einem Durchlauf durch und baut das vollständige Video mit obligatorischen Vorschau- und Sichtprüfungs-Gates.

Was ist AIEV?

Diese Fähigkeit namens „Make a Video“ führt Anfänger durch einen vollständigen, zweiphasigen Workflow von der ersten Idee bis zum fertigen MP4. Sie stützt sich auf acht sequenzielle Gates. In Phase 1 (Gates 1–4) sammelt sie in einem einzigen Gesprächsdurchlauf alle Informationen zu Zweck, Drehbuch, Stimme, Stil und Assets, ohne dass Code geschrieben wird. Die Ergebnisse werden in einer BRIEF.md zusammengefasst, die vor dem Bauen vom Benutzer bestätigt werden muss. Phase 2 (Gates 5–8) erstellt das Projekt, erzeugt ein Storyboard, baut die Kompositionen entsprechend der MOTION_PHILOSOPHY-Ästhetik, führt einen Lint und eine Studio-Vorschau durch, rendert einen Entwurf, extrahiert Schlüsselbilder zur visuellen Prüfung und erstellt die finale MP4. Die Fähigkeit vermeidet Markenpromotion, inventarisiert vorhandene Assets und hat strikte Regeln wie keine Math.random() in der Renderlogik und nicht überspringbare Vorschau-Gates. Sie ist für HyperFrames konzipiert und reicht bei bestimmten Formaten (z. B. vertikaler Talking-Head) an die Kurzvideo-Fähigkeit weiter.

Funktioniert mit~Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/notivn/AIEV/tree/HEAD/.claude/skills/make-a-video

In Ihrer bevorzugten KI fragen

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

Dokumentation

Ein Video erstellen – Die Anfänger-zu-Fertigem-MP4-Fähigkeit

Zwei Phasen, acht aufeinanderfolgende Gates. Jedes Gate erzeugt ein konkretes Artefakt, das das nächste Gate verbraucht. Überspringe keine Gates.

Wann diese Fähigkeit verwendet werden sollte – und wann sie abgegeben werden sollte

Diese Fähigkeit verwenden, wenn:

  • Der Nutzer neu bei HyperFrames ist und mit einem Konzept, Skript oder einer Gliederung beginnt
  • Sie einen vollständigen Arbeitsablauf wünschen, kein Referenzmaterial zum Framework
  • Sie sich noch nicht für ein Format entschieden haben

Abgeben, wenn:

  • Der Nutzer eine URL einfügt und ein Video von dieser Website möchte → /website-to-hyperframes aufrufen
  • Der Nutzer explizit einen vertikalen 9:16 Talking-Head mit Face-Cam und Szenenüberlagerungen möchte → Gates 1–4 hier ausführen, dann ab Gate 5 /short-form-video aufrufen
  • Der Nutzer nach Framework-Regeln fragt, nicht nach einem Video → /hyperframes aufrufen

Routing-Hinweis (AI Edit Video-Pipeline): Wenn diese Fähigkeit aus einer Projektkurzbeschreibung ausgeführt wird, überschreiben die Abschnitte STYLE DESIGN und PHONG CÁCH DỰNG (Videostil) des Bearbeitungsprompts die unten stehenden Vorgaben aus dem Interview – stelle keine Stilfragen, die die Kurzbeschreibung bereits beantwortet.

Die zwei Phasen

  • Phase 1 – INTERVIEW (Gates 1–4): Ein einziger Gesprächsdurchlauf, um alles zu sammeln, bevor Code angefasst wird. Absicht, Format, Drehbuch, Stimme, Stil, Assets, Tempo. Synthetisiert zu einer BRIEF.md und warte auf explizite Zustimmung.
  • Phase 2 – BAU (Gates 5–8): Gerüst → Storyboard → Kompositionen → Lint → Studio-Vorschau → Entwurfs-Render → visuelle Prüfung → MP4-Vorschau → finaler Render.

Gate 1 · Absicht & Format

Stelle jeweils eine Frage über AskUserQuestion, wo möglich als Multiple-Choice.

  1. Wofür ist dieses Video? (Werbung · Social-Ad · Launch-Teaser · Produktdemo · Tutorial · Erklärvideo · Intro/Outro-Karte · Sonstiges)
  2. Wer ist die Zielgruppe? (offene Frage)
  3. Gewünschte Dauer? (10–20s kurz · 20–45s Werbung · 45–90s Erklärvideo · 1,5–3 Min. Lektion · benutzerdefiniert)
  4. Seitenverhältnis? (16:9 1920×1080 · 9:16 1080×1920 · 1:1 1080×1080)
  5. Bildrate? (30 Standard · 60 für scharfe UI · 24 filmisch)
  6. Plattform-/Auslieferungsbeschränkungen? (Dateigröße · Frist · Wo es abgespielt wird)

Gate: Alle sechs erfasst. Wenn die Antwort 9:16 + Face-Cam ist, plane die Abgabe an /short-form-video bei Gate 5.

Vollständiger Fragenkatalog: Read: references/interview-questions.md


Gate 2 · Drehbuch & Stimme

  1. Drehbuchquelle? (einfügen · Gliederung → ich erstelle Entwurf · ich nehme auf · TTS aus Text · keine Erzählung)
  2. Falls TTS: Stimme-Präferenz. biete Optionen aus npx hyperframes tts --help an. Erfasse auch das Tempo. hyperframes tts (Kokoro) ist nur auf Englisch – Vietnamesische Erzählung erfolgt über das systemweite /api/tts stattdessen (Gemini TTS oder VieNeu).
  3. Falls Face-Cam: Aufnahmepfad · Vollbild oder Eckplatzierung · Transkription nötig? (npx hyperframes transcribe <file> --model small.en --json – nur Englisch; für Vietnamesisch verwende faster-whisper gemäß dem noti-tiktok-vn-Skill)
  4. Untertitel? (aus · Hype · Corporate · Karaoke-Wort-für-Wort · minimal)

Gate: Drehbuch erfasst (oder entworfen), Audio-Plan erfasst, Untertitel-Plan erfasst.


Gate 3 · Stil-Erfassung

Bevor du den Nutzer etwas fragst, inventarisiere vorhandene Assets. Überprüfe <workspace-root>/assets/ und alle Projekt-assets/-Ordner. Frage nicht nach dem, was bereits da ist.

Dann frage fortschreitend – sie müssen nicht alle beantworten:

  1. Styleguide oder Markendokument? (einfügen/Pfad · nein)
  2. Farbpalette? (Hex-Codes · keine – MOTION_PHILOSOPHY-Standardwerte verwenden)
  3. Schriftarten? (Google Fonts-Name(n) · Dateipfade · keine – Inter + JetBrains Mono-Standardwerte verwenden)
  4. Logo-Datei? (Pfad · keine). Wenn eine Marke genannt wird, aber keine Datei angegeben ist: in assets/brand-logos/ suchen oder mit POST /api/brand-logos {"name":"..."} abrufen – ein Text-Wordmark ist NUR nach einem 404 BRAND_LOGO_NOT_FOUND erlaubt. Zeichne oder generiere niemals ein Logo.
  5. Referenzvideos für den Vibe? (URLs/Pfade · keine)
  6. Andere Assets? (Screenshots · Produktfotos · B-Roll · Musik – Pfade auflisten)
  7. MOTION_PHILOSOPHY-Ästhetik (schwarze Leinwand · Chrom-Schrift · perspektivisches Raster · Peitschen-Übergänge) oder ein anderes Gefühl?
  8. Tempo? (kinetisch 1–2s · ausgewogen 2–3s · entspannt 3–5s)
  9. Musik? (keine · Ambient-Pad 0,15 · Musikbett 0,4 · voll 0,8 – Dateipfad, falls vorhanden)
  10. Outro / Call-to-Action-Text?

Dränge dem Nutzer niemals eine Marke auf. Fallback auf MOTION_PHILOSOPHY-Standardwerte NUR, wenn sie explizit die Angabe eines Stils ablehnen.

Vollständiger Stil-Ablauf + MOTION_PHILOSOPHY-Standardwerte: Read: references/style-intake.md


Gate 4 · Kurzbeschreibungssynthese (HARTES GATE vor dem Bau)

  1. Lies MOTION_PHILOSOPHY.md, falls es im Arbeitsbereichsstamm existiert – zwingend, falls vorhanden. Falls fehlend, fahre mit den Standardwerten in references/style-intake.md fort und vermerke das Fehlen in der Kurzbeschreibung.
  2. Frage, wo Projekte leben, falls es nicht offensichtlich ist:
    • Wenn video-projects/ existiert → verwende video-projects/<slug>/
    • Andernfalls → frage den Nutzer
  3. Schreibe <project-folder>/BRIEF.md:
    • slug · Absicht · Zielgruppe · Abmessungen · fps · Dauer
    • Drehbuch (vollständig oder Gliederung)
    • Stimmenauswahl · Untertitel-Plan · Face-Cam-Plan
    • Stilprofil: Palette (Hex), Schriftarten, Logo-Pfad, Referenzvideos
    • Tempo
    • Asset-Inventar mit Pfaden
    • Outro / CTA-Text
  4. Zeige die Kurzbeschreibung. WARTE auf explizite Zustimmung. Fahre nicht zu Gate 5 ohne ein klares „Ja, bau es.“

Gate 5 · Gerüst & Storyboard

Zuerst Übergabe-Check

Wenn die Kurzbeschreibung einen vertikalen 9:16 Talking-Head mit Face-Cam + Szenenüberlagerungen beschreibt, rufe /short-form-video JETZT auf und übergebe die Kurzbeschreibung. Sein 4-schichtiges Gerüst ist für dieses Format optimiert.

Ansonsten fortfahren:

Gerüst

  1. mkdir <project-folder>
  2. Wenn ein Schwesterprojekt mit ähnlichem Format existiert, biete an, dessen hyperframes.json + meta.json als Vorlage zu kopieren. Andernfalls von innerhalb des Ordners: npx hyperframes init
  3. Bearbeite meta.json mit dem slug, den Abmessungen und der fps des Nutzers.
  4. Kopiere bereitgestellte Assets in <project-folder>/assets/.
  5. Erstelle <project-folder>/assets/style-profile.md aus Gate 3 – einzige Quelle der Wahrheit für Palette/Schriftarten/Logo.

Storyboard

Generiere <project-folder>/STORYBOARD.md mit der Vorlage in references/storyboard-template.md. Jeder Beat erhält:

Beat N – TITEL (Start–Ende, Dauer) – Konzept in einem Satz
Visuelle Elemente: [jedes Element, Größe, Animation, Timing]
Bewegungssprache: [Art der Bewegung]
Verwendete Eases: [3–4 verschiedene GSAP-Eases]
Ausgang: [Übergang zum nächsten Beat]
Audio: [VO-Zeile / SFX / Musik-Ebene]

Oben in der Datei: eine Zeittabelle mit Szene · Start · Dauer · Kompositionsdatei.

Schlage eine Dreierstruktur vor:

  • Akt 1 (Aufhänger) ≈ 20 % der Dauer
  • Akt 2 (Hauptteil) ≈ 55 %
  • Akt 3 (Auflösung + Outro mit 4–6 Sekunden Halten) ≈ 25 %

(MOTION_PHILOSOPHY §0 Gesetz 9, §1.)

Ordne Nutzerabsichten Katalogblöcken zu: Read: references/catalog-intent-map.md

Gate: Zeige Storyboard + Zeittabelle. Wiederhole, bis der Nutzer zustimmt.


Gate 6 · Kompositionen bauen

Rufe /hyperframes für Framework-Regeln auf. Diese Fähigkeit besitzt das Gerüst und die Disziplin; /hyperframes setzt die Regeln durch.

Jede Unterkomposition grundieren

<div data-composition-id="szenen-name" data-start="..." data-duration="...">
  <style>[data-composition-id="szenen-name"] { /* begrenzt */ }</style>
  <!-- DOM -->
  <script>
    (function(){
      const SLOT_DURATION = ...;
      const tl = gsap.timeline({ paused: true });
      // ... Tweens ...
      tl.to({}, { duration: SLOT_DURATION }, 0);   // Anker – MOTION_PHILOSOPHY Gesetz 11
      window.__timelines["szenen-name"] = tl;
    })();
  </script>
</div>

Vollständiger Boilerplate + Untertitel-Muster + Ambient-BG-Muster: Read: references/composition-scaffold.md

Bauregeln

  • Ambient-Hintergrund auf data-track-index="0" für die gesamte Kompositionsdauer.
  • Kinetische Schrift-Öffner: Pro-Wort-Staffelung 0,06–0,10 s.
  • Untertitel als Geschwisterelemente der Stammkomposition auf Körperebene in index.html, jedes mit data-track-index ≥ 20. Niemals innerhalb von Szenen-Zeitachsen (MOTION_PHILOSOPHY §3.13).
  • Katalogblöcke installiert über npx hyperframes add <name>. Begrenze sofort das CSS des Blocks auf [data-composition-id="..."] – Katalogblöcke werden mit html, body { ... }-Regeln ausgeliefert, die in das übergeordnete Dokument bluten, wenn sie als Unterkompositionen geladen werden.
  • Vertikal + Face-Cam: Umhülle natives 1920×1080 Face in eine Transformation (translate + scale) für den unteren Bildschirmhälften- oder Vollbildmodus. (Wenn du hier statt bei /short-form-video landest, erwäge dringend die Übergabe.)
  • Wende NUR an, was der Nutzer bereitgestellt hat. Seine Palette, seine Schriftarten, sein Logo. Füge nichts anderes hinzu. Wenn sie sich für MOTION_PHILOSOPHY-Standardwerte entschieden haben, ziehe die Palette + Schriftarten-Kombination aus references/style-intake.md.

Determinismus

Kein Math.random(), kein Date.now(), kein Render-Zeit-fetch(). Verwende gesäte PRNGs oder harmonische-Sinus-Hashes (MOTION_PHILOSOPHY §3.10).


Gate 7 · Lint → Studio-Vorschau (VORSCHAU-GATE 1 – ZWINGEND)

  1. npx hyperframes lint – behebe alle Fehler, priorisiere Warnungen.
  2. npx hyperframes preview im Hintergrund.
  3. Warte auf „Studio läuft“ unter http://localhost:3002.
  4. Gib dem Nutzer die URL plus einzelne Kompositions-URLs (http://localhost:3002/?comp=<id>). Wenn das Projekt WebGL-Shader-Blöcke hat, führe mit den einzelnen URLs – der Software-WebGL-Fallback kann die Hauptkomposition aufhängen.
  5. WARTE auf explizites „sieht gut aus, rendere einen Entwurf“, bevor du fortfährst. Schweigen ist keine Zustimmung.

Hot-Reload ist aktiv – Bearbeitungen werden live angezeigt.


Gate 8 · Entwurfs-Render → visuelle Prüfung → MP4-Vorschau → Finale

Entwurfs-Render

npx hyperframes render --quality draft --output renders/<slug>-draft.mp4

Visuelle Prüfung (ZWINGEND vor Auslieferung)

Lint bestanden ≠ Design funktioniert. Extrahiere Frames und betrachte sie.

  1. mkdir -p renders/frames
  2. Für jeden Beat-Höhepunkt UND jeden Übergang:
    ffmpeg -y -ss <t> -i renders/<slug>-draft.mp4 -frames:v 1 -q:v 2 renders/frames/t<t>.png
    
  3. Rufe das Read-Tool für jedes PNG auf. Das Read-Tool lädt das Bild in den Kontext – liste nicht nur Dateinamen auf.
  4. Bestätige pro Frame: keine abgeschnittenen Gesichter, korrekter Face-Modus pro Szene, Text lesbar und auf Palette, kein Überlauf, Übergänge landen auf den gewünschten Wörtern, keine leeren Frames.
  5. Wenn etwas falsch ist: korrigieren → erneut rendern → erneut prüfen. Versende niemals einen fehlerhaften Entwurf.

MP4-Vorschau (VORSCHAU-GATE 2 – ZWINGEND)

npx serve renders -p 8080 -n

Verwende NICHT Pythons http.server – es unterstützt keine HTTP-Range-Anfragen, daher bricht das Vor-/Zurückspulen.

Übergebe dem Nutzer http://localhost:8080/<slug>-draft.mp4. WARTE auf explizite Freigabe für Wiedergabe und Audio-Synchronisation.

Finaler Render

npx hyperframes render --quality standard --output renders/<slug>-final.mp4

In der AI Edit Video-Pipeline ist dies NICHT das Ende: Fahre mit der video-pipeline-Fähigkeit fort (QC → Finale über die Render-Warteschlange zusammenstellen → outputs/<id>-v<N>.mp4 → meta.json aktualisieren → Thumbnail/veröffentlichen). Eigenständige Nutzung außerhalb der Pipeline: Melde den Ausgabepfad. Fertig.

Vollständige Preflight- + Vorauslieferungs-Checkliste: Read: references/build-checklist.md


Unverhandelbar (tragend – nicht abschwächen)

  • ÜBERSPRINGE NICHT VORSCHAU-GATE 1 (Studio) oder VORSCHAU-GATE 2 (gerendertes MP4). Zwei Gates pro Bau, immer.
  • BEHAUPTE NICHT, ein Render sei fertig, bis Frames extrahiert UND über das Read-Tool gelesen wurden.
  • BAUE NIEMALS außerhalb eines dedizierten Projektordners. Lege index.html niemals im Arbeitsbereichsstamm ab.
  • FRAGE DEN NUTZER NICHT NACH ASSETS, bevor du seinen Arbeitsbereich inventarisiert hast.
  • ÜBERSPRINGE NICHT den tl.to({}, { duration: SLOT_DURATION }, 0)-Anker-Tween am Ende jeder Unterkompositions-Zeitachse. MOTION_PHILOSOPHY Gesetz 11.
  • VERWENDE NICHT Math.random() / Date.now() innerhalb der Render-Logik. Nur gesäte Hashes.
  • FÜGE KEIN class="clip" zu <video>-Tags hinzu. Es zerstört sie.
  • DRÄNGE DEM NUTZER KEINE MARKE AUF. Frage zuerst; falle auf MOTION_PHILOSOPHY-Standardwerte zurück, NUR wenn sie explizit ablehnen.

Referenzen

  • references/interview-questions.md – vollständiger Fragenkatalog nach Gate
  • references/style-intake.md – Stil-Interview + MOTION_PHILOSOPHY-Standardwerte
  • references/catalog-intent-map.md – „Nutzer sagt X → installiere Y“
  • references/storyboard-template.md – Beat-für-Beat-Vorlage + ausgearbeitetes Beispiel
  • references/composition-scaffold.md – bereichsbezogene Styles + IIFE GSAP-Boilerplate
  • references/build-checklist.md – Preflight- + Vorauslieferungs-Gates

Extern (Arbeitsbereichsebene):

  • MOTION_PHILOSOPHY.md – die eine externe Referenz, von der diese Fähigkeit ausgeht, dass sie existiert. Ästhetische Basis. Fallback befindet sich in references/style-intake.md, wenn die Datei fehlt.

Verwandte Fähigkeiten

  • /hyperframes – Framework-Regeln, rufe bei Gate 6 auf
  • /hyperframes-cli – init · lint · preview · render · transcribe · tts
  • /hyperframes-registry – Installieren von Katalogblöcken
  • /gsap – GSAP-Animationsreferenz
  • /short-form-video – Gib bei Gate 5 für 9:16-Talking-Head-Format ab
  • /website-to-hyperframes – Gib bei Gate 1 ab, wenn die Eingabe eine URL ist

Verwandte Skills