Communitygithub.com

h296025733-sys/codex-auto-video-lab

Transformez les fichiers vidéo, image et audio locaux fournis par l'utilisateur, ainsi que ses besoins d'édition en langage naturel, en un travail d'édition isolé et auditable, une timeline JSON validée, un MP4 rendu et un rapport d'assurance qualité technique local. Utilisez-le lorsque l'utilisateur demande à Codex d'éditer, rogner, recadrer, sous-titrer, séquencer, mettre en musique ou empaqueter automatiquement des médias téléchargés.

Qu'est-ce que codex-auto-video-lab ?

Ce skill, `h296025733-sys/codex-auto-video-lab`, est conçu pour les assistants IA comme Codex afin d'automatiser l'édition vidéo locale à partir d'actifs médias fournis par l'utilisateur et d'instructions en langage naturel. Il transforme une demande d'édition en un pipeline déterministe et auditable qui comprend la création d'un job isolé, l'analyse des médias (avec transcription optionnelle), l'édition sémantique manuelle via un plan d'édition JSON, le rendu FFmpeg en MP4, et une validation technique complète. Ce skill est utile pour des tâches comme le montage, le rognage, le sous-titrage, l'ajout de musique, le reframing ou l'assemblage de séquences sans jamais modifier les fichiers sources originaux. Il prend en charge les workflows avancés comme les coupes franches, les transitions non-coupe (dissolve, slide), les sous-titres animés, le voiceover, le ducking audio, et le reframing avec modes fill/contain. Le skill s'appuie sur un ensemble de scripts PowerShell locaux (`studio.ps1`) et un espace de travail dédié (`D:\workspace\codex-auto-video-lab`). Il ne convient pas pour la génération de contenu B-roll, les motion graphics complexes avec Remotion, l'export vers des logiciels comme Premiere, ou la publication sur les réseaux sociaux.

Compatible avec~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/h296025733-sys/codex-auto-video-lab/tree/HEAD/.codex/skills/auto-video-editor

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Éditeur Vidéo Automatique

Objectif

Produire une édition locale réelle tout en préservant les originaux. Codex prend les décisions sémantiques ; le CLI de l'espace de travail effectue l'analyse déterministe des médias, la validation, le rendu FFmpeg et l'assurance qualité technique.

Racine de l'espace de travail : D:\workspace\codex-auto-video-lab.

Workflow

Si le brief demande d'apprendre à partir de vidéos de référence, d'effectuer un 精剪, de construire une superposition de liste/grille, de chronométrer des découpes de produits sur la parole, ou d'utiliser un mouvement de sous-titres en couches, chargez $tiktok-fine-cut-director avant d'élaborer la timeline. Sa spécification de coupe fine devient l'entrée sémantique de ce workflow de rendu déterministe.

  1. Lisez les exigences de l'utilisateur et résolvez chaque chemin d'actif local fourni. Créez un ID de job sûr et concis. Ne modifiez pas les fichiers sources en place.

  2. Exécutez le doctor de l'espace de travail s'il s'agit de la première édition de la tâche :

    powershell -ExecutionPolicy Bypass -File .\scripts\doctor.ps1

  3. Créez le job isolé. Passez --asset une fois par source et incluez le brief exact de l'utilisateur :

    .\studio.ps1 create --job <job-id> --asset <chemin> --brief <exigences>

  4. Analysez le job. Ajoutez --transcribe lorsque le sens de la parole, les sous-titres, la suppression des silences ou la sélection de citations affectent l'édition :

    .\studio.ps1 analyze --job <job-id> --transcribe

  5. Lisez jobs\<job-id>\brief.txt, manifest.json, reports\analysis.json et le fichier JSON de transcription pertinent. Utilisez les candidats de scène et les intervalles de silence comme preuves, et non comme une vérité éditoriale automatique.

  6. Générez le brouillon conservateur :

    .\studio.ps1 draft-plan --job <job-id>

  7. Modifiez jobs\<job-id>\edit-plan.json pour satisfaire le brief. Lisez edit-plan.md avant de changer le plan. Conservez un intent_summary qui explique les décisions de sélection, d'ordre, de rythme, de texte, de rapport d'aspect et audio. N'inventez jamais de séquences B-roll indisponibles ou d'affirmations factuelles.

  8. Validez, effectuez le rendu et exécutez l'assurance qualité :

    .\studio.ps1 validate --job <job-id>

    .\studio.ps1 render --job <job-id>

    .\studio.ps1 qa --job <job-id>

  9. Inspectez tous les chemins dans reports\qa.json sous sample_frames et critical_overlay_frames avec le visualiseur d'images local. Si les sous-titres, le recadrage, les zones de sécurité titre, les glyphes de police, les superpositions critiques ou les images noires semblent incorrects, révisez le plan et refaites le rendu.

  10. Livrez les chemins du MP4, du plan d'édition, de l'analyse et de l'assurance qualité. Indiquez séparément ce qui a réellement été exécuté : inspection des sources, transcription, rendu local, décodage complet, inspection visuelle d'images échantillonnées ou lecture sur plateforme. N'appelez jamais l'assurance qualité technique une vérification sémantique ou de publication.

