Communitygithub.com

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

Flux de production complet pour créer des vidéos scientifiques科普 en lueur linéaire, de l'idée au livrable final : animation 60 ips, sous-titrage mot à mot, synchronisation BGM, double couverture 4K, inspection de luminosité et révision en aveugle par sous-agent indépendant.

Qu'est-ce que Sci-Glow Video Skill (发光线描科普视频全流程制片) ?

Ce skill orchestre la création de vidéos scientifiques科普 animées en style "glow line" (lueur linéaire) de bout en bout. Il transforme un concept scientifique en livrables complets : script oral, fiche de vérification des sources, sous-titres synchronisés à la lettre, master MP4 avec flou de mouvement 60 ips, couvertures 4K horizontale et verticale, et textes promotionnels adaptés à chaque plateforme. Sa philosophie centrale est un contrôle qualité automatisé strict : inspection quantitative de la luminosité, validation zéro BOM, et révision en aveugle par un sous-agent indépendant en lecture seule (note ≥ 8.5/10). Il s'appuie sur les skills `lead-knowledge-animation` et `lead-media-script` pour l'animation et le copywriting, et fournit un CLI Python (`sci_glow_cli.py`) pour la vérification d'environnement, l'analyse spectrale BGM, l'initialisation de projet et l'audit qualité. Le workflow en six étapes comprend la vérification de l'environnement, la rédaction du script avec vérification des sources, l'alignement BGM, la conception visuelle avec des garde-fous précis (bloom 0.20-0.28, etc.), le mixage et la génération des couvertures, puis un double cycle de validation (quantitatif + révision en aveugle) avant de produire le master final 60 ips.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Sci-Glow Video Skill (Flux de production complet pour vidéos科普 à lueur linéaire)

Vue d'ensemble

Transformez un sujet scientifique pointu, d'une "idée en une phrase", en un ensemble de livrables prêts à publier pour une vidéo科普 animée à lueur linéaire de 60 secondes (ou durée spécifiée) : script oral textuel, fiche de vérification des sources, sous-titres précisément synchronisés, master MP4 avec flou de mouvement 60 ips, double couverture 4K en modes paysage et portrait, et textes promotionnels adaptés à chaque plateforme.

Philosophie centrale : contrôle qualité automatisé avec reprise obligatoire (luminosité quantifiée + validation zéro BOM + révision en aveugle par sous-agent indépendant en lecture seule ≥ 8.5/10). Ne jamais forcer le rendu du master en présence de défauts P0/P1 ou d'écran grisé surexposé.

## Dépendances

Ce skill orchestre et enrichit les capacités amont suivantes, sans réimplémenter leurs moteurs sous-jacents :

  • Lead-知识讲解动画 (lead-knowledge-animation) : fournit l'environnement d'exécution Canvas/DOM déterministe (motion.js, kit.js) et l'infrastructure de base (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). Provenant de AzenYes/leaderai-media-toolkit.
  • Lead-自媒体口播文案 (lead-media-script) : fournit la syntaxe d'accroche froide, la structure d'analogie concrète et les normes de documents de publication pour Bilibili, Douyin, WeChat Video, Xiaohongshu et YouTube. Provenant de AzenYes/leaderai-media-toolkit.
  • uv (uv run) : exécute le script CLI auxiliaire scripts/sci_glow_cli.py utilisant uniquement la bibliothèque standard.
  • Compétences de recherche scientifique optionnelles (utilisées en priorité si installées) : pubmed-database ou literature-search-openalex, pour vérifier les articles et valeurs réelles ; si non installées, une recherche en ligne est utilisée pour confirmer la littérature primaire.

Démarrage rapide

# 1. Vérification de l'environnement et de la police IBM Plex Sans SC 8 poids (téléchargement limité si manquant)
uv run <skill_dir>/scripts/sci_glow_cli.py preflight --auto-fix-fonts --output work/preflight.json

# 2. Analyse spectrale d'un fichier MP3 utilisateur pour calculer les drops, renvoie le Top-3 des points de départ et les paramètres de ducking préliminaires
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. Initialisation du projet en double répertoire avec paramètres de sécurité par défaut (y compris 3:4 1080x1440 et bloom 0.26)
uv run <skill_dir>/scripts/sci_glow_cli.py scaffold-project --workspace "<Répertoire Racine du Projet>" --date 20261118 --topic 光遗传学 --ratio 3x4 --output work/scaffold.json

Scripts utilitaires

Tous les calculs auxiliaires sont fournis via scripts/sci_glow_cli.py, dont les sorties sont JSON UTF-8 sans BOM via --output. Les logs bruts en fin de terminal sont interdits :

