Explication courte (9:16, ~60-90 s, voix thaï, n'importe quel sujet)
Procédure pour une vidéo explicative verticale : actualités, revue d'un outil ou d'un dépôt, concept, tutoriel ou démo de quelque chose que le propriétaire a construit. Les mécanismes de construction et le portage de style se trouvent dans la compétence create-video ; chargez-la avant l'étape 4. Moteurs vocaux et leurs particularités : references/voice-options.md.
Nécessite : bun, ffmpeg/ffprobe, python3, et pour measure_ink.py Pillow + numpy (uv run --with pillow --with numpy ...). Le polissage du texte thaï utilise les compétences kien-thai et kode-thai (npx skills add chakrit/kien-thai).
Valeurs par défaut (pas besoin de redemander)
- 9:16, 1080x1920, 8-10 séquences, environ 60 s (les Shorts acceptent jusqu'à 3 min ; un script lu par le propriétaire fait généralement 80-90 s)
- Style : le dernier style Atlas que le propriétaire a approuvé. Kits dans le modèle : Stylo bille (
src/style/ballpoint.js, window.BP) et Tableau blanc (src/style/whiteboard.js, window.WB). Un nouveau style nécessite l'invite Futurepedia AI Style Atlas collée. - Visuels dessinés en code. Uniquement les logos réels pour le sujet et comme crédits sources. Pas de photos d'actualité. Exception : lorsque le sujet est une démo web en direct, mélangez des captures d'écran réelles que vous capturez vous-même pour les séquences « voyez-le fonctionner » avec des séquences dessinées pour le mécanisme.
- Voix : le propriétaire l'enregistre lui-même. Remettez
read-script.md, il dépose un enregistrement,scripts/split_recording.pyouscripts/assemble_takes.pydécoupe en séquences. Voix synthétiques uniquement s'il le demande (references/voice-options.md). - Pas d'emoji, pas de clés API, citez les sources.
Choisissez d'abord la forme de l'histoire
Formes et modèles de séquences : templates/story-shapes.md.
| Forme | Utilisation | Re-vérification en direct |
|---|---|---|
| Actualité | Quelque chose s'est produit, peut encore se produire | Oui, avant le rendu |
| Revue / démo d'outil | Un dépôt, une application ou un produit : ce qu'il fait et l'accroche | Exécutez-le vous-même |
| Concept | Comment quelque chose fonctionne | Non |
| Tutoriel | Étapes pour faire quelque chose | Non, mais testez les étapes |
Étapes et points d'approbation
- Choix du sujet. Privilégiez les histoires avec un mécanisme à dessiner plutôt que les actualités de type « qui a fait quoi » ; évitez les scandales/potins et les procès récents sans rien à expliquer. Donnez 3-4 choix classés avec pourquoi, et précisez qu'ils proviennent de titres non encore vérifiés. Vérifiez
dated'abord.- Fraîcheur : un clip d'actualité qui ne peut pas être livré dans les ~1-2 jours suivant l'événement est périmé ; dites-le avant d'investir. Proposez plutôt : attendre le suivi principal (par exemple un rapport post-incident), ou reformuler en clip Concept intemporel en utilisant l'incident comme exemple.
- Recherche. Lisez la source principale (dépôt, documentation, page de statut, publication officielle) plus d'autres médias. Gardez trois étiquettes distinctes : vérifié par moi / revendiqué par la source / mon interprétation.
- Problèmes/briefs de transfert : vérifiez chaque affirmation « état actuel » par rapport à l'état en direct (la PR est-elle fusionnée, l'URL est-elle active, le fichier est-il à l'endroit indiqué). Lisez les fichiers depuis GitHub (
gh api repos/O/R/contents/PATH -H 'Accept: application/vnd.github.raw') plutôt que de tirer ou vérifier le dépôt local du propriétaire. - Démos : exécutez la chose réelle dans un navigateur, reproduisez les chiffres indiqués et mesurez les tailles des ressources (
curl -sIL ... content-length) au lieu de vous fier aux estimations codées en dur dans la source. Signalez les écarts dans un tableau affirmation/réalité. - Affirmations « pas de serveur » / vie privée : listez les requêtes réseau de la page (
performance.getEntriesByType('resource')). Les balises d'analyse d'hébergement (par exemple Cloudflare/cdn-cgi/rum) apparaissent dans une capture DevTools ; filtrez pour les récupérer ou expliquez-les à l'écran.
- Problèmes/briefs de transfert : vérifiez chaque affirmation « état actuel » par rapport à l'état en direct (la PR est-elle fusionnée, l'URL est-elle active, le fichier est-il à l'endroit indiqué). Lisez les fichiers depuis GitHub (
- Script à partir du modèle de la forme, nombres en toutes lettres, longueur atteinte en supprimant des mots jamais en accélérant. Écrivez
read-script.md(séquences numérotées, une respiration chacune).- Actualité = pyramide inversée : la séquence 1 est un lead complet (qui, a fait quoi, quand) qui se suffit à lui-même ; puis du plus important au moins important ; attribuez chaque affirmation (« X ระบุว่า », « ด้าน ... เชื่อว่า ») ; pas d'opinion ni de morale dans la voix, les conclusions vont dans la légende.
- Les crédits et URL requis par le brief vont dans la dernière séquence et à l'écran.
- Polissez avec
kien-thaivia la bouclekode-thai: auditez, citez les slugs de règles, corrigez, relisez, répétez jusqu'à ce qu'une passe ne trouve rien. Explicateurs parlés par le propriétaire = registre blog personnel, masculin : ผม, ครับ seulement à la signature, คุณ pour le spectateur, เรา pour l'équipe. Correctifs récurrents dans les brouillons de modèle : เรา dérivant entre le constructeur et le spectateur (deixis-continuity), ทิ้ง pour « drop » (verb-calque), le « ไม่ใช่ X เป็น Y » sans ต่างหาก (f4/targhak-closure), mélange เมกะ/เมกะไบต์ (une forme par terme), ก็เลย/พอ répété entre séquences adjacentes.
- Voix -> PORTE 1 (le propriétaire écoute). Instructions d'enregistrement (QuickTime > Fichier > Nouvel enregistrement audio, Qualité Maximale, pas les AirPods ; ou Mémos vocaux iPhone + AirDrop) : pause ~2 s entre les séquences, nettement plus longue qu'une respiration (les écarts auto-enregistrés étaient de 0,6-0,9 s, comme les respirations en milieu de phrase, donc aucun seuil ne les a divisés en exactement N) ; relisez immédiatement une séquence ratée ; lisez les noms anglais naturellement. Proposez de vérifier d'abord un test de 10 s de la séquence 1.
- Trouvez l'enregistrement : il peut déposer plusieurs fichiers (prises) dans un sous-dossier et dire seulement « fini ». Cherchez récursivement dans le dossier du projet plus
find ~ -mmin -30 -iname '*.m4a', puis par fichier rapportez la durée, la moyenne/maxvolumedetectet la carte des silences avant de couper. Mettez les chemins entre guillemets dans les boucles (les noms Mémos vocaux contiennent des espaces). - Un fichier :
python3 split_recording.py <fichier>; il s'arrête sauf s'il trouve exactement N séquences. Si aucun seuil ne donne le bon nombre, ne forcez pas une coupe : demandez les heures de début approximatives des séquences et découpez chaque coupe au silence le plus proche. - Plusieurs fichiers / reprises : demandez quel fichier correspond à quelle séquence, puis
assemble_takes.pyavec untakes.jsonde {fichier, début, fin} par séquence. Divisez un fichier multi-séquences à ses silences les plus longs et vérifiez chaque coupe par rapport au débit de parole des fichiers à une séquence (~11 caractères thaïs/s) ; signalez les séquences dont le temps de voix est >20 % plus court (mots possibles sautés). Il égalise le niveau de chaque séquence (beat_lufs), raccourcit les pauses en milieu de phrase àmax_pauseen coupant le milieu de chaque pause (ffmpegsilenceremovefait à peine cela), puis compresse avant loudnorm (crête de parole ~22 dB ; atterrit près de -18 LUFS à TP -1,5).
- Trouvez l'enregistrement : il peut déposer plusieurs fichiers (prises) dans un sous-dossier et dire seulement « fini ». Cherchez récursivement dans le dossier du projet plus
- Storyboard -> PORTE 2 (le propriétaire approuve). Images fixes à l'heure de fin de chaque séquence sous forme d'une planche contact plus des PNG pleine résolution. Listez tout ce qui est supposé ou illustratif.
- Mesurez le cadrage à partir des pixels, jamais à l'œil (un coup d'œil a déjà manqué un décalage uniforme vers la droite).
scripts/measure_ink.py --z .. --camx .. --camdy .. stills...ajuste l'encre de chaque séquence à l'intérieur de la zone de sécurité TikTok/Reels x 140-940, y 230-1500 (le contenu déborde sous l'UI de l'application) et imprime les CAMXS/CAMDY/ZS corrigés ; un passage de re-mesure laisse >= 8 px de marge. Livrez unstoryboard-sheet-safezone.pngavec les bandes non sécurisées teintées (ffmpegdrawbox). - Prenez chaque image fixe juste après la DERNIÈRE marque de cette séquence (sa fin d'IO), pas à début-de-séquence-suivante moins une constante : une séquence qui se termine tôt défile déjà et les mesures sont complètement fausses.
- Affichage des erreurs d'OCR / de reconnaissance de texte : les polices thaïes sans boucle (Sriracha, Mali, la plupart des polices UI) dessinent น comme u latin et บ/ป comme U, donc une lecture erronée comme
Qนotationa L'AIR correcte à l'écran et pour les vérifications visuelles. Vérifiez les chaînes via le texte JS, pas les captures d'écran ; dessinez les lectures erronées en Itim (bouclée, OFL, incluse dans le modèle) et encerclez le glyphe inversé à l'aide de measureText.WB.mTextprend une couleur hexadécimale : passezB.hexOf(RED), pas le tableau RGB.
- Mesurez le cadrage à partir des pixels, jamais à l'œil (un coup d'œil a déjà manqué un décalage uniforme vers la droite).
- Rendu et vérification.
bun run render <slug>. Images == durée x 30 ; LUFS de la voix dans le mp4 == fichier vocal (narration multiplexée) ; score ~20+ dB sous la voix ; images fixes en cours de dessin (pas les fins de séquence) pour vérifier que le stylo repose sur l'encre et que rien ne sort de la zone de sécurité. Pour les actualités, relisez d'abord la source principale et mettez à jour l'horodatage à l'écran. - Livraison dans
~/Downloads/<slug>-video/: mp4 complet,-small.mp4(CRF 24), wav de la musique, légendes depuistemplates/captions.md. Donnez les chemins absolus. - Publication. Ne publiez jamais publiquement pour le propriétaire. Si vous téléchargez pour lui, réglez sur Privé et cochez « Contenu modifié ou synthétique » de YouTube uniquement lorsque la voix est synthétique ; c'est lui qui appuie sur Publier. Sinon, donnez un kit prêt à copier-coller : chemin du fichier, titre, description, paramètres à cocher.
Structure
scripts/new_short.sh <slug> [--out dir] [--from template] [--kits dir] [--no-install] copie le template/ fourni (Itim + polices thaïes, caméra zone de sécurité, scripts de rendu/d'images fixes, vidéos de référence) dans ~/Videos/shorts/<slug>/ (ou $SHORT_VIDEOS_DIR), conserve les vidéos précédentes comme _reference_* à adapter, et copie les outils vocaux dans <slug>/voice/. Les dépendances s'installent automatiquement (--no-install les saute). Passez --from <un projet terminé> pour commencer à partir de votre dernier clip approuvé.
Le matériel Futurepedia Style Atlas (bibliothèque H, kit SOUND, invites et les kits Stylo bille/Tableau blanc portés à partir de leur code de référence) n'est PAS dans cette compétence — il appartient à Futurepedia. new_short.sh le copie depuis $CODE_MOTION_KITS (par défaut ~/Videos/shorts/_kits/{src/lib,src/style,prompts}). Sans cela : sauvegardez l'invite Atlas dans proj/prompts/, bun run extract-kit prompts/<style>.md, puis portez le style (create-video). Ne commitez jamais ces fichiers.