HiveControlAgents/iris

ÍRIS: Überprüfung von KI-generierten Videos

Die ÍRIS betrachtet das Video nicht nur: Sie misst, schaut Bild für Bild, trennt Pech von Störungen in der Pipeline, lässt nur die schlechten Szenen neu erstellen und lernt aus jedem Video. Der Kreislauf ist: Erstellen, Überprüfen, Neu erstellen, Lernen.

1. Inspizieren

Führen Sie den Inspektor aus, der sich im Ordner scripts/ dieser Skill befindet:

python "<Pfad dieser Skill>/scripts/inspecionar.py" pfad/zum/video.mp4 [--roteiro drehbuch.json] [--referencia-voz stimme.wav]

• --roteiro: JSON mit "cenas": [{"narracao": "...", "prompt": "...", "dur_s": 5.4}]. Damit folgen die Szenen dem Drehbuch, und die Erzählung wird mit dem Gesagten verglichen (benötigt faster-whisper oder openai-whisper). Ohne diesen Parameter stammen die Szenen aus harten Schnitten. Siehe exemplos/roteiro.json im Stammverzeichnis des Plugins.
• --referencia-voz: Aufnahme der genehmigten Stimme. Überprüft, ob die Erzählung noch dieselbe Stimme ist (benötigt librosa).
• Ausgabe in .iris/<name-des-videos>/: medidas.json und folha_N.jpg.
• Wenn ffmpeg oder Pillow fehlen, teilen Sie dem Benutzer mit, was installiert werden muss, und brechen Sie ab.

2. Ansehen

1. Lesen Sie medidas.json vollständig.
2. Öffnen Sie ALLE Kontaktbögen mit dem Bildlesewerkzeug. Jeder Bogen hat 2 Bilder pro Sekunde, 6 pro Zeile, von links nach rechts, mit der gelben Zeitangabe in der Ecke. Vergleichen Sie benachbarte Bilder: Hier treten verschwindende, duplizierte oder deformierte Objekte auf.
3. Lesen Sie .iris/historico.json, falls vorhanden (bereits gelernte Lektionen und letzte Videos) und .iris/regras.md, falls vorhanden (Kanarregeln wie "keine Personen" oder "kein Text im Bild").

3. Analysieren

Verwenden Sie die Checkliste aus criterios.md. Notieren Sie zu jedem Problem: genaue Sekunde, Szene, was zu sehen ist, wahrscheinliche Ursache und ob es Sorteio (trat einmal auf, ein anderer Seed behebt es) oder Pipeline (systematisch oder bereits in früheren Videos aufgetreten) ist. Beschreiben Sie dieses Video niemals basierend auf dem Verlauf; der Verlauf dient nur zur Erkennung von Mustern.

4. Liefern

Speichern Sie in .iris/<name-des-videos>/:

• revisao.json:

  {"nota": 7.5, "resumo": "Ein Satz",
   "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": "Was am Prompt dieser Szene geändert werden soll, falls nötig"}],
   "licoes": [{"tipo_assunto": "esporte|animais|espaco|corpo_humano|historia|tecnologia|natureza|geral",
               "alvo": "roteiro|geracao|montagem", "regra": "Allgemeine Regel, kein Detail dieses Videos"}],
   "pipeline": [{"onde": "Datei oder Schritt", "mudanca": "...", "motivo": "..."}]}
  

• revisao.md: Dieselbe Überprüfung als kurzer Text für Menschen, mit der Note oben und der Liste der neu zu erstellenden Szenen.

Regeln für refazer: maximal 3 Szenen, und nur zufällige Fehler, die das Video ruinieren (Objekt verschwindet, dupliziert oder deformiert; Person, Hand oder Text, die durch die Regeln verboten sind; harter Schnitt; Bild ohne Bezug zur Erzählung). Leichte, geschmackliche oder Pipeline-Fehler werden nicht aufgenommen. Wenn der Ordner rodada: 2 enthält (der Benutzer sagt, dass es die neu erstellte Version ist), bleibt refazer leer, und die Überprüfung gibt an, ob die neu erstellten Szenen sich verbessert haben.

5. Lernen

Aktualisieren Sie .iris/historico.json (erstellen Sie es, falls nicht vorhanden):

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

• Eine Lektion, die eine bestehende wiederholt (gleicher Sinn, andere Wörter), erhöht vezes um 1; nicht duplizieren.
• Behalten Sie maximal 40 Lektionen (verwerfen Sie die mit den niedrigsten vezes und ältesten) und die letzten 30 Videos.

6. Pipeline korrigieren (nur wenn der Benutzer fragt)

Wenn das Projekt des Benutzers den Code oder die Konfiguration zur Videogenerierung enthält und er um Korrektur bittet:

• maximal 3 Änderungen, minimal, bevorzugt Konfiguration und Prompt-Text vor Logik;
• niemals an Datenträgerpfaden, Schlüsseln oder Geheimnissen ändern;
• zeigen Sie den Diff und führen Sie die Tests des Projekts aus, falls vorhanden, bevor Sie sagen, dass Sie fertig sind.

Antwort im Chat

Note, ein zusammenfassender Satz, die neu zu erstellenden Szenen mit Grund und der Pfad zu revisao.md. Die gesamte Überprüfung nicht im Chat wiederholen.