Sous-commandeRôle principalParamètres obligatoires clés
preflightVérifie Node 18+, FFmpeg, Chrome, Playwright (indique npmmirror + ignore le téléchargement redondant du navigateur), les deux skills amont et la police IBM Plex 8 poids ; avec --auto-fix-fonts, télécharge automatiquement les fichiers .otf manquants--output
scaffold-projectCrée les répertoires 口播文案输出/<Date Sujet Scientifique>/ et .code/<Date Sujet Scientifique>/, exécute new_film.mjs et patch les paramètres pour activer le ratio 3:4 et bloom: 0.26--workspace, --date, --topic, --ratio, --output
analyze-bgmDécode la forme d'onde mono 8kHz via FFmpeg, extrait l'enveloppe RMS pleine bande et basse fréquence <180Hz, recherche Drop 1 (titre) → Breakdown → Drop final climax, renvoie Top-K --music-start et --music-dips--bgm, --target-duration, --top-k, --output
validate-linesValide/supprime le BOM UTF-8, vérifie le nombre de caractères à 1080px de large (accroche <=12, sous-titre <=15), équilibre des parenthèses, pas de ponctuation finale et limite 5s pour l'accroche, recalcule et verrouille la durée totale avec tail--lines, --target-duration, --ratio, --output (optionnel --fix-bom, --apply-tail)
audit-qaAppelle le script amont qa_video.py et évalue selon les empreintes dorées (mean 17-20, p99 >= 130, bright <= 3.5%, zéro zone morte, zéro flash frame), donne un feu tricolore et une prescription de paramètres, et génère un prompt de révision en aveugle indépendant--video, --film-dir, --round, --output

Workflow

En cas de demande multi-sujets parallèles ou de division du travail entre deux modèles, chargez également multi-agent-batch-playbook.md ; les paramètres visuels et de mise en page doivent respecter strictement visual-and-layout-guardrails.md.

Étape 0 : Vérification de l'environnement et confirmation musicale avant le début

  1. Exécutez preflight --auto-fix-fonts --output ... ; si Playwright manque, guidez l'exécution : $env:PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD="1"; npm i playwright --registry https://registry.npmmirror.com.
  2. Porte musicale : si l'utilisateur a spécifié un morceau, utilisez-le uniquement ; sinon, et aucun morceau n'est disponible localement, demandez activement à l'utilisateur de fournir le chemin du fichier musical ou de passer aux effets sonores (ne pas sauter de manière privée).

Étape 1 : Rédaction du script sans effort et vérification de la littérature primaire (réutilisation Lead-自媒体口播文案)

  1. Les 3 premières secondes doivent impérativement utiliser un chiffre concret ou un fait contre-intuitif pour accrocher, puis donner une analogie concrète du quotidien avant d'introduire le terme scientifique.
  2. Vérifiez au moins 2 à 3 sources d'articles de revues de premier plan (Nature / Science / NEJM / Cell), il est interdit d'inventer des données.
  3. Générez dans 口播文案输出/<YYYYMMDD Sujet Scientifique>/ le fichier texte brut .txt et le plan d'exécution .md.

Étape 2 : Alignement spectral BGM et verrouillage précis des sous-titres

  1. Exécutez analyze-bgm --bgm <path> --target-duration <T> --top-k 3 --output work/bgm.json pour sélectionner le meilleur music_start_sec, et utilisez work/beats.json via beats.py amont.
  2. Écrivez work/lines.json : calez le titre T.at sur Drop 1, la crise at sur Breakdown, le moment de percée at sur Drop final climax, et laissez de la place pour une image de retour en fin de morceau.
  3. Exécutez validate-lines --lines work/lines.json --target-duration <T> --ratio <ratio> --fix-bom --apply-tail --output work/lines_check.json, et seulement si tout est vert, exécutez timeline.py --beats work/beats.json --music-start <start> --film film/.

Étape 3 : Conception du système visuel et implémentation du code déterministe (réutilisation Lead-知识讲解动画)

[!IMPORTANT] Les paramètres de codage et visuels doivent respecter visual-and-layout-guardrails.md : bloom: 0.20–0.28, K.fog: 0.024–0.028, K.hud.corner désactivé, scenes.js enveloppé dans une IIFE, titres de transition avec mode: 'rise', blur: 0 et décalage +0.36s.

  1. Exécutez d'abord scaffold-project pour créer les double répertoires.
  2. Concevez une palette de couleurs sans conflit, et écrivez manuellement 3 à 5 couches de primitives lumineuses fines dans film/core.js pour la métaphore scientifique spécifique de cette vidéo (interdiction de répéter des boîtes/carrés ou des bonhommes allumettes génériques).
  3. Écrivez film/scenes.js, film/index.html et film/cover.html, puis faites passer les tests de sous-ensemble fonts.py film/ et de vérification zéro-incrément verify.mjs film/index.html --tol 24.

