bp-abe/skills-video

Videos in die Cloud hochladen

video-animado liefert die MP4-Dateien im Projekt aus. Diese Skill legt die Dateien in einem Cloud-Ordner mit Namen ab, die das Team erkennt. Diese Namen werden zum Schlüssel für die spätere Analyse der Ergebnisse jedes Creatives.

Schema

<Zielordner, vom Benutzer bestätigt>/
  <KAMPAGNENNAME>/
    30S/                                     ein Unterordner pro Dauer
      vvs_bala_coroa/                        ein Ordner pro Video
        vvs_vertical_bala_coroa.mp4          9:16 · 1080×1920
        vvs_wide_bala_coroa.mp4              16:9 · 1920×1080
        vvs_square_bala_coroa.mp4            1:1  · 1080×1080
        como_foi_feito.md                    Erstellungsprozess des Videos
    15S/
      vvs_bala_coroa/ …

• Dateiname: <präfix>_<format>_<wörter>.mp4, alles klein geschrieben. Das Präfix ist standardmäßig vvs und kann mit "präfix" im Manifest geändert werden.
• Format: Das vertikale wird zu vertical, das quadratische zu square und das horizontale zu wide. Nicht vorhandene Formate werden weggelassen; nicht erfinden.
• Wörter: 1 bis 4, stammen aus dem Videotitel, klein geschrieben und ohne Akzente. Artikel, Präpositionen, „und“ und „dass“ werden weggelassen (das Skript entfernt sie automatisch).
  • "Die Kugel auf der Krone" wird zu vvs_vertical_kugel_krone.mp4.
  • "Drei Kinder vor der Macht" wird zu vvs_wide_drei_kinder_vor_macht.mp4.
  • Sollten mehr als 4 übrig bleiben, in "wörter" im Manifest auswählen; das Skript lehnt ab, bis es geschehen ist.
• Der Videoordner heißt <präfix>_<wörter>. Die Dauer befindet sich nur im Unterordner (30S/, 15S/) und in der Registrierung. Ein Schnitt von 14,0 s kommt in 15S/.
• Derselbe Titel in zwei Dauern erzeugt denselben Dateinamen in verschiedenen Ordnern. Das Skript warnt. Im Anzeigenmanager die Dauer in den Anzeigennamen einfügen.
• como_foi_feito.md in jedem Videoordner, damit jeder den Erstellungsprozess nachvollziehen kann. Das Skript erstellt das Dokument aus dem Quellprojekt (atributos.projeto):
  • technische Daten;
  • Regie, Stimme und Soundtrack;
  • Konzept und Drehbuch, aus dem roteiro.json;
  • die ANALISE.md und RELATORIO.md des Projekts: Brief, Konzepte, Bibel und Kritikanmerkungen.

Schritt für Schritt

1. Zielordner: Der Auftraggeber bestätigt immer. Niemals raten. Falls nicht genannt, nachfragen.
2. Den lokalen Pfad des synchronisierten Ordners finden. Unter macOS befindet sich Google Drive Desktop unter ~/Library/CloudStorage/GoogleDrive-<Ihre E-Mail>/ (Mein Drive/, Freigegebene Laufwerke/). Falls ein Drive-Link und ein Drive-Connector vorhanden sind, kann über die übergeordneten Ordner (parentId) bis zu dem Namen hochgegangen werden, der in der Synchronisation existiert. Das Kopieren in den synchronisierten Ordner ist der Upload; keine großen MP4-Dateien über die API senden.
3. Das Manifest erstellen (manifesto.json, Vorlage unten): jedes Video mit Titel, nomineller Dauer und Pfad der Dateien pro Format, plus die Attribute für die Analyse (Creative-Richtung, Prozess, Stimme, Soundtrack, Quellprojekt).
4. Die Tabelle der Namen und das Ziel anzeigen vor dem Kopieren, es sei denn, es wurde bereits gesagt, direkt hochzuladen. Meistens ist es ein freigegebener Ordner.
5. Ausführen python3 ~/.claude/skills/subir-videos/subir.py manifesto.json.
   • Vorher mit --seco ausführen: nur validieren und Namen anzeigen.
   • Falls die Dateien bereits in der Cloud sind, --so-registro verwenden: nur die Registrierung speichern.
   • Das Skript prüft Abmessungen und Dauer, lehnt Namen außerhalb des Schemas oder doppelte Titel ab, erstellt die Ordner, kopiert und schreibt das como_foi_feito.md jedes Videos und fügt Zeilen zur allgemeinen Registrierung ~/videos/VVS_REGISTRO.csv hinzu.
6. Nach einigen Minuten in der Cloud überprüfen, da die Synchronisation im Hintergrund hochlädt und große Dateien länger brauchen.
7. Den Link zum Ordner und die Tabelle der Namen übergeben und in der ANALISE.md des Projekts festhalten, wo jedes Video gelandet ist.

Manifest (Vorlage)

{
  "destino_local": "~/Library/CloudStorage/GoogleDrive-<Ihre E-Mail>/Freigegebene Laufwerke/<Laufwerk>/<Ordner>",
  "campanha": "KAMPAGNENNAME",
  "prefixo": "vvs",
  "drive_link": "https://drive.google.com/drive/folders/<ID des Zielordners>",
  "videos": [
    {"titulo": "Die Kugel auf der Krone", "duracao": "30S",
     "arquivos": {"vertical": "…/out/30s_9x16.mp4", "wide": "…/out/30s_16x9.mp4", "square": "…/out/30s_1x1.mp4"},
     "atributos": {"direcao": "2D-Animation mit Charakter", "processo": "pedido-de-video + video-animado",
                   "voz": "Gemini TTS", "trilha": "Lyria, ~120 bpm", "projeto": "~/videos/<slug>"}}
  ]
}

Warum es die Registrierung gibt

Der Name <präfix>_<format>_<wörter> ist der Schlüssel, um die Ergebnisse abzugleichen (mit der Dauer im Anzeigennamen). Das Team lädt das Creative im Anzeigenmanager mit diesem Namen hoch, und es erscheint im Anzeigennamen in den Mediendaten. Die VVS_REGISTRO.csv speichert die Attribute jedes Videos (Richtung, Prozess, Stimme, Soundtrack, tatsächliche Dauer), um später zu vergleichen, was funktioniert und was nicht. Keine persönlichen Daten darin speichern.

Nicht tun

• Nicht in einen nicht bestätigten Ordner hochladen, noch Dateien anderer Personen im Ordner löschen oder umbenennen.
• Das Namensschema nicht eigenmächtig ändern: Änderungen am Schema sind Entscheidung des Auftraggebers.
• MP4-Dateien nicht in das Git-Repository legen.