HiveControlAgents/iris

ÍRIS : Révision de vidéo générée par IA

L'ÍRIS ne se contente pas de regarder la vidéo : elle la mesure, l'examine image par image, distingue le hasard du défaut de pipeline, demande de refaire uniquement les mauvaises scènes et apprend de chaque vidéo. Le cycle est : générer, réviser, refaire, apprendre.

1. Inspecter

Exécutez l'inspecteur situé dans le dossier scripts/ de cette compétence :

python "<chemin de cette compétence>/scripts/inspecionar.py" chemin/de/la/video.mp4 [--roteiro script.json] [--referencia-voz voix.wav]

• --roteiro : JSON avec "cenas" : [{"narracao" : "...", "prompt" : "...", "dur_s" : 5.4}]. Avec ce script, les scènes suivent le script et la narration est comparée à ce qui a été dit (nécessite faster-whisper ou openai-whisper). Sans lui, les scènes proviennent des coupures franches. Voir exemples/roteiro.json à la racine du plugin.
• --referencia-voz : enregistrement de la voix approuvée. Vérifie si la narration utilise toujours la même voix (nécessite librosa).
• Sortie dans .iris/<nom-de-la-video>/ : medidas.json et folha_N.jpg.
• Si ffmpeg ou Pillow manquent, indiquez à l'utilisateur quoi installer et arrêtez-vous.

2. Regarder

1. Lisez medidas.json en entier.
2. Ouvrez TOUTES les planches contact avec l'outil de lecture d'images. Chaque planche a 2 images par seconde, 6 par ligne, de gauche à droite, avec le temps en jaune dans le coin. Comparez les images voisines : c'est là qu'apparaissent les objets qui disparaissent, se dupliquent ou se déforment.
3. Lisez .iris/historico.json s'il existe (leçons déjà apprises et dernières vidéos) et .iris/regras.md s'il existe (règles de la chaîne, par exemple « pas de personnes » ou « pas de texte dans l'image »).

3. Analyser

Utilisez la liste de contrôle de criterios.md. Pour chaque problème, notez : la seconde exacte, la scène, ce que l'on voit, la cause probable et s'il s'agit d'un hasard (arrivé une fois, une autre graine résout le problème) ou d'un pipeline (systématique, ou déjà apparu dans des vidéos de l'historique). Ne décrivez jamais cette vidéo en vous basant sur l'historique : l'historique sert uniquement à reconnaître des schémas.

4. Livrer

Enregistrez dans .iris/<nom-de-la-video>/ :

• revisao.json :

  {"nota": 7.5, "resumo": "une phrase",
   "problemas": [{"segundo": 12.5, "cena": 3, "tipo": "visual|narracao|ritmo|audio|legenda|tecnico",
                  "gravidade": "alta|media|baixa", "descricao": "...", "causa": "...", "origem": "sorteio|pipeline"}],
   "refazer": [{"cena": 3, "motivo": "...", "ajuste_prompt": "quoi changer dans le prompt de cette scène, si nécessaire"}],
   "licoes": [{"tipo_assunto": "esporte|animais|espaco|corpo_humano|historia|tecnologia|natureza|geral",
               "alvo": "roteiro|geracao|montagem", "regra": "règle générale, pas de détail de cette vidéo"}],
   "pipeline": [{"onde": "fichier ou étape", "mudanca": "...", "motivo": "..."}]}
  

• revisao.md : la même révision en texte court pour humains, avec la note en haut et la liste des scènes à refaire.

Règles du refazer : au maximum 3 scènes, et uniquement les défauts de hasard qui gâchent la vidéo (objet qui disparaît, se duplique ou se déforme ; personne, main ou texte interdit par les règles ; saut brusque ; image sans rapport avec la narration). Un défaut léger, de goût ou de pipeline n'entre pas. Si le dossier contient rodada: 2 (l'utilisateur dit que c'est la version refaite), refazer reste vide et la révision indique si les scènes refaites se sont améliorées.

5. Apprendre

Mettez à jour .iris/historico.json (créez-le s'il n'existe pas) :

{"licoes": [{"tipo_assunto": "animais", "alvo": "geracao", "regra": "...", "vezes": 2, "ultima": "2026-10-17"}],
 "videos": [{"video": "nom", "data": "2026-10-17", "nota": 7.5, "resumo": "...", "refazer": [3]}]}

• Une leçon qui en répète une existante (même sens, mots différents) ajoute 1 à vezes ; ne dupliquez pas.
• Gardez au maximum 40 leçons (supprimez celles avec le moins de vezes et les plus anciennes) et les 30 dernières vidéos.

6. Corriger le pipeline (seulement si l'utilisateur le demande)

Si le projet de l'utilisateur contient le code ou la configuration qui génère les vidéos et qu'il demande la correction :

• au maximum 3 modifications, minimales, en privilégiant la configuration et le texte de prompt à la logique ;
• ne touchez jamais aux chemins de disque, clés ou secrets ;
• montrez le diff et exécutez les tests du projet, s'il y en a, avant de dire que c'est terminé.

Réponse dans le chat

Note, une phrase de résumé, les scènes à refaire avec le motif, et le chemin de revisao.md. Pas de répétition complète de la révision dans le chat.