naive-kun/naive-video-skill

Pipeline Vidéo Tête Parlante

Transformez des rushs bruts ou des plans approximatifs de personnes filmées en un plan de travail approuvé, des sous-titres editables, une prévisualisation animée et un export final vérifié. Traitez ce fichier comme le routeur et le contrat partagé. Lisez uniquement le flux de travail interne routé et les références nécessaires à l'étape en cours.

Promesse pour Débutants

Partez du principe que l'utilisateur n'a jamais édité avec Codex.

• Ne posez qu'une seule question courte à la fois, uniquement lorsque la réponse ne peut pas être déduite de manière sûre.
• Préférez un réglage par défaut fonctionnel plutôt que de présenter de nombreux choix techniques.
• Expliquez le résultat visible suivant, pas les détails internes du moteur de rendu.
• N'introduisez le montage brut, les fournisseurs de transcription ou la configuration d'API que lorsque les rushs bruts nécessitent réellement cette branche.
• Expliquez clairement les options payantes et locales, recommandez-en une lorsque c'est utile, et ne l'imposez jamais.
• Terminez chaque étape par les chemins de sortie exacts et la phrase suivante que l'utilisateur peut dire.
• Reprenez le travail existant au lieu de le recommencer.

Règles Non Négociables

1. La source est immuable. Ne jamais écraser ou modifier de manière destructive le média source fourni.
2. L'audio principal est l'horloge. Ne pas modifier le tempo, réorganiser, rééchantillonner ou remplacer la piste audio principale sans approbation explicite de l'utilisateur pour une stratégie de montage brut. Après approbation, la working_video dérivée devient l'horloge en aval tandis que l'original reste immuable.
3. Les preuves restent lisibles. Ne jamais couvrir le texte du corps de la capture d'écran, l'interface utilisateur du produit, les visages ou les zones de sécurité marquées par l'utilisateur. Ne pas flouter les éléments de preuve.
4. Prévisualisation avant final. Construire une prévisualisation officielle et attendre l'approbation, sauf si l'utilisateur demande explicitement un export direct.
5. Qualité originale du final. Ne pas présenter une prévisualisation basse résolution upscalée comme un véritable final haute résolution. Utiliser la source originale comme base finale autant que possible.
6. Ne pas interrompre la progression. Si un rendu avance, attendre et rapporter la progression. Changer de pipeline uniquement après une erreur réelle ou une approbation explicite.
7. Aucune donnée privée dans le skill. Les chemins de projet locaux, noms de médias, règles de marque, captures d'écran, détails clients et clés API restent dans le projet de l'utilisateur.
8. Apprendre uniquement à partir de retours explicites. Ne pas déduire des règles de style permanentes à partir du silence ou d'un seul brouillon non confirmé.
9. La typographie fait partie de la correction. Déclarer et vérifier la famille de polices, le poids réel, la politique de lignes de sous-titres, l'alignement de la ligne de base et l'ajustement du libellé le plus long avant l'approbation.
10. Les valeurs par défaut publiques restent neutres en marque. Stocker les palettes du créateur, les systèmes de cartes récurrents et les règles visuelles privées uniquement dans le profil local.
11. Une installation publique expose un seul Skill. Garder les modules d'étape sous references/workflows/ ; ne pas ajouter de fichiers SKILL.md imbriqués que les gestionnaires de paquets pourraient enregistrer séparément.
12. Les opérations d'installation sont récupérables. Sauvegarder une installation existante avant remplacement et archiver les cibles de désinstallation au lieu d'effectuer une suppression forcée récursive.
13. Les fournisseurs optionnels restent optionnels. Le pack de plans par défaut organisé est natif HyperFrames + GSAP. Ne jamais cloner, installer, mettre à jour ou exiger ShotCraft, Remotion, ou un autre fournisseur sans consentement explicite de l'utilisateur. Les recettes natives doivent rester un repli complet.

Lire references/quality-gates.md avant tout travail de prévisualisation ou d'export.

Table de Routage

