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 deAzenYes/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 deAzenYes/leaderai-media-toolkit.uv(uv run) : exécute le script CLI auxiliairescripts/sci_glow_cli.pyutilisant uniquement la bibliothèque standard.- Compétences de recherche scientifique optionnelles (utilisées en priorité si installées) :
pubmed-databaseouliterature-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-commande | Rôle principal | Paramètres obligatoires clés |
|---|---|---|
preflight | Vé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-project | Cré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-bgm | Dé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-lines | Valide/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-qa | Appelle 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
- 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. - 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-自媒体口播文案)
- 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.
- 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. - Générez dans
口播文案输出/<YYYYMMDD Sujet Scientifique>/le fichier texte brut.txtet le plan d'exécution.md.
Étape 2 : Alignement spectral BGM et verrouillage précis des sous-titres
- Exécutez
analyze-bgm --bgm <path> --target-duration <T> --top-k 3 --output work/bgm.jsonpour sélectionner le meilleurmusic_start_sec, et utilisezwork/beats.jsonviabeats.pyamont. - Écrivez
work/lines.json: calez le titreT.atsur Drop 1, la criseatsur Breakdown, le moment de percéeatsur Drop final climax, et laissez de la place pour une image de retour en fin de morceau. - 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écuteztimeline.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.cornerdésactivé,scenes.jsenveloppé dans une IIFE, titres de transition avecmode: 'rise', blur: 0et décalage+0.36s.
- Exécutez d'abord
scaffold-projectpour créer les double répertoires. - Concevez une palette de couleurs sans conflit, et écrivez manuellement 3 à 5 couches de primitives lumineuses fines dans
film/core.jspour 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). - Écrivez
film/scenes.js,film/index.htmletfilm/cover.html, puis faites passer les tests de sous-ensemblefonts.py film/et de vérification zéro-incrémentverify.mjs film/index.html --tol 24.
Étape 4 : Mixage avec ducking et vérification des zones de sécurité des doubles couvertures 4K
- Écrivez
work/cues.jsonsans BOM UTF-8, exécutezsfx.py --variants 3etmix.py(en renseignant--music-startet--music-dipsdonnés paranalyze-bgm, alignement-14.0 LUFS / -1.5 dBFS). - Exécutez
cover.mjs film/cover.html --out out --name <Sujet> --guides, inspectez visuellement les images danswork/封面检查/, assurez-vous que les informations clés en mode paysage sont strictement dans le4:3central (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.
- 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). - 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. - 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 queout/review_r1/, interdiction de voir le code source) pour une notation sur 9 dimensions. - 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
- 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. - Relancez une fois
audit-qaetqa_video.py --sheet --ref-sheet, inspectez visuellement la feuille de contact finale et supprimez les brouillons temporairesout/draft*.mp4. - Conformément à
Lead-自媒体口播文案etcopy_template.md, terminezwork/文案与封面.mdet 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-qas'exécutent entièrement en local, sans requête réseau externe.- Lorsque
preflight --auto-fix-fontstélécharge les fichiers.otfmanquants depuis le CDN, il intègre un verrouillage de fichier OS inter-processus + limiteur de débittime.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 erreurRateLimitErroret interrompt la demande.
Erreurs courantes
- Le BOM UTF-8 PowerShell fait planter
mix.py: PowerShell 5.1 écrit par défaut un en-têteEF BB BFavecSet-Content -Encoding UTF8. Tous les fichiers.jsondoivent être écrits par Pythonencoding='utf-8', l'outilcliou[IO.File]::WriteAllText(sans BOM). - Utilisation des valeurs par défaut
bloom: 0.9etmode: 'center'créant des images floues : unbloom: 0.9sur un sujet principal à lueur linéaire fera forcément exploserbright > 3.5%, et un titrecenteravec un flou fixe de 14px ruinera les transitions par balayage lumineux. Il faut réduire à0.20–0.28selon visual-and-layout-guardrails.md et utiliserrise(blur: 0). - 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/.