Communitygithub.com

YuukiMarine/websiteskills

Transformez un article ou un script de narration en une présentation web interactive 16:9 qui ressemble à une vidéo, avec option de synthèse audio. Le flux inclut la rédaction du script, un plan de développement, la construction chapitre par chapitre, et la synthèse vocale multi-fournisseur.

Qu'est-ce que websiteskills ?

YuukiMarine/websiteskills est une compétence d'agent IA conçue pour transformer un article écrit ou un script de narration en une présentation web 16:9 interactive au format vidéo. Elle fonctionne sur des plateformes comme Claude Code, Cursor ou Codex. Le processus commence par la création d'un script oral et d'un plan de développement (outline). Après une validation utilisateur portant sur 5 points (script, plan, thème, médias, mode de développement), chaque chapitre est développé indépendamment. L'animation n'est pas planifiée dans l'outline ; elle est conçue à la volée par l'agent de chapitre selon des principes de conception anti-bruit IA. L'audio peut être synthétisé via une approche agnostique du fournisseur (Minimax, OpenAI TTS, ElevenLabs, edge-tts, etc.). Le résultat final peut être enregistré en une seule prise (mode auto) pour produire une vidéo sans montage complexe. Cette compétence se concentre sur la méthodologie et le flux de travail collaboratif, et peut être réutilisée avec n'importe quel thème ou esthétique.

Compatible avec✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/YuukiMarine/websiteskills/tree/HEAD/skills/web-video-presentation

Demander à votre IA préférée

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

Documentation

Web Video Presentation

Transformez un article ou un script de narration en une présentation web 16:9 interactive qui ressemble à une vidéo, avec option de synthèse audio. Le livrable = un projet Vite + React + TS + des fichiers audio découpés par chapitre.