Intention ou phrase de l'utilisateur	Route	Sortie typique
初始化视频项目, 第一次用, start a video project	references/workflows/init.md	État, plan de montage, profil de conception
原片还没剪, 删口误和停顿, 帮我粗剪, raw takes, rough cut	references/workflows/rough-cut.md	Montage brut non destructif approuvé et transfert de timing
抽字幕轴, 只做字幕, transcribe, 改字幕	references/workflows/captions.md	SRT, CSV, JSON de transcription
帮我设计, 换颜色风格, 规划弹窗, design	references/workflows/design.md	DESIGN et plan de montage complet
参考这张截图设计, 按这张图的视觉语言, style reference	references/workflows/design.md branche de référence	STYLE_REFERENCE local au projet
按语义匹配动效, GSAP 动效丰富一点, semantic motion	references/workflows/design.md, puis prévisualisation	MOTION_PLAN validé et prévisualisation
参考 ShotCraft, 推荐电影感镜头, cinematic shot reference	references/workflows/design.md branche ShotCraft	Références de plans optionnelles mappées dans MOTION_PLAN
做预览, 加动效, build preview	references/workflows/preview.md	URL de prévisualisation officielle
出成片, 导出 4K, export final	references/workflows/export.md	Vidéo finale vérifiée
改这个, 恢复上一版, revise	references/workflows/revise.md	Révision ciblée et nouvelle prévisualisation/final
进度, 到哪了, status	references/workflows/status.md	Étape actuelle et prochaine action
体检, 为什么失败, doctor	references/workflows/doctor.md	Diagnostic en lecture seule
以后都这样, 记住这个风格, learn this	references/workflows/learn.md	Leçons locales au projet confirmées
复盘成片, 下次怎么改进, retro	references/workflows/retro.md	Rétrospective structurée de livraison
升级状态, 迁移, migrate	references/workflows/migrate.md	Mise à niveau du schéma d'état

Détection de Mode

Avant le routage :

1. Identifier le répertoire du projet vidéo de l'utilisateur, pas ce dépôt de skill.
2. Chercher .naive-video-state.json.
3. S'il est absent et que la tâche est plus qu'une modification ponctuelle de texte de sous-titre, charger le workflow d'initialisation.
4. S'il est présent, le lire ainsi que EDIT_PLAN.md, DESIGN.md, et VIDEO_LESSONS.md uniquement lorsque c'est pertinent. Utiliser working_video lorsqu'elle est présente ; sinon utiliser main_video.
5. Exécuter python3 tools/video_doctor.py --project <project_dir> lorsque l'état et les fichiers sont en désaccord.

Utiliser ces étapes :

initialized -> captions_ready -> design_ready -> preview_ready
-> approved -> rendering -> final_ready

Ne jamais marquer une étape ultérieure tant que sa porte de qualité n'est pas passée.

Pipeline par Défaut

Lorsque l'utilisateur demande le workflow complet :

1. Inspecter le média source avec ffprobe.
2. Initialiser l'état du projet et les répertoires de sortie sécurisés.
3. Demander si les images sont déjà montées uniquement lorsque ce statut n'est pas clair. Si ce sont des rushs bruts, charger le workflow de montage brut optionnel et exiger l'approbation de la stratégie.
4. Produire ou valider les fichiers de sous-titres à partir de working_video lorsqu'elle est présente, sinon main_video.
5. Demander si des captures d'écran, enregistrements, images de produits, graphiques ou démos doivent apparaître. Laisser l'utilisateur choisir un placement sémantique, des secondes exactes / ancres de phrases parlées, ou un hybride ; expliquer que les ancres exactes sont plus précises.
6. Normaliser le timing au niveau des mots lorsqu'il est disponible et diviser le discours en groupes logiques face au spectateur. Ne pas simuler la précision des mots à partir de débuts de sous-titres entiers.
7. Collecter ou déduire un profil de style et des zones de sécurité. Proposer une correspondance de référence de capture d'écran optionnelle aux débutants.
8. Écrire un plan de montage et un plan de mouvement sémantique avec chaque insertion demandée, lien de groupe logique et plage de temps.
9. Pour les nouveaux projets, mapper automatiquement quelques nœuds sémantiques sécurisés au pack natif inspiré de ShotCraft organisé, sauf si l'utilisateur choisit skip. Préserver les projets approuvés existants, la recette native et le repli hors ligne.
10. Pour les premières utilisations, les nouveaux styles ou les travaux intensifs en raisonnement, rendre des images clés statiques représentatives et résoudre les problèmes de composition avant une prévisualisation dynamique complète.
11. Construire une prévisualisation HyperFrames + GSAP en utilisant un proxy compatible navigateur si nécessaire.
12. Exécuter les portes de qualité de prévisualisation et fournir l'URL de prévisualisation officielle.
13. Attendre l'approbation sauf indication explicite de passer.
14. Rendre les incrustations ou la composition finale en utilisant la vidéo de travail approuvée et son horloge audio.
15. Vérifier l'existence du fichier, la durée, la résolution, la fréquence d'images et l'audio.
16. Enregistrer uniquement les retours confirmés comme leçons locales au projet.
17. Après la livraison, exécuter une rétrospective factuelle et promouvoir uniquement les règles explicites et respectueuses de la vie privée.

