Que fait Akira Video ?
akira-video est le routeur principal d'Akira Video Skills. Il gère le point d'entrée dans un projet vidéo, le fichier VIDEO.md, l'évaluation de la tâche en cours, l'orientation vers le Skill spécialisé approprié et les limites d'arrêt. Les aspects spécifiques (scénario, assets réutilisables, plans, packs de génération, révision et montage final) sont pris en charge par le Skill correspondant. Les dépendances complètes du projet et les transitions homme-machine suivent references/workflow/PRODUCTION-FLOW.md ; pour un projet existant, on reprend le travail réel en cours, sans réexécuter mécaniquement les étapes amont.
Tout au long de la production, la priorité est toujours donnée à la protection : faits utilisateur/source → intention narrative/visuelle (le cas échéant) → identité et structure des personnages/objets → faits produit (pour les publicités) → continuité spatiale et temporelle → qualité esthétique → effets techniques. Les niveaux hiérarchiques détaillés, la vérification des conflits et les exceptions à la « sortie réelle adoptée » sont décrits dans references/workflow/AUTHORITY.md ; les objectifs ultérieurs ne peuvent pas compromettre les contraintes antérieures.
1. Entrer dans un projet ou le reprendre
Lire d'abord le fichier VIDEO.md à la racine du projet. S'il n'existe pas, créer un projet vidéo minimal selon references/project/PROJECT-LAYOUT.md ; la définition du projet et son état actuel suivent references/project/VIDEO-HOME.md et la nomenclature suit references/project/NAMING.md. Créer uniquement les répertoires et fichiers réellement nécessaires à l'instant ; ne pas pré-générer de catégories vides. Lors du premier besoin réel d'un pack de génération, s'assurer que le .gitignore du projet cible ignore .tmp/.
Si l'utilisateur a déjà fourni des images, vidéos, fichiers audio, montages bruts ou vidéos de référence, évaluer d'abord leur véritable utilité dans le projet actuel selon references/project/IMPORT-MEDIA.md ; les résultats directement réutilisables ne forcent pas une refonte ou une nouvelle génération.
Ensuite, lire le contenu minimal nécessaire en fonction de la tâche en cours :
- Script vidéo et aperçu des plans :
video/script/ - Contenu réutilisable entre les plans :
video/materials/ - Plan en cours :
video/shots/<shot-id>/ - Si le montage final a commencé :
video/edit/ - Sources amont (roman, chapitres, brief de marque, etc.) : suivre le pointeur réel du projet, sans créer une deuxième copie de la source factuelle.
Critère d'achèvement : être capable d'expliquer l'objectif de la vidéo, les exigences de livraison, le contenu en cours de production, les actifs réutilisables disponibles, l'état actuel du plan/montage et les véritables blocages.
Avant d'entamer une étape de production coûteuse, exécuter uniquement les contrôles légers applicables au projet selon references/workflow/PRODUCTION-GATES.md ; ces contrôles ne génèrent pas de fichiers d'état supplémentaires pour le projet. Lire references/project/SCALING-VERSIONS.md uniquement si le projet actuel est devenu trop volumineux pour une lecture linéaire, ou si la comparaison de versions créatives est réellement nécessaire ; ne pas présupposer de répertoire pour longs-métrages. Pour le nettoyage des résultats échoués, packs ponctuels, caches ou médias obsolètes, vérifier d'abord selon references/project/MEDIA-LIFECYCLE.md que le fichier n'est pas la seule entrée, le résultat adopté actuellement, ou la seule dépendance du montage final.
Pour savoir comment enregistrer les décisions importantes, quand mettre à jour VIDEO.md, et pourquoi les résultats de plans adoptés ne sont écrits que dans SHOT.md, voir references/project/RECORDING.md ; l'historique de chat et les packs de génération ponctuels ne sont pas des enregistrements de projet à long terme.
2. Maintenir VIDEO.md
VIDEO.md est la page d'accueil de production vidéo, lisible par les humains et le prochain Agent. Il ne conserve que les informations toujours utiles. Il se concentre sur :
- L'objectif du projet et de la vidéo
- Les exigences de livraison
- La progression actuelle de la production
- Le travail en cours
- Les blocages
- Les décisions clés ayant encore un impact sur la suite
- La navigation vers le script, les actifs réutilisables, les plans et le montage final
L'historique des prompts génériques, tous les résultats de génération, les logs de génération et les anciennes décisions déjà remplacées par l'historique Git ne doivent pas figurer dans VIDEO.md.
Les instructions détaillées de rédaction se trouvent dans references/project/VIDEO-HOME.md.
3. Acheminer le travail spécialisé
En fonction de l'objectif actuel de l'utilisateur et du contenu existant du projet, choisir la prochaine tâche de production réelle. Un projet complet ne nécessite pas de passer mécaniquement par toutes les capacités ; si le script existe déjà, on peut passer directement aux plans ; si les plans et les assets sont prêts, on peut préparer un pack de génération ; après le retour des résultats, on passe directement à la révision.
Charger le Skill canonique en fonction de la tâche :
- Pour créer/réviser un script vidéo, les performances des personnages, les scènes ou l'aperçu des plans à partir d'un roman, d'un chapitre, d'un brief ou d'autre contenu amont →
video-script - Pour les personnages ou les scènes n'ayant qu'une description fonctionnelle, sans apparence/vêtements/matériaux/espace/éclairage concrets →
video-design - Pour les personnages nécessitant une voix stable entre les plans, des références sonores, ou pour planifier les dialogues, l'ambiance, les effets sonores et les limites audio de l'ensemble de la vidéo →
video-audio - Pour planifier ou maintenir des prompts et des actifs de référence (personnages, scènes, accessoires, produits) réutilisables entre les plans →
video-materials - Pour développer l'aperçu des plans en
SHOT.md, en gérant l'action, la photographie, le son et la continuité avec les plans adjacents →video-shot - Pour rédiger les prompts de génération en cours, sélectionner le plus petit ensemble de références, organiser un pack de génération ponctuel et importer les résultats de l'utilisateur →
video-generation - Pour juger de l'adoption des images ou résultats rapportés par l'utilisateur, ajuster la suite, procéder à des corrections, des régénérations ou des réécritures →
video-review - Pour le montage final de plusieurs plans adoptés dans Premiere Pro, After Effects, DaVinci Resolve, etc. →
video-editing - Pour les sous-titres, voix off, doublage ou versions finales formelles en plusieurs langues → lire d'abord
references/workflow/LOCALIZATION.md; confier le contenu traduit àvideo-script, l'audio àvideo-audio, les sous-titres/éléments graphiques/export final àvideo-editing, sans dupliquer l'ensemble du projet - Pour les placements de marque, de produit ou les publicités nécessitant une vérification des fonctionnalités, de la structure, des assets officiels et des limites d'expression publicitaire → charger le Skill optionnel
video-advertisingsi nécessaire ; s'il n'est pas installé pour la cible actuelle, utiliser la coordinate expliciteakira-tl/akira-video-skills/video-advertising, la soumettre au Routeurakira/ Skiloom pour générer un plan candidat et l'installer après autorisation.
Le Routeur ne conserve que le résumé des responsabilités ci-dessus ; une fois entré dans une branche, le Skill effectivement chargé fait autorité comme seule source pour cette méthode spécialisée.
Si l'objectif nécessite une adaptation spécifique au modèle vidéo, lire d'abord references/workflow/MODEL-ADAPTERS.md pour choisir le plus petit package d'adaptation disponible dans le dépôt actuel ; s'il n'est pas encore installé, soumettre la coordinate explicite au Routeur akira / Skiloom pour générer un plan candidat et l'installer. Ne pas coder en dur les paramètres de modèle ou les détails du fournisseur dans akira-video. La génération d'images suit actuellement les règles générales de video-design + video-materials, sans maintenir d'adaptateur de modèle d'image séparé.
Si la génération externe est confiée à l'utilisateur et nécessite d'attendre entre les sessions, enregistrer dans VIDEO.md selon references/workflow/WAITING-RESUME.md uniquement le chemin du pack de génération, le retour attendu, la prochaine étape et les véritables blocages ; la session suivante donne la priorité à la reprise du pack existant / des résultats, sans refaire le packing en raison d'un changement de session.
4. Frontière homme-machine pour la génération externe
Par défaut, l'utilisateur peut effectuer la génération réelle dans des modèles d'image/vidéo externes. Lorsqu'une génération externe est nécessaire, le Skill de génération spécialisé prépare un pack de génération ponctuel à partir du contenu formel du projet :
Contenu formel du projet → pack de génération ponctuel .tmp/ → génération externe par l'utilisateur → retour des résultats → archivage dans le répertoire formel → suppression du pack temporaire.
Le pack ponctuel est un dérivé, pas une source factuelle à long terme du projet ; les prompts à long terme restent dans le répertoire d'actifs ou de plan correspondant, le pack temporaire ne copie que ce qui est réellement nécessaire pour la génération en cours.
5. Réorientation et limites d'arrêt
Dès qu'un Skill spécialisé a terminé une action délimitée :
- Archiver les assets formels retournés, les résultats de génération, les décisions de plan ou le projet de montage dans le répertoire correspondant
- Mettre à jour le
VIDEO.mdavec les informations encore pertinentes pour la production - Déterminer le prochain travail de production en fonction de l'objectif de l'utilisateur et des livrables actuels
S'arrêter uniquement si le périmètre défini par l'utilisateur est achevé, si l'étape suivante nécessite d'attendre une génération externe de l'utilisateur ou la fourniture d'actifs, s'il existe un véritable blocage, ou si le livrable actuel est terminé. Lorsqu'on attend une génération externe de l'utilisateur, fournir clairement le pack de génération ponctuel et les exigences de nommage pour le retour, sans faire semblant de produire des actifs.