Cas d'utilisation

  • « J'ai un script de narration / un article, aide-moi à en faire une vidéo » — contenu piloté par la narration
  • Créer un « diaporama dynamique » (mais sans l'aspect PPT)
  • Enregistrement 16:9 en plein écran, grands caractères, espace blanc, chaque étape avec animation
  • Contenu éducatif / démo produit / keynote avec sensation cinématographique
  • Contenu pour Bilibili / YouTube / Douyin

Cette compétence est centrée sur la méthodologie et le flux de travail collaboratif. Le modèle de base fournit des jetons et des primitives, mais chaque décision esthétique (palette, typographie, type d'animation) doit être reconçue pour votre sujet — ne copiez pas.


Aperçu du flux de travail

Phase 1   Rédaction du contenu
   1.1  Identifier l'entrée utilisateur
   1.2  Produire script.md + outline.md en une seule fois
        (script de narration + plan de développement)
   ▼
[Point de contrôle Plan]      ← Doit s'arrêter. Aligner 5 éléments en une fois :
                         script / plan / thème / médias / mode de développement
   ▼
Phase 2   Développement web
   2.1  Mise en place du projet (selon le thème choisi)
   2.2  Chapitre 1 = thread principal + version complète (ancrage obligatoire)
        ▼
        [Nœud dur] Validation utilisateur du chapitre 1 ← Incontournable
        ▼
   2.3  Chapitres 2~N (selon le mode choisi : A chapitre par chapitre / B séquentiel / C parallèle)
   ▼
[Point de contrôle Audio]     ← Doit s'arrêter. Synthèse audio ?
   ▼
Phase 3   Synthèse audio (optionnelle)
   ▼
Phase 4   Enregistrement écran + post-production

Convention de répertoire de travail (l'agent crée/modifie dans le répertoire courant de l'utilisateur) :

my-video/
├── article.md          # Obligatoire si l'utilisateur fournit un texte original — ne pas supprimer ! Source d'information visuelle en phase de développement
├── script.md           # Obligatoire : script de narration localisé dans la langue originale (définit les battements)
├── outline.md          # Obligatoire : plan de développement (découpage des chapitres + contenu de chaque étape + pool d'informations)
└── presentation/       # Projet Vite + React + TS généré par le modèle
    ├── src/chapters/<NN>-<id>/
    │   ├── <Chapter>.tsx     # Implémentation visuelle
    │   ├── <Chapter>.css
    │   └── narrations.ts     # ★ Source unique de vérité pour le nombre d'étapes + texte de narration
    ├── scripts/
    │   ├── extract-narrations.ts   # Analyse tous les narrations.ts → audio-segments.json
    │   ├── synthesize-audio.sh     # Lanceur agnostique du fournisseur (boucle sur les segments)
    │   └── tts-providers/          # Un répertoire par fournisseur (2 fournisseurs intégrés)
    │       ├── README.md           # Contrat en 3 fonctions + 5 extraits de code prêts à l'emploi (11labs / edge-tts / say / azure / gcloud)
    │       ├── minimax.sh          # Fournisseur par défaut, utilise mmx-cli
    │       └── openai.sh           # OpenAI TTS intégré (curl + OPENAI_API_KEY)
    ├── audio-segments.json         # Sortie de l'extraction (à vérifier avant synthèse)
    └── public/audio/<id>/<N>.mp3   # Optionnel : fichiers audio synthétisés

Point clé : narrations.ts est la source unique de vérité pour le nombre d'étapes et la synthèse audio. Le N maximum + 1 dans if (step === N) dans chaque chapitre .tsx doit être égal à narrations.length. Cela garantit que les 5 endroits (script / plan / code du chapitre / chapters.ts / fichiers audio) ne dérivent jamais.


Protocole d'auto-vérification strict (tout au long de la compétence)

Les trois livrables suivants doivent, après chaque achèvement, passer par une auto-vérification → correction → puis rapport / avancement :

LivrableSource de la liste de vérification
script.mdSCRIPT-STYLE.md Vérification en 3 couches (forme / fond / lecture à voix haute)
outline.mdOUTLINE-FORMAT.md Auto-vérification
Implémentation d'un chapitreCHAPTER-CRAFT.md Auto-vérification d'achèvement

Mode opératoire (par ordre décroissant de capacité, privilégier la méthode la plus isolée) :

  1. Agent Teams (optimal) : Ouvrir un agent de révision indépendant, lui donner le chemin du fichier de livrable + la liste de vérification correspondante + le contexte clé, et lui demander de vérifier point par point et de rapporter strictement les conclusions (quels points sont OK / quels points sont KO + preuves + suggestions de réécriture).
  2. subAgent (second choix) : Si pas de capacités Teams mais subagent disponible, utiliser subagent avec le même processus.
  3. Auto-vérification (solution de repli) : Si l'agent actuel ne dispose d'aucune des capacités ci-dessus, vérifier strictement point par point — ne pas se contenter d'un coup d'œil.

Règle absolue : Après avoir obtenu les conclusions, corriger d'abord les éléments KO, puis signaler à l'utilisateur « terminé + conclusions de la vérification + ce qui a été modifié ». Rapporter les conclusions brutes sans correction = violation.


Guide de lecture des fichiers par phase

Différentes phases lisent différents fichiers. Dans une longue session, l'agent a tendance à oublier les principes, en particulier la phase 2.4 « implémentation d'un chapitre » qui se répète N fois — les contraintes principales doivent être revues à chaque fois.

PhaseObligatoire (à chaque fois)À lire une fois / Consulter au besoin
Phase 1.1-1.2 Rédaction contenureferences/SCRIPT-STYLE.md + references/OUTLINE-FORMAT.md + article.md (texte original, si fourni)——
Point de contrôle Plan Choix du thème——themes/*/theme.json (lire tous dynamiquement, lister + recommandation bestFor + descriptionZh) ; references/THEMES.md (quand l'utilisateur veut comprendre le système de thèmes)
Phase 2.1 Mise en place projet——SKILL.md cette section une fois
Phase 2.4 Implémentation d'un chapitre (×N fois, appelé par 2.2 / 2.3)references/CHAPTER-CRAFT.md point d'entrée unique — Part 0 dix principes / Part 1 5 questions de démarrage / Part 2 arbre de décision relation→action / Part 3 boîte à outils visuelle / Part 4 référence de durée / Part 5 anti-modes anti-IA / Part 6 règles de code strictes (contrainte obligatoire narrations.ts) / Part 7 auto-vérification achèvement / Part 8 références rapides de feedback + le themes/<id>/theme.json du thème courant + le paragraphe correspondant dans l'outline.md + le paragraphe correspondant dans article.md + la liste des médiasreferences/EXAMPLES/ (exemples de structure, pas des modèles à copier) ; references/THEMES.md contrat de jetons complet
Phase 3 Synthèse audioreferences/AUDIO.md (comprend le flux narrations.ts → segments.json → tout fournisseur, avec minimax + openai intégrés)templates/scripts/tts-providers/README.md (pour changer de fournisseur / TTS personnel)
Phase 4 Enregistrement + post-prodreferences/RECORDING.md (comprend le mode ?auto=1 pour enregistrement automatique)——
Choisir / créer / découper un thème——references/THEMES.md

Lors de l'écriture d'un chapitre, ne lire qu'un seul fichier : CHAPTER-CRAFT.md. Dix principes / auto-questionnement de démarrage / arbre de décision / anti-modes anti-IA / auto-vérification d'achèvement — tout est intégré dans ce point d'entrée unique. EXAMPLES/ n'est pas obligatoire — concevez d'abord librement selon le contenu, ne consultez que si vous êtes bloqué (consultez la « forme » via l'ancrage, ne copiez pas).


Phase 1 — Rédaction du contenu (production unique)

1.1 Identifier l'entrée utilisateur

Ce que l'utilisateur donneCe qu'il faut faire
Article original (langage écrit / blog / article académique)Produire script.md + outline.md en une fois (1.2), passer au point de contrôle Plan
Script de narration / script vidéo directSauvegarder sous script.md, produire outline.md en une fois (version simplifiée 1.2), passer au point de contrôle Plan
Rien du tout, seulement « Aide-moi à faire une vidéo sur le thème X »Demander en retour : donnez d'abord un extrait de contenu ou un plan. La compétence ne conçoit pas le contenu à la place de l'utilisateur

1.2 Produire script.md + outline.md en une seule fois

Les deux livrables sont réalisés en une seule réflexion :

  1. Générer script.md : Selon les règles de references/SCRIPT-STYLE.md, transformer l'article en un script de narration localisé dans la langue originale. Conserver article.md sans le supprimer — c'est la source de détails pour le pool d'informations du plan et les visuels des chapitres (principe des deux sources).
  2. Générer outline.md : Selon les règles de references/OUTLINE-FORMAT.md, découper en chapitres + étapes + extraire le pool d'informations pour chaque chapitre.

Limites du plan (point clé) :

Ce que le plan doit écrireCe que le plan ne doit pas écrire
Découpage des chapitres / nombre d'étapes par chapitre / estimation duréeTypes d'animation spécifiques (blur clear / wipe / spring)
Contenu de l'écran par étape (héro / données / slogan / éléments de liste)Moyens d'implémentation CSS (filter / SVG / clip-path)
Pool d'informations par chapitre : chiffres / citations / cas / étiquettes extraits de l'articleValeurs de durée (ne pas écrire 2.5s / 80120ms)
Préfixe de nom de relation par étape (« contraste de contradiction » / « liste progressive » / « phrase choc » — indice optionnel)Micro-rythmes comme micro-mouvement continu / décalage de pics

Raison pour laquelle le plan ne spécifie pas les animations : figer les animations = l'agent de chapitre devient une machine de traduction ; laisser un espace libre permet à l'agent de chapitre de concevoir librement à chaque étape selon l'« arbre de décision piloté par le contenu » de CHAPTER-CRAFT.md, pour obtenir une véritable sensation vidéo. Voir CHAPTER-CRAFT.md Part 0 Principe 7.

Après la sauvegarde, doit d'abord passer par l'auto-vérification avant d'entrer dans le point de contrôle Plan : Selon le « Protocole d'auto-vérification strict » ci-dessus, exécuter la vérification pour script.md / outline.md respectivement (priorité Agent Teams → subAgent → auto-vérification), corriger selon les conclusions, puis entrer dans le point de contrôle Plan.


Point de contrôle Plan — Aligner 5 éléments en une fois (Nœud dur)

Une fois script.md + outline.md écrits, il faut s'arrêter. L'utilisateur confirme simultanément 5 éléments à ce point de contrôle.

Travail préparatoire de l'agent à ce stade

  1. Lire tous les themes/*/theme.json pour obtenir nameZh / descriptionZh / bestFor / mood — ne pas coder en dur la liste
  2. Selon le type de contenu / mots-clés / ton de script.md, sélectionner activement 2~3 thèmes les mieux adaptés parmi les thèmes (correspondance avec le champ bestFor)
  3. Parcourir la section « Liste des médias » à la fin de outline.md

Modèle de résumé (squelette, l'agent remplit selon le cas)

Plan de contenu terminé, fichiers produits :
  📄 article.md     {si l'utilisateur a fourni un texte original}
  📄 script.md      {X} mots / ~{T} minutes
  📄 outline.md     {N} chapitres / {M} étapes + pool d'informations par chapitre + liste des médias en fin

Aperçu des chapitres :
  1. <id>     <Titre du chapitre>    <S> étapes ~<T>s
  2. ...

Prochaine étape : aligner 5 éléments en une fois :

  1. Script (script.md) à modifier ?
     Vous pouvez éditer directement le fichier, ou me décrire oralement les modifications.

  2. Plan de développement (outline.md) à modifier ? Points clés :
     - Découpage des chapitres / nombre d'étapes / estimation durée (plausible : 30~60s par chapitre)
     - Contenu de l'écran par étape clair
     - Le pool d'informations au début de chaque chapitre contient-il suffisamment de détails de l'article pour les visuels ?
     - Liste des médias en fin complète ?

  3. Quel thème choisir ? Mes recommandations :
     ★ <Recommandation 1 : nameZh (id)> — parce que <correspondance bestFor> ; <résumé descriptionZh>
     ★ <Recommandation 2 / 3>
     Autres options : <thèmes restants, nameZh + une phrase>
     Vous pouvez aussi me demander de créer un nouveau thème (voir references/THEMES.md).

  4. Comment préparer les médias réels ? Aperçu grossier des images nécessaires : <liste approximative>
     a) Je choisis parmi <chemin des médias existants>   b) Vous fournissez vous-même   c) Tous en placeholder

  5. Quel mode de développement choisir ?

     **Quel que soit le mode, le chapitre 1 doit être fait dans le thread principal et validé par l'utilisateur** (ancrage obligatoire).
     La différence porte sur les chapitres 2 et suivants :

     A) Par défaut · Chapitre par chapitre avec validation (recommandé)
        Chaque chapitre fini → pause → validation → risque contrôlé / rythme le plus stable
     B) Développement séquentiel après le chapitre 1 (pas parallèle)
        Chapitres 2~N faits séquentiellement dans le thread principal → validation unifiée à la fin → vitesse moyenne / adapté si l'agent ne supporte pas le parallélisme
     C) Développement parallèle après le chapitre 1 (subagent)
        Chapitres 2~N faits en parallèle avec subagents → plus rapide / l'utilisateur contrôle le nombre de parallélismes (combien de chapitres à la fois)
        ⚠️ Des différences de style entre chapitres sont attendues (c'est intentionnel, les interdits de thème assurent une cohérence de base)

Après réception des retours :

  • Script / plan à modifier : éditer directement le fichier, puis « ping » une fois (ou décrire oralement, l'agent modifie)
  • Le thème doit être clairement choisi pour entrer en Phase 2. Si l'utilisateur dit « Choisis pour moi » → prendre la 1ère recommandation, informer l'utilisateur du choix et de la raison, donner une chance de changer d'avis
  • Choix du mode → entrer en Phase 2

Phase 2 — Développement web

2.1 Mise en place du projet

bash <chemin-vers-web-video-presentation>/scripts/scaffold.sh \
  ./presentation \
  --theme=<id du thème choisi>

bash <chemin-vers-web-video-presentation>/scripts/scaffold.sh --list-themes

Thème personnalisé → d'abord créer un répertoire themes/<mon-theme>/ selon la procédure « Créer un nouveau thème » dans references/THEMES.md, puis --theme=<mon-theme>.

Le modèle inclut une démo 01-example. Supprimer avant d'écrire le premier chapitre réel :

rm -rf presentation/src/chapters/01-example

Puis supprimer l'import et l'entrée de EXAMPLE_CHAPTER dans presentation/src/registry/chapters.ts.

2.2 Chapitre 1 — Thread principal + validation obligatoire

Essentiel : Le chapitre 1 = version complète directement (rythme + visuels + médias réels). Pas de concept de « squelette » — le premier chapitre doit être un modèle que l'utilisateur peut valider directement.

Pourquoi le chapitre 1 doit être dans le thread principal :

  • C'est la première implémentation des consignes de CHAPTER-CRAFT.md sur le thème actuel + le sujet actuel
  • Si les consignes ont des angles morts / si les couleurs / polices du thème sont insuffisantes, le chapitre 1 les révélera — avec un retour humain, on peut corriger les consignes / ajuster le thème, le coût de correction précoce est le plus bas
  • Les chapitres suivants (séquentiels ou parallèles) doivent se référer au modèle de code du chapitre 1, donc le chapitre 1 = point d'ancrage stylistique du projet (pas d'exigence de cohérence entre chapitres, mais le chapitre lui-même doit être convaincant)

Après avoir terminé le chapitre 1, il faut s'arrêter et attendre la validation utilisateur :

Chapitre 1 <id> terminé, serveur de dev sur localhost:5173.

Points de validation :
  □ L'ambiance visuelle est-elle correcte ? Correspond-elle aux attentes du <nom du thème> ?
  □ Le rythme est-il correct ? Certaines étapes trop rapides / trop lentes / informations trop minces ?
  □ Les animations sont-elles pilotées par le contenu ? Ou certaines étapes n'ont-elles que des animations d'entrée génériques ?
  □ Principe des deux sources : l'écran montre-t-il des détails que la narration ne mentionne pas mais que l'article peut fournir ?
  □ Vérification anti-modes IA : dégradé violet-rose, bordures arrondies colorées, fausses illustrations, emojis ?

Dites-moi les problèmes, je les corrige ciblément. Quand c'est OK, dites « continue », je ferai le chapitre 2 et les suivants selon le mode choisi.

2.3 Chapitres 2~N — Selon le mode choisi

Règles communes à tous les modes : Chaque chapitre est développé indépendamment selon CHAPTER-CRAFT.md. La cohérence stylistique entre chapitres n'est pas exigée — les jetons de couleur / police du thème assurent une unité visuelle de base ; les animations / rythme / démonstration visuelle sont laissés à la liberté de chaque chapitre, c'est intentionnel.

Mode A · Par défaut · Chapitre par chapitre avec validation

Chapitre 2 terminé → pause → validation → OK → Chapitre 3 → pause → ... → Chapitre N. Chaque chapitre est validé indépendamment, problèmes corrigés à tout moment, risque le plus bas, rythme le plus stable. Mode par défaut si l'utilisateur ne choisit pas explicitement.

Mode B · Développement séquentiel après le chapitre 1

Chapitre 2 → Chapitre 3 → ... → Chapitre N faits séquentiellement dans le thread principal, validation unifiée à la fin. Vitesse moyenne, adapté si l'agent ne supporte pas le parallélisme.

Mode C · Développement parallèle après le chapitre 1 (subagent)

Utiliser des subagents pour faire les chapitres 2~N en parallèle, nombre maximal de parallélismes contrôlé par l'utilisateur (« 4 chapitres à la fois » / « 2 chapitres à la fois »). Le plus rapide, mais des différences de style entre chapitres sont attendues — c'est intentionnel, car :

  1. Chaque subagent ne voit pas la production des autres subagents, impossible d'aligner mécaniquement
  2. Le code des chapitres est physiquement séparé (un dossier par chapitre / préfixe CSS propre), pas d'interférence
  3. Les jetons de thème assurent l'unité visuelle de base (couleur / police / chiffres héro / cartes / traits de séparation / décoration), l'ambiance ne dérive pas
  4. Incohérence de style = sensation de respiration d'une vidéo écrite à la main (plusieurs voix / plusieurs perspectives)

Le prompt du subagent parallèle doit inclure :

  • Le paragraphe correspondant du plan (avec pool d'informations)
  • Le chemin vers references/CHAPTER-CRAFT.md (lecture unique obligatoire — exigences de démonstration visuelle + révélation progressive + principe des deux sources + anti-modes IA + règles de code + auto-vérification d'achèvement, tout dans ce fichier)
  • descriptionZh / mood / bestFor du theme.json du thème actuel (pour référence d'ambiance, les animations / durée / taille de police / emojis sont librement déterminés par l'agent de chapitre)
  • Le code du chapitre 1 comme référence de « style de code » (pas comme « objet de copie visuelle »)
  • Règles strictes : chaque chapitre a un préfixe CSS indépendant (.cd- / .mg- / .pm- / ...) ; ne pas modifier chapters.ts ; exécuter npx tsc --noEmit à la fin

Important : Quel que soit le mode choisi, l'utilisateur peut changer de mode à tout moment. Après le chapitre 2, l'utilisateur peut dire « faites le reste en parallèle » / « faites le reste chapitre par chapitre ».

2.4 Implémentation d'un chapitre (à chaque chapitre)

Instructions détaillées dans references/CHAPTER-CRAFT.md — point d'entrée unique obligatoire, couvrant : exigences de démonstration visuelle / révélation progressive / sélection du contenu / principe des deux sources / esthétique de base de la démonstration vidéo / anti-modes IA / règles de code / auto-vérification d'achèvement.

Points essentiels (détaillés dans CHAPTER-CRAFT.md) :

  • Chaque chapitre doit avoir une démonstration visuelle CSS / SVG / Canvas / JS, pas de chapitre purement textuel
  • Révélation progressive : les listes / énumérations doivent avoir 1 élément = 1 étape, pas d'affichage unique de N éléments
  • Principe des deux sources : le rythme suit le script (ordre immuable), les détails reviennent à l'article original (pool d'informations + paragraphe de l'article pour ce chapitre)
  • Auto-vérification d'achèvement point par point, retour en arrière si non conforme — selon le « Protocole d'auto-vérification strict » ci-dessus (priorité Agent Teams → subAgent → auto-vérification), rapporter la livraison du chapitre à l'utilisateur après correction

2.5 Bump STORAGE_KEY après une modification majeure

Après une modification de chapters.ts (ajout / suppression / réorganisation de chapitres, ou changement de longueur d'un narrations.ts d'un chapitre), bump la STORAGE_KEY dans presentation/src/hooks/useStepper.ts (par exemple v4 → v5) pour éviter que le curseur persistant n'atterrisse sur une étape inexistante.


Point de contrôle Audio — Synthèse audio ? (Nœud dur)

Après la fin de la Phase 2, il faut s'arrêter et demander à l'utilisateur :

Page web terminée, {N} chapitres {M} étapes, serveur de dev sur localhost:5173.

Faut-il synthétiser l'audio pour un enregistrement « lecture automatique » ?
  ✓ Synthèse → analyse tous les narrations.ts des chapitres → audio-segments.json,
            appelle le fournisseur TTS pour synthétiser chaque étape en un mp3 dans public/audio/.
            Après synthèse, le mode ?auto=1 permet un enregistrement en une seule prise (audio et vidéo naturellement synchronisés).
            Deux fournisseurs intégrés :
             • minimax (mmx-cli)    — par défaut, bonne stabilité pour le chinois
             • openai  (OPENAI_API_KEY) — basé sur curl, beaucoup ont déjà une clé
            Autres backends (ElevenLabs / edge-tts gratuit / macOS say hors ligne /
           Azure / Google) voir les extraits prêts à l'emploi dans scripts/tts-providers/README.md.
  ✗ Pas de synthèse → passer Phase 3, aller directement en Phase 4 pour un enregistrement manuel + doublage post-production.

Souhaite synthèse → Phase 3. Pas de synthèse → directement Phase 4.


Phase 3 — Synthèse audio (optionnelle)

Processus détaillé dans references/AUDIO.md. Version simplifiée :

cd presentation
npm run extract-narrations   # analyse tous les narrations.ts → audio-segments.json
# Laissez l'utilisateur vérifier rapidement audio-segments.json pour confirmer le texte
npm run synthesize-audio                       # par défaut fournisseur minimax, incrémental
# Ou utiliser le fournisseur openai intégré (nécessite OPENAI_API_KEY) :
PRESENTATION_TTS=openai npm run synthesize-audio
# Ou personnalisé : écrire un scripts/tts-providers/<nom>.sh, voir README.md de ce répertoire

Après synthèse, informer l'utilisateur : emplacement de sortie / nombre total de segments / segments avec durée anormale (trop long = diviser l'étape ; trop court = texte trop mince) — donner une dernière chance de calibrer le rythme. Puis entrer en Phase 4.


Phase 4 — Enregistrement écran + post-production

Voir references/RECORDING.md pour les détails. Deux chemins :

ScénarioChemin recommandé
Phase 3 : audio synthétiséMode Auto en une seule prise : ouvrir localhost:5173/?auto=1 dans le navigateur → appuyer sur ESPACE → la vidéo se lit automatiquement → arrêter l'enregistrement → couper le début et la fin → vidéo finale, aucun montage audio nécessaire
Phase 3 ignoréeMode Manuel par défaut : cliquer pour avancer → doublage dans n'importe quel outil de montage en post-production

Après la Phase 3 / Point de contrôle Audio, l'agent informe activement l'utilisateur du chemin d'enregistrement adapté.


Dix principes (liste en une phrase)

Le développement complet se trouve dans references/CHAPTER-CRAFT.md Part 0 — consultez cette section lors de l'écriture d'un chapitre, ce qui suit n'est qu'un index.

#PrincipeEn une phrase
1Cadre fixe 16:9Contenu 1920×1080 + transform scale, pas de responsive
2Compteur global d'étapesLe chapitre est une fonction pure de l'étape, pas de minuteur
3Chaque étape occupe tout l'écranif (step === N) return <FullScene />
4Battement de narration = étapeUn battement = une étape = une idée focalisée
5Contrôles d'angle cachésBarre de progression / boutons de navigation : opacity 0 par défaut
6Pas de chrome sur la scènePas d'en-tête / pied de page / numéro de page / barre de marque
7Animation pilotée par le contenuChercher d'abord l'action intrinsèque, seulement si introuvable → animation d'entrée comme solution de repli ; micro-mouvement continu à utiliser avec parcimonie
8Révélation point par point1 élément = 1 étape, pas de stagger synchrone de N éléments
9Même thème pour toute la vidéoPas de changement de couleur de fond entre chapitres ; couleurs / polices via jetons, les autres dimensions sont libres par chapitre
10Principe des deux sourcesLe script définit le rythme, l'article définit la densité visuelle (qui atterrit dans le pool d'informations)

Références rapides pour les retours utilisateur courants

Tableau simplifié dans references/CHAPTER-CRAFT.md Part 8 « Références rapides pour les retours courants ». Point clé : d'abord identifier le niveau (rythme / visuel / contenu / code), puis modifier la plus petite tranche, ne pas refaire tout le chapitre.


Ressources associées

Marquées par « Quand lire », pour éviter de tout lire en une fois :

FichierQuand lireContenu
references/SCRIPT-STYLE.mdObligatoire Phase 1.2Règles article → script de narration, variantes de plateforme
references/OUTLINE-FORMAT.mdObligatoire Phase 1.2Spécifications des champs outline.md, conventions de nommage, découpage des chapitres, pool d'informations
references/CHAPTER-CRAFT.mdPoint d'entrée unique obligatoire Phase 2.4 pour chaque chapitrePart 0 10 principes / Part 1 5 questions de démarrage / Part 2 arbre de décision relation→action / Part 3 boîte à outils visuelle / Part 4 durée / Part 5 anti-modes anti-IA / Part 6 règles de code / Part 7 auto-vérification achèvement / Part 8 références rapides feedback
references/EXAMPLES/Optionnel — pour voir la structureExemples de structure de chapitre (hook / list-reveal / case-tech-review) ; pas des modèles à copier
references/THEMES.mdLors du choix / création / découpage d'un thèmeContrat de jetons complet + liste des thèmes intégrés + processus de création
references/AUDIO.mdLire seulement en Phase 3Processus de synthèse audio agnostique du fournisseur, utilisation de minimax intégré, chemin pour changer de fournisseur, dépannage
templates/scripts/tts-providers/README.mdLors du changement / ajout d'un fournisseur TTSContrat en 3 fonctions + 2 fournisseurs intégrés (minimax / openai) + 5 extraits de code prêts à l'emploi (ElevenLabs / edge-tts / macOS say / Azure / Google)
references/RECORDING.mdLire seulement en Phase 4Outils d'enregistrement écran + montage post-production
themes/Consulter au point de contrôle Plan / Phase 1.2Thèmes intégrés (chacun avec theme.json + tokens.css)
scripts/scaffold.shExécuter une fois en Phase 2.1Modèle de projet en une commande

Crédits et licence

Ce fichier fait partie du dépôt YuukiMarine/websiteskills. Veuillez consulter le dépôt d'origine pour les licences et attributions.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills associés