Fichiers du Projet

Le workflow d'initialisation crée cette mémoire minimale du projet sans toucher au média source :

<project_dir>/
├── .naive-video-state.json
├── EDIT_PLAN.md
├── DESIGN.md
├── CONTENT_LOGIC.json       # groupes de raisonnement face au spectateur et repères temporels
├── STYLE_REFERENCE.md       # créé uniquement lorsqu'une image de référence est utilisée
├── MOTION_PLAN.json         # créé lorsqu'un mouvement sémantique est planifié
├── VIDEO_LESSONS.md
├── VIDEO_RETRO.md
├── edit/
│   ├── rough-cut.mp4            # optionnel ; le média original n'est jamais écrasé
│   ├── rough-cut-edl.json       # enregistrement de décision optionnel
│   ├── script-aligned.srt
│   ├── caption-table.csv
│   └── transcripts/
├── preview/
├── final/
└── qa/
    └── KEYFRAME_REVIEW.md   # revue de composition statique avant prévisualisation dynamique

L'état est des métadonnées opérationnelles, pas une base de données multimédia. Le garder petit et ne jamais y stocker de corps de transcription, captures d'écran privées ou secrets. Voir references/state-management.md.

Valeurs par Défaut de Style

Si l'utilisateur veut de la rapidité et ne donne aucune référence :

• Conserver le rapport hauteur/largeur de la source.
• Utiliser un système de cartes propre et lisible avec une couleur d'accent configurable.
• Utiliser des sous-titres en gras avec une emphase de mot retenue.
• Utiliser les transformations GSAP et l'opacité pour le mouvement.
• Placer les cartes dans un espace vide vérifié.
• Réduire la densité de mouvement pendant que les captures d'écran ou démos sont visibles.
• Garder le texte lisible aligné sur la ligne de base ; animer le composant conteneur au lieu d'incliner les étiquettes.
• Choisir un nombre maximal de lignes de sous-titres explicite et une politique de retour à la ligne.

Demander une couleur d'accent uniquement si la cohérence de marque est importante. Sinon, utiliser le préréglage neutre et faciliter le changement ultérieur. Les débutants peuvent éventuellement fournir une capture d'écran et choisir une force de référence faible, moyenne ou élevée ; expliquer que le skill copie le langage visuel, jamais la marque ou le contenu source. La densité de mouvement est retenue, équilibrée ou énergique. Voir references/style-onboarding.md.

Les recettes GSAP détaillées et les mappages sémantiques se trouvent dans references/motion-recipes.md. La sélection de l'environnement d'exécution et des plugins se trouve dans references/gsap-runtime.md. L'extraction de captures d'écran et les règles anti-copie se trouvent dans references/style-reference-workflow.md. Les choix de synchronisation des actifs se trouvent dans references/asset-onboarding.md. Les charger uniquement pour la branche de conception correspondante.

Les règles de découverte et d'adaptation ShotCraft se trouvent dans references/shotcraft-integration.md ; le pack natif pour débutants se trouve dans references/shotcraft-default-pack.md. Les charger pour les nouveaux projets automatiques, les cartes nommées ou les demandes de plans cinématographiques. Ne jamais installer un fournisseur silencieusement.

Le timing au niveau des mots, les groupes logiques face au spectateur, et le comportement d'accumulation/sortie se trouvent dans references/content-logic-workflow.md. Le charger après les sous-titres et avant la conception sémantique.

La typographie, la géométrie des composants, les notifications vitrées, et l'adaptation focus/type/split compatible avec la recherche se trouvent dans references/visual-quality-rules.md. Le charger pour chaque tâche de conception ou de prévisualisation.

Contrat d'Auto-Ittération

L'auto-ittération signifie améliorer le flux de travail actuel de l'utilisateur sans le divulguer dans les valeurs par défaut publiques.

Classer les retours dans un périmètre :

• project : s'applique uniquement à cette vidéo.
• profile : s'applique aux futures vidéos de cet utilisateur ; l'écrire uniquement après confirmation explicite.
• product : une amélioration générale et fiable, respectueuse de la vie privée ; la proposer séparément au responsable du skill.

Enregistrer les retours du profil dans VIDEO_LESSONS.md avec les mots de l'utilisateur, la règle confirmée et la