yunjundai/video-editing-skills

Montage vidéo cinématographique

Avant d'utiliser, d'installer ou d'encapsuler cette compétence dans un autre agent IA, lisez d'abord agent-compatibility.md et suivez les instructions pour votre plateforme cible concernant le répertoire de la compétence et la configuration locale.

Transformez les fichiers audio et vidéo de l'utilisateur en une vidéo regardable et modifiable. Utilise automatiquement FFmpeg, Remotion, faster-whisper et OpenCC ; pour les finitions, utilise DaVinci Resolve ou Shotcut déjà installés, selon le preferred_editor défini dans local-environment.json. Ne dépend pas de MCP, d'API payantes, de rendu cloud ou d'effets commerciaux. Suit le style de montage, le style visuel et le format de livraison spécifiés par l'utilisateur.

Environnement local

Avant la première utilisation, copiez local-environment.example.json vers references/local-environment.json et renseignez les chemins d'accès réels des outils ; les chemins d'exemple ne signifient pas que les outils sont installés.

Lisez d'abord references/local-environment.json pour confirmer les chemins absolus des outils. Les dépendances Python sont placées dans un venv dédié ; utilisez le python de ce venv, pas le Python système, pour exécuter la reconnaissance vocale. Utilisez scripts/project.py doctor pour vérifier l'environnement. Les commandes pour créer, prévisualiser et exporter le projet sont décrites dans project-commands.md. Les dossiers scripts/ et assets/ sont relatifs au dossier de cette compétence ; utilisez des chemins absolus et des tableaux de paramètres, en gérant correctement les chemins en chinois ou avec des espaces.

Commencer le travail

Ne lisez environment-notes.md que lorsque vous devez déplacer ou reconstruire l'environnement des outils, et verrouillez les versions testées pour la reconstruction.

• Déterminez la méthode de travail en fonction des besoins et des fichiers sources ; ne demandez que les informations manquantes qui affecteraient le résultat final. Confirmez la durée, le format d'image, le contenu important et le style ; si non spécifié, vous pouvez d'abord créer une prévisualisation en 16:9, 1080p, 30fps.
• Si le chemin des fichiers sources est inconnu, commencez par inventorier le répertoire de travail actuel ; ne prenez pas un dossier vide pour un dossier contenant déjà des fichiers. Conservez les fichiers originaux et placez les fichiers dérivés dans un nouveau dossier de travail.
• Utilisez media.py inventory pour créer une liste avec la durée, le format d'image, les informations audio et les miniatures. Générez des proxies ou utilisez media.py scenes pour trouver les points de coupure uniquement si nécessaire. Lisez media-commands.md pour les commandes réelles.
• Regardez les images représentatives, écoutez les voix, lisez la transcription mot à mot, puis sélectionnez les fichiers ; la détection de coupure ne montre que les changements d'image, et l'extraction d'images peut manquer des actions. Ne prenez jamais des images, des noms de personnes ou des faits d'événements supposés pour des contenus confirmés.

Montage et motion design

1. Créez la liste des sections et des points de début/fin des fichiers sources. Pour une vidéo d'inauguration d'école, on peut utiliser : générique, campus et histoire, activités et interviews, vision, remerciements ; ajustez en fonction des fichiers.
2. Utilisez scripts/project.py init <new_project_directory> pour copier le modèle Remotion prêt à l'emploi. Copiez les fichiers sélectionnés dans public/media/ de ce projet, pour éviter de modifier les originaux.
3. Éditez public/project.json pour les scènes, les points d'entrée, les durées, les transitions, les sous-titres et les bandeaux nominatifs. Lisez les spécifications de format dans motion-template.md ; pour les fichiers vidéo, utilisez d'abord ffprobe pour confirmer la zone de recadrage. Le modèle prend en charge les génériques, les chapitres, les zooms avant sur les photos, les vidéos, les citations, les remerciements, ainsi que les transitions fondu/volet/glissement.
4. Faites d'abord une petite prévisualisation, puis produisez la vidéo entière. Utilisez project.py still pour voir un moment précis, utilisez project.py render --scale 0.5 pour une prévisualisation rapide ; pour la livraison finale, utilisez la résolution d'origine.

Maintenez une police, une palette de couleurs, des marges de sécurité et un rythme d'animation cohérents. Vous pouvez améliorer la qualité avec l'espacement des lettres, le dévoilement de lignes, les masques et les entrées/sorties en douceur. Placez les noms, titres, dates, titres de séquence et couleurs dans des données modifiables. Coupez ou raccourcissez les textes longs, n'utilisez pas de très petites polices pour les faire entrer de force.