Règles de Décision

  • Faites des hypothèses éditoriales raisonnables lorsque le brief laisse de petits détails ouverts ; consignez-les dans intent_summary.
  • Interrogez l'utilisateur uniquement lorsqu'un choix manquant modifierait matériellement l'histoire, l'affirmation sur le produit, l'identité ou l'utilisation d'actifs sous licence.
  • Privilégiez les coupes franches pour l'action, la parole, la preuve et le montage ordinaire. Utilisez une transition non-coupe uniquement pour un véritable changement de temps/lieu/chapitre, un pont doux, ou un mouvement directionnel visiblement apparié ; utilisez une échelle de texte uniquement sur un crochet, un contraste, un nombre, une preuve, un gain ou un CTA pris en charge. Utilisez le rythme et la sélection de plans avant les effets.
  • Gardez le dialogue intelligible. La musique de fond par défaut est proche de -18 dB avec l'écrêtage actif.
  • Pour une sortie verticale au format court, par défaut 1080x1920 à 30 ips. Utilisez contain au lieu d'un recadrage destructeur lorsque du contenu important sortirait du cadre.
  • Ne brûlez pas de nouveaux sous-titres sur des images source qui contiennent déjà des sous-titres lisibles, sauf si l'utilisateur demande un restylage.
  • Traitez la détection de scène, la détection de silence et la reconnaissance vocale comme des preuves faillibles. Vérifiez les limites de la transcription avant une coupe sémantique.

Baseline Rapide

Pour une demande qui n'a explicitement besoin d'aucune suppression sémantique—seulement une concaténation ordonnée, un recadrage, un titre optionnel et des sous-titres—baseline-auto peut exécuter l'ensemble du pipeline mécanique. Étiquetez-le comme un assemblage de base, et non comme un jugement éditorial personnalisé :

.\studio.ps1 baseline-auto --job <job-id> [--transcribe] [--title <texte>] [--burn-captions]

Périmètre Actuel

Pris en charge : ingestion de vidéo/image locale, sondage, candidats de scène, intervalles de silence, transcription hors ligne optionnelle, rognage de segments, vitesse 0,25x-4x, recadrage fill/contain, mise en sourdine ou gain source exact, mouvement push/pull contrôlé, transitions justifiées par les preuves (dissolve/dip/slide directionnel), titres/sous-titres/étiquettes animés stylés, une seule exécution de couleur sémantique exacte dans un sous-titre/titre/étiquette avec pulse ou shake optionnel pendant la fenêtre de parole réelle de ce mot, étiquettes d'étapes numérotées appariées, voiceover généré, musique de fond avec ducking de narration, effets sonores minutés, finition couleur commerce, MP4 H.264/AAC, QA par décodage complet, analyse d'images noires, analyse de niveau audio et images échantillonnées.

Non pris en charge directement par ce moteur de rendu FFmpeg : bases de connaissances d'actifs, B-roll génératif, graphiques animés Remotion en couches, synchronisation multicam, export de projet modifiable Premiere/DaVinci, ou publication sur plateforme. Acheminez le travail Remotion en couches via $openchatcut comme spécifié par $tiktok-fine-cut-director.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills associés