Étape 4 : Mixage avec ducking et vérification des zones de sécurité des doubles couvertures 4K

  1. Écrivez work/cues.json sans BOM UTF-8, exécutez sfx.py --variants 3 et mix.py (en renseignant --music-start et --music-dips donnés par analyze-bgm, alignement -14.0 LUFS / -1.5 dBFS).
  2. Exécutez cover.mjs film/cover.html --out out --name <Sujet> --guides, inspectez visuellement les images dans work/封面检查/, assurez-vous que les informations clés en mode paysage sont strictement dans le 4:3 central (x ∈ [240, 1680]).

Étape 5 : Inspection quantitative du brouillon 30 ips + boucle de révision en aveugle par sous-agent indépendant

Voir blind-review-protocol.md pour plus de détails.

  1. Produisez d'abord un brouillon demi-résolution : render.mjs film/index.html --fps 30 --scale 0.5 --out out/draft_r1.mp4 (un seul fichier : --workers 8, plusieurs fichiers simultanés : limiter strictement à --workers 4).
  2. Exécutez audit-qa --video out/draft_r1.mp4 --film-dir film --round 1 --output work/qa_r1.json. Si la luminosité ou la zone morte n'est pas conforme, modifiez d'abord les paramètres selon la prescription et refaites un brouillon.
  3. Exécutez review_pack.py out/draft_r1.mp4 --film film/ --out out/review_r1, dérivez un sous-agent de révision en aveugle lecture seule (ne peut lire que out/review_r1/, interdiction de voir le code source) pour une notation sur 9 dimensions.
  4. En présence de tout défaut P0/P1 ou d'une moyenne < 8.5, il est strictement interdit de produire le master 60 ips ; modifiez point par point, auto-vérifiez, re-révisez jusqu'à ce que tout soit vert.

Étape 6 : Production directe du master 60 ips avec flou de mouvement et livraison complète

  1. Une fois la révision en aveugle entièrement verte, rendez une seule fois la version finale : render.mjs film/index.html --fps 60 --blur 2 --audio work/mix.wav --out out/<Sujet>.mp4.
  2. Relancez une fois audit-qa et qa_video.py --sheet --ref-sheet, inspectez visuellement la feuille de contact finale et supprimez les brouillons temporaires out/draft*.mp4.
  3. Conformément à Lead-自媒体口播文案 et copy_template.md, terminez work/文案与封面.md et livrez à l'utilisateur l'ensemble des fichiers ainsi qu'une liste des moments de réenregistrement audio nécessitant une écoute humaine.

Limitation de débit

  • analyze-bgm, validate-lines, scaffold-project, audit-qa s'exécutent entièrement en local, sans requête réseau externe.
  • Lorsque preflight --auto-fix-fonts télécharge les fichiers .otf manquants depuis le CDN, il intègre un verrouillage de fichier OS inter-processus + limiteur de débit time.monotonic() (1,0 requête/s). En cas d'erreur 5xx, il effectue 3 tentatives avec backoff exponentiel. En cas de HTTP 429, il lève une erreur RateLimitError et interrompt la demande.

Erreurs courantes

  1. Le BOM UTF-8 PowerShell fait planter mix.py : PowerShell 5.1 écrit par défaut un en-tête EF BB BF avec Set-Content -Encoding UTF8. Tous les fichiers .json doivent être écrits par Python encoding='utf-8', l'outil cli ou [IO.File]::WriteAllText (sans BOM).
  2. Utilisation des valeurs par défaut bloom: 0.9 et mode: 'center' créant des images floues : un bloom: 0.9 sur un sujet principal à lueur linéaire fera forcément exploser bright > 3.5%, et un titre center avec un flou fixe de 14px ruinera les transitions par balayage lumineux. Il faut réduire à 0.20–0.28 selon visual-and-layout-guardrails.md et utiliser rise (blur: 0).
  3. Surcharge des Workers Chromium et "auto-évaluation" lors de la production simultanée de plusieurs vidéos : pour 3 à 4 vidéos en parallèle, limiter impérativement --workers 4. Ne jamais laisser le même contexte qui a écrit le code s'auto-évaluer et approuver le passage ; la signature doit provenir d'un sous-agent de révision en aveugle en lecture seule via le répertoire isolé out/review_rN/.

Skills associés