Pour des effets supplémentaires, vous pouvez ajouter des animations personnalisées dans le code source du modèle. Lisez si nécessaire les compétences officielles installées remotion-best-practices, remotion-captions, remotion-render ou la documentation officielle ; le modèle de base peut fonctionner indépendamment. N'utilisez que des effets gratuits et compatibles. N'utilisez Blender que pour des scènes 3D lorsqu'il y a un besoin concret ; n'installez pas automatiquement de gros outils optionnels.

Sous-titres en chinois traditionnel et audio

• Utilisez scripts/transcribe.py avec le modèle local small préparé pour générer un fichier SRT et un captions.json contenant les horodatages des mots ; CPU/int8 fonctionne, pas besoin de CUDA. L'accélération GPU nécessite de vérifier d'abord les dépendances.
• OpenCC ne convertit que les caractères et les mots ; il reste à vérifier les noms d'écoles, noms de personnes, titres, dates, homophones et le taïwanais. Laissez des marqueurs pour les passages non identifiés, n'inventez pas.
• Effectuez la transcription sur la piste vocale après montage, ou calculez les horodatages finaux en fonction de chaque fichier source et des chevauchements de transitions. Ne collez pas directement les horodatages des sous-titres des fichiers source sur la vidéo montée.
• Le tableau captions dans captions.json peut être déplacé dans project.json ; les horodatages de début et de fin sont en secondes dans la vidéo finale. Pour la mise en évidence mot par mot, vous devez avoir des horodatages fiables par mot ; si vous n'avez que des horodatages par phrase, affichez la phrase entière.
• Gardez les sous-titres et les bandeaux nominatifs lisibles sans se masquer mutuellement. Les transitions audio font jouer les segments qui se chevauchent ; pour les interviews, coupez de préférence aux limites des phrases ; si nécessaire, traitez l'audio indépendamment. La musique de fond doit préserver la clarté des voix, avec un volume et des fondus adaptés aux fichiers.

Livraison et vérification

• Utilisez media.py check pour vérifier le décodage, les plans noirs et le silence ; les plans noirs et le silence peuvent être intentionnels, à interpréter manuellement. Vérifiez visuellement le début, les milieux de transitions, les passages de sous-titres les plus longs, les bandeaux nominatifs et la fin, et écoutez la voix et la musique.

• Conservez le code source, le fichier project.json, les fichiers sources utilisés et le fichier SRT. Livrez le MP4, une miniature et la méthode de modification. N'écrasez pas le résultat final sans confirmation ; produisez une nouvelle version ou utilisez explicitement --overwrite.

• project.py shotcut peut créer un point de départ pour les finitions dans Shotcut avec le résultat du rendu. Le texte ne devient pas des couches de texte natives de Shotcut ; pour modifier le texte ou les animations, revenez au projet Remotion et refaites le rendu. Ne prétendez pas que les effets rendus sont éditables mot à mot de manière native.

• Pour les animations avec transparence, créez une Composition dédiée à la transparence, exportez et testez une séquence PNG RGBA ou un encodage alpha compatible ; le H.264 MP4 standard ne conserve pas la transparence.

• Lorsque vous utilisez Resolve pour les finitions ou que vous devez contrôler directement, lisez resolve-guide.md. Le contrôle de Resolve doit être testé sur l'ordinateur cible ; vous pouvez utiliser la console Lua intégrée pour créer un projet, importer des fichiers, créer une timeline et exporter en DRP/MP4. Pour les opérations GUI, utilisez la compétence computer-use disponible. Ne supposez pas que la connexion scripting externe de la version gratuite est disponible. scripts/resolve_verify.lua est uniquement destiné à la vérification de contrôle d'une durée maximale de 9,8 secondes ; pour le montage réel, utilisez l'API officielle et les opérations d'écran en fonction des besoins, et vérifiez les résultats étape par étape. Lorsque vous avez besoin d'effets de texte modifiables de manière native, créez un modèle Fusion et testez-le réellement ; ne prenez pas une vidéo rendue par Remotion pour un nœud natif.

À la fin, indiquez l'emplacement de la vidéo finale et du projet modifiable, les fonctionnalités vérifiées et les éléments à relire. L'état d'installation est basé sur la commande doctor et l'exécution réelle ; le moteur de montage est gratuit en local, le crédit du compte agent IA est séparé.