OmniFlow Studio Agent Skill

Compétence d'Agent OmniFlow Studio

Cette compétence donne aux agents de codage et d'orchestration IA un contrôle direct sur OmniFlow Studio — un pont autonome connectant des agents IA locaux aux canevas de médias génératifs haute-fidélité dans Google Chrome.

Quand Utiliser Cette Compétence

Utilisez cette compétence à chaque fois que :

1. L'utilisateur demande de générer des vidéos IA cinématographiques, des séquences B-roll, des concept arts ou des storyboards.
2. Vous construisez ou dirigez un court-métrage ou une publicité multi-plans autonome.
3. Vous générez des fiches de référence de personnages (cohérence de rotation) à travers plusieurs scènes vidéo.
4. Vous automatisez des files d'attente de génération d'images/vidéos en lot sans payer de frais d'API à la minute.
5. Vous vous renseignez sur l'état actuel du pont OmniFlow, les quotas de génération ou la progression de la file active.

---

🚀 Protocole d'Exécution Rapide pour Agents

Avant de lancer des travaux médias, chaque agent doit suivre cette boucle de vérification en 3 étapes :

Étape 1 : Vérification de l'État et du Pont

Vérifiez que le daemon du pont OmniFlow local est en cours d'exécution sur http://127.0.0.1:8792 :

node scripts/check-bridge.js
# Ou curl directement :
curl -s http://127.0.0.1:8792/status

• Si Hors Ligne : Demandez à l'utilisateur ou exécutez : omniflow bridge start (ou démarrez la tâche de fond du pont).
• Si En Ligne : Vérifiez que extensionConnected est true et tabVisible est true (cela signifie que Chrome a Google Flow ouvert).

Étape 2 : Soumettre un Travail de Génération

Les agents peuvent soumettre via l'API REST ou les scripts helper fournis :

# Script helper (le plus simple) :
node scripts/submit-shot.js --mode flow-text-to-video --prompt "Survol cinématique drone Tokyo cyberpunk néon pluie 8k" --aspectRatio 16:9 --duration 6s

# Ou POST HTTP direct :
curl -s -X POST http://127.0.0.1:8792/jobs \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "flow-text-to-video",
    "prompt": "Survol cinématique drone Tokyo cyberpunk néon pluie 8k",
    "params": {
      "aspectRatio": "16:9",
      "duration": "6s",
      "videoModel": "veo-3.1-fast",
      "downloadSubfolder": "MonProjet"
    }
  }'

Étape 3 : Surveiller et Récupérer les Médias Téléchargés

Interrogez jusqu'à ce que l'état du travail passe à completed :

node scripts/list-jobs.js
# Ou :
curl -s http://127.0.0.1:8792/jobs

Lorsque status === "completed", récupérez le chemin du fichier local depuis le tableau files (par exemple Downloads/MonProjet/...mp4).

---

🛠️ Modes de Génération Pris en Charge

ID du Mode	Description	Paramètres Clés
flow-text-to-video	Génère une vidéo animée à partir d'une description textuelle	prompt, aspectRatio (16:9, 9:16, 1:1), duration (4s, 6s, 8s)
flow-text-to-image	Génère des images photoréalistes ou stylisées fixes	prompt, aspectRatio, imageModel (nano-banana-pro)
flow-frame-to-video	Étend une image fixe ou une image clé en vidéo continue	prompt, duration, jeton d'asset de référence
flow-create-character	Génère une fiche de rotation à 4 angles pour la cohérence faciale	characterName, visualDescription, voicePreset

---

🎛️ Invocations d'Outils MCP (Si le Serveur MCP est Actif)

Si le serveur MCP d'OmniFlow est connecté dans votre environnement d'agent, appelez ces outils natifs directement :

• omniflow_status : Vérifier l'état du pont et de la connexion au navigateur.
• omniflow_generate_shot : Mettre en file d'attente un seul plan avec mouvement de caméra (drone-wide, close-up, tracking).
• omniflow_produce_movie : Passer un tableau complet de scénario de plans ordonnés pour produire un court-métrage entier de manière séquentielle.
• omniflow_create_character : Verrouiller une étiquette de personnage avec une cohérence de rotation de face et de profil.
• omniflow_list_jobs : Lister les travaux de génération actifs, en file d'attente et terminés avec les chemins de téléchargement sur disque.

---

💡 Bonnes Pratiques pour les Prompts Cinématographiques

Pour des sorties vidéo photoréalistes avec Veo 3.1 :

1. Spécifiez le Mouvement de Caméra : Par exemple [Camera: drone-wide], [Camera: slow push-in], [Camera: tracking shot].
2. Spécifiez l'Éclairage et l'Atmosphère : Par exemple volumetric rim lighting, golden hour anamorphic haze, 35mm film grain.
3. Évitez le Jargon : Google Flow répond mieux à des descriptions narratives visuelles claires qu'à des balises logicielles.

Voir references/api-reference.md et examples/cinematic-short-film.json pour des modèles multi-scènes prêts à exécuter.