Communitygithub.com

Sci-Glow Video Skill (发光线描科普视频全流程制片)

End-to-End Produktionsworkflow für wissenschaftliche Erklärvideos mit Leuchtlinien-Optik (60fps deterministische Animation, untertitelgenaue Vertonung, BGM-Höhepunkt-Synchronisation und Side-Chain-Mixing, doppelte 4K-Cover, quantitative Helligkeitsprüfung und unabhängiger Blind-Review-Kreislauf. Unterstützt parallele Serienproduktion mit Mehrfach-Fragenauswahl).

Was ist Sci-Glow Video Skill (发光线描科普视频全流程制片)?

Dieses Skill automatisiert die Produktion von wissenschaftlichen Leuchtlinien-Erklärvideos – von der Idee bis zur auslieferungsreifen MP4. Es baut auf den Skills `Lead-自媒体口播文案` (für Skripterstellung) und `Lead-知识讲解动画` (für die Canvas/DOM-Animation) auf und erweitert sie um spezifische Prüfungen und Workflows für Leuchtlinien-Videos. Es führt automatisiert eine Literatur-Faktenprüfung durch, synchronisiert die Animation mit den Höhepunkten (Drops) einer MP3-Datei und nutzt ein Zweimodell-System (Carbon für Planung, Argon für Umsetzung). Der Workflow stellt sicher, dass Layouts im 3:4- oder 9:16-Format kollisionsfrei sind (fünf vertikale Zonen), die Helligkeit (bloom) zwischen 0,20 und 0,28 liegt und keine P0- oder P1-Fehler vor der finalen 60fps-Renderung bestehen. Es ist ideal für die Erstellung von hochwertigen, schnörkellosen Wissenschaftsvideos, die in Serie produziert werden sollen, und wird über die Befehlszeile mit Python- und Node.js-Skripten gesteuert.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/zy27488/sci-glow-video-skill/tree/HEAD

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Sci-Glow Video Skill (发光线描科普视频全流程制片)?

Übersicht

Wandelt ein hartes wissenschaftliches Thema von einem „Ein-Satz-Konzept“ stabil in einen kompletten Satz auslieferungsfähiger 60-Sekunden-(oder benutzerdefinierten) Leuchtlinien-Wissenschaftsanimationen um: reines Text-Sprachskript, Literatur-Checkliste, präzise getimte Untertitel, 60fps-Bewegungsunschärfe-Master-MP4, horizontales und vertikales 4K-Sicherheitszonen-Cover sowie plattformspezifische Betriebstexte.

Kernphilosophie: Hartqualitäts-Tor mit automatischer Nacharbeit (quantitative Helligkeit + Null-BOM-Prüfung + unabhängiger, schreibgeschützter Blind-Review durch Sub-Agent ≥ 8,5 Punkte) – rendert NIEMALS ein Master-Video, wenn P0/P1-Fehler oder Überbelichtung/graue Bildschirme bestehen.

Abhängigkeiten

Dieses Skill orchestriert und erweitert die folgenden Fähigkeiten auf oberer Ebene, ohne deren zugrunde liegende Engines neu zu implementieren:

  • Lead-知识讲解动画 (lead-knowledge-animation): Stellt deterministische Canvas/DOM-Laufzeit (motion.js, kit.js) und grundlegende Skripte (new_film.mjs, beats.py, timeline.py, fonts.py, sfx.py, mix.py, render.mjs, cover.mjs, verify.mjs, qa_video.py, review_pack.py) bereit. Von AzenYes/leaderai-media-toolkit.
  • Lead-自媒体口播文案 (lead-media-script): Stellt Syntax für kalte Einstiege (Hooks), alltägliche Analogie-Strukturen und plattformspezifische Veröffentlichungsdokumentvorlagen für Bilibili, TikTok, Video-Konto, Xiaohongshu und YouTube bereit. Von AzenYes/leaderai-media-toolkit.
  • uv (uv run): Führt das begleitende, reine Standardbibliothek-CLI-Skript scripts/sci_glow_cli.py aus.
  • Optionale wissenschaftliche Recherche-Skills (bevorzugt, wenn im Host installiert): pubmed-database oder literature-search-openalex, zur Überprüfung von Autoritäten und echten Werten; wenn nicht installiert, verwendet es Internetsuche zur Verifizierung der Primärliteratur.

Schnellstart

# 1. Umgebungs- und IBM Plex Sans SC 8-Schriftstärken-Selbsttest (fehlende Schriftarten werden automatisch mit Ratenbegrenzung geladen)
uv run <skill_dir>/scripts/sci_glow_cli.py preflight --auto-fix-fonts --output work/preflight.json

# 2. Spektrale Höhepunktberechnung von jeder Benutzer-MP3, Ausgabe der Top-3-Cut-Startpunkte und Side-Chain-Parameter
uv run <skill_dir>/scripts/sci_glow_cli.py analyze-bgm --bgm "<BGM.mp3>" --target-duration 60 --top-k 3 --output work/bgm_analysis.json

# 3. Projektverzeichnisse initialisieren und sichere Standardparameter schreiben (inkl. 3:4 1080x1440 und bloom 0.26)
uv run <skill_dir>/scripts/sci_glow_cli.py scaffold-project --workspace "<Projektstammverzeichnis>" --date 20261118 --topic Optogenetik --ratio 3x4 --output work/scaffold.json

Hilfsskripte

Alle Hilfsberechnungen werden über scripts/sci_glow_cli.py bereitgestellt, mit einheitlicher --output-Ausgabe als UTF-8 ohne BOM JSON. Keine rohen Logausgaben an das Terminal:

UnterbefehlKernfunktionWichtige erforderliche Parameter
preflightPrüft Node 18+, FFmpeg, Chrome, Playwright (Tipp für npmmirror + überspringt erneutes Browser-Download), die beiden Upstream-Skills und IBM Plex 8 Schriftstärken; fügt mit --auto-fix-fonts automatisch fehlende .otf-Dateien hinzu--output
scaffold-projectErzeugt 口播文案输出/<Datum Thema-Erklärung>/ und .code/<Datum Thema-Erklärung-Animation>/, führt new_film.mjs aus und patcht es für 3:4-Größe und bloom: 0.26--workspace, --date, --topic, --ratio, --output
analyze-bgmDekodiert 8kHz-Mono-Waveform mit FFmpeg, extrahiert Full-Range RMS + <180Hz-Low-Freq-Hüllkurve, sucht Drop 1 (Titelkarte) → Breakdown → Finaler Höhepunkt-Drop, gibt Top-K --music-start und --music-dips aus--bgm, --target-duration, --top-k, --output
validate-linesPrüft/entfernt UTF-8 BOM, überprüft Zeichenanzahl bei 1080px Breite (Hook <=12 Zeichen, Untertitel <=15 Zeichen), ausgeglichene Klammern, keine Satzendzeichen, Hook-Limit von 5s, sperrt automatisch die Gesamtdauer tail--lines, --target-duration, --ratio, --output (optional --fix-bom, --apply-tail)
audit-qaRuft qa_video.py auf und führt basierend auf Goldenen Fingerabdrücken (mean 17-20, p99 >= 130, bright <= 3.5%, Null-Totzonen, Null-Flimmer-Frames) eine Ampelbewertung und Parameterempfehlung durch, generiert unabhängige Blind-Review-Prompts--video, --film-dir, --round, --output

Workflow

Bei parallelen Mehrfach-Fragen oder Zweimodell-Arbeitsteilung gleichzeitig multi-agent-batch-playbook.md laden; Bild- und Layoutparameter strikt nach visual-and-layout-guardrails.md.

Schritt 0: Umgebungs-Check vor Arbeitsbeginn und Musikbestätigung

  1. Führe preflight --auto-fix-fonts --output ... aus; falls Playwright fehlt, leite den Benutzer an: $env:PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD="1"; npm i playwright --registry https://registry.npmmirror.com.
  2. Musik-Tor: Wenn der Benutzer ein Lied angibt, verwende nur das des Benutzers; wenn kein Lied angegeben ist und keine begleitende Musik lokal vorhanden ist, frage den Benutzer aktiv nach dem Pfad der Musikdatei oder schlage vor, nur Soundeffekte zu verwenden (niemals eigenmächtig überspringen).

Schritt 1: Skripterstellung mit null Barriere und Primärliteratur-Check (unter Wiederverwendung von Lead-自媒体口播文案)

  1. Die ersten 3 Sekunden MÜSSEN mit spezifischen Zahlen oder kontraintuitiven Fakten fesseln, dann zuerst alltägliche konkrete Analogien geben, bevor wissenschaftliche Begriffe eingeführt werden.
  2. Überprüfe mindestens 2–3 Primärquellen aus Fachzeitschriften (Nature / Science / NEJM / Cell). Keine erfundenen Daten erlaubt.
  3. Erstelle im Verzeichnis 口播文案输出/<YYYYMMDD Thema-Erklärung>/ das reine Textskript .txt und den Ausführungsplan .md.

Schritt 2: BGM-Spektrum-Höhepunktsynchronisation und präzise Untertitel-Zeitbindung

  1. Führe analyze-bgm --bgm <pfad> --target-duration <T> --top-k 3 --output work/bgm.json aus, wähle den besten music_start_sec und verwende beats.py von oben zur Ausgabe von work/beats.json.
  2. Erstelle work/lines.json: Setze die Titel-Karte T.at auf Drop 1, den Wendepunkt-Konflikt at auf Breakdown, den Durchbruchsmoment at auf Den letzten Höhepunkt-Drop und lasse am Ende Raum für ein abklingendes Bild als Abschluss.
  3. Führe validate-lines --lines work/lines.json --target-duration <T> --ratio <ratio> --fix-bom --apply-tail --output work/lines_check.json aus; erst wenn alles grün ist, führe timeline.py --beats work/beats.json --music-start <start> --film film/ von oben aus.

Schritt 3: Visuelles Systemdesign und deterministische Code-Implementierung (unter Wiederverwendung von Lead-知识讲解动画)

[!IMPORTANT] Codierungs- und visuelle Parameter MÜSSEN visual-and-layout-guardrails.md befolgen: bloom: 0.20–0.28, K.fog: 0.024–0.028, K.hud.corner deaktiviert, scenes.js in IIFE verpackt, Übergangstitel mit mode: 'rise', blur: 0 und +0.36s Verzögerung.

  1. Führe zuerst scaffold-project aus, um die Doppelverzeichnisse zu erstellen.
  2. Entwerfe eine nicht-kollidierende Hauptfarbpalette, schreibe 3–5 Schichten feiner Leucht-Primitive für die wissenschaftliche Metapher dieses Films in film/core.js (wiederhole keine generischen Box-Karten/Strichmännchen).
  3. Schreibe film/scenes.js, film/index.html und film/cover.html, führe die Subset-Bildung mit fonts.py film/ und die vollständige Null-Fehler-Prüfung mit verify.mjs film/index.html --tol 24 von oben durch.

Schritt 4: Side-Chain-Mixing und doppeltes 4K-Cover mit Sicherheitszonen-Prüfung

  1. Schreibe work/cues.json als UTF-8 ohne BOM, führe sfx.py --variants 3 und mix.py aus (fülle die von analyze-bgm gelieferten --music-start und --music-dips ein, richte auf -14.0 LUFS / -1.5 dBFS aus).
  2. Führe cover.mjs film/cover.html --out out --name <Thema> --guides aus, überprüfe die Bilder in work/封面检查/ visuell, stelle sicher, dass horizontale Schlüsselinformationen streng im zentralen 4:3-Bereich (x ∈ [240, 1680]) liegen.

Schritt 5: 30fps-Entwurf mit quantitativer Prüfung + unabhängiger, schreibgeschützter Blind-Review-Kreislauf

Siehe blind-review-protocol.md.

  1. Zuerst halb aufgelösten Entwurf rendern: render.mjs film/index.html --fps 30 --scale 0.5 --out out/draft_r1.mp4 (einzelne Datei: --workers 8, mehrere parallele Dateien: strikt --workers 4).
  2. Führe audit-qa --video out/draft_r1.mp4 --film-dir film --round 1 --output work/qa_r1.json aus. Wenn Helligkeit oder Totzonen nicht bestanden werden, zuerst Parameter gemäß Rezept ändern und Entwurf erneut rendern.
  3. Führe review_pack.py out/draft_r1.mp4 --film film/ --out out/review_r1 aus, erzeuge einen schreibgeschützten research-Blind-Review-Sub-Agenten (kann nur out/review_r1/ lesen, Quellcode strengstens verboten), der eine 9-dimensionale Bewertung durchführt.
  4. Bei irgendeinem P0/P1 oder Durchschnittspunktzahl < 8.5 ist es strengstens verboten, ein 60fps-Master zu rendern. Ändere jeden Punkt, prüfe erneut und wiederhole die Überprüfung, bis alles grün ist.

Schritt 6: 60fps-Bewegungsunschärfe-Master direkt rendern und vollständige Lieferung

  1. Nachdem der Blind-Review vollständig grün ist, rendere nur einmal die endgültige Version: render.mjs film/index.html --fps 60 --blur 2 --audio work/mix.wav --out out/<Thema>.mp4.
  2. Führe erneut audit-qa und qa_video.py --sheet --ref-sheet aus, überprüfe visuell die endgültige Kontaktliste und lösche temporäre out/draft*.mp4-Entwürfe.
  3. Vervollständige work/文案与封面.md gemäß Lead-自媒体口播文案 und copy_template.md, liefere dem Benutzer den gesamten Satz an Dateien und eine Liste der Momente für Audio-Neuaufnahmen, die menschliches Hören erfordern.

Ratenbegrenzung

  • analyze-bgm, validate-lines, scaffold-project, audit-qa laufen alle lokal ohne externe Netzwerkanfragen.
  • preflight --auto-fix-fonts lädt fehlende .otf-Schriftarten von einem CDN mit einem integrierten, prozessübergreifenden OS-Dateisperrmechanismus + time.monotonic()-Ratenbegrenzer (1.0 req/s). Bei 5xx-Fehlern werden 3 exponentielle Backoff-Wiederholungen durchgeführt, bei HTTP 429 wird RateLimitError ausgelöst und die Anfrage abgebrochen.

Häufige Fehler

  1. PowerShell UTF-8 BOM führt zum Absturz von mix.py: PowerShell 5.1 schreibt standardmäßig mit Set-Content -Encoding UTF8 einen EF BB BF-Dateiheader. Alle .json-Dateien MÜSSEN mit encoding='utf-8' in Python, mit dem cli-Tool oder mit [IO.File]::WriteAllText (ohne BOM) geschrieben werden.
  2. Verwendung der Standardwerte bloom: 0.9 und mode: 'center' führt zu Unschärfe: Ein großer Leuchtlinien-Hauptkörper mit 0.9 Glühen sprengt garantiert bright > 3.5%, und center-Titel mit festen 14px Unschärfe zerstören den Lichtereignis-Übergang. MUSS auf 0.20–0.28 heruntergesetzt und auf rise (blur: 0) gemäß visual-and-layout-guardrails.md geändert werden.
  3. Chromium Workers-Überlastung und „sich selbst prüfen“ bei parallelen Dateien: Bei 3–4 parallelen Dateien muss die Rate mit --workers 4 begrenzt werden; gleichzeitig darf NIEMALS derselbe Kontext, der den Code schreibt, die Freigabe selbst erteilen. Die Unterschrift muss über den isolierten schreibgeschützten Blind-Review-Sub-Agenten über das Verzeichnis out/review_rN/ erfolgen.

Verwandte Skills