Communitygithub.com

Promotion produit à partir du dépôt

Préparez une vidéo promotionnelle ou de lancement (宣传片、产品介绍视频、功能演示片) pour un produit logiciel dont le code source se trouve dans un dépôt git — scénarios, un découpage plan par plan, une voix off MiniMax (配音), une bande originale synthétisée en code, et les écrans du produit redessinés en HTML à partir du code du dépôt. Utilisez-le quand l'utilisateur souhaite une promo, un film de lancement ou une démo vidéo « pour cette application / ce projet / ce dépôt », ou donne une URL GitHub ou un projet local et dit « 做个视频 ».

Qu'est-ce que Promotion produit à partir du dépôt ?

Cette compétence experte automatise la création d'une vidéo promotionnelle professionnelle (30 à 45 secondes) pour tout produit logiciel dont le code source est disponible dans un dépôt Git. Elle extrait directement les informations du code (navigation, composants, données de seed, logos) pour garantir une fidélité totale au produit réel. Le processus inclut : l'analyse du code sur la bonne branche, l'écriture de trois storylines alternatives, la génération d'une voix off via l'API MiniMax, la synthèse d'une bande originale personnalisée, et le redessin des écrans en HTML à partir des composants réels du dépôt. Elle ne nécessite aucun lancement de l'application ni mock de backend, et produit un cahier des charges précis (SPEC.md) ainsi qu'une revue qualité (REVIEW.md). La compétence est conçue pour être utilisée avec des outils d'IA agent (Claude Code, Cursor, etc.) et privilégie les outils gratuits pour le rendu final.

Compatible avec~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/rayest/ai-video-skills/tree/HEAD/skills/product-promo-from-repo

Demander à votre IA préférée

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

Documentation

Promotion produit à partir d'un dépôt

Un film de 30 à 45 secondes qui montre un utilisateur effectuant une tâche réelle dans le produit, avec des libellés réels du code, une voix off et une bande originale. Cette compétence couvre l'obtention du produit à partir de son code, l'histoire, la voix, la musique et les écrans redessinés. Elle n'impose pas de moteur de rendu ; choisissez-en un avec l'utilisateur (préférez les outils gratuits).

1. Lire le bon code

  • git fetch --all et comparez les branches (git log -1 origin/<b> pour chacune) avant de lire quoi que ce soit. La branche par défaut peut être obsolète — main peut encore être le commit initial alors que le produit a été renommé et reconstruit sur dev. Construire des storylines sur la mauvaise branche perd une itération complète. Si l'utilisateur dit que le nom ou les fonctionnalités ont changé, croyez-le et trouvez la branche qui les contient (git grep -c <nouveau nom> origin/<b>).
  • Collectez des faits, pas des impressions : la navigation (la propre carte du produit de ce qu'il fait), les composants de la page du flux de tâche principal, les noms de catalogue dans les données de seed du backend, les limites et nombres réels (longueurs max, formules comme « 预估秒数 = 字数 ÷ 4.5 »). Chaque affirmation dans le film doit provenir de l'un d'eux.
  • Copiez le logo et les vignettes/icônes du dépôt dans assets/. Vérifiez que le logo ne contient pas d'ancien texte de marque.

2. Storylines, puis stop

Écrivez trois storylines dans STORYLINES.md (chacune : prémisse en une ligne, liste de battements avec durées, la transition qui porte chaque jointure) et arrêtez-vous pour que l'utilisateur choisisse. Celle qui a le mieux fonctionné pour un produit multi-étapes : un objet traverse les étapes du produit (un article trouvé → une carte de sujet → un script → une vidéo finie), entré par le curseur qui le saisit. Mettez votre recommandation en premier.

Indiquez les hypothèses en une ligne : durée 30–40 s, 1920×1080, musique + effets, voix off oui/non, les données produit à l'écran sont des données de démo.

3. Voix off (MiniMax)

Seulement quand on vous le demande. Saisissez $MINIMAX_API_KEY ou la première ligne de ~/.minimax_key ; ne l'affichez jamais.

  1. Une ligne courte par battement dans voice/script.json ([{"id", "text"}]), ~4.5 caractères chinois par seconde, ~120–140 caractères pour 35–40 s. Les lignes sont cause et effet, pas des slogans ; l'écran montre des mots-clés, jamais la phrase parlée textuellement.
  2. Montrez les lignes à l'utilisateur, l'ID de la voix et le modèle, et obtenez un accord — chaque appel est facturé. python3 -I scripts/tts_minimax.py voice --dry-run affiche le nombre de caractères et la durée estimée.
  3. Générez une fois : python3 -I scripts/tts_minimax.py voice [--voice ID] → vo-<id>.mp3 et durations.json. Régénérez une ligne avec --only id.
  4. La voix est l'horloge : disposez les scènes à partir de durations.json (chaque ligne commence ~0.15–0.25 s après le début de sa scène ; scène ≈ ligne + 0.3–0.6 s).

4. Écrans du produit : redessiner à partir du code

Ne lancez pas l'application et ne simulez pas son backend pour des captures d'écran ; reconstruisez les écrans en HTML à partir des composants, du CSS et des données backend. Lisez references/ui-redraw.md avant la première scène du produit.

Étiquetez les données de démo 演示数据 · 虚构. Ne montrez jamais un ancien nom ou logo de produit, et n'inventez jamais un bouton que le code ne possède pas.

5. Musique et effets

  • scripts/score.py synthétise une piste originale dont la grille de mesures place un temps fort sur le payoff et le logo sur un nombre entier de temps plus tard (nécessite numpy + scipy) : score.py assets/bgm/score.wav --total 38.5 --bpm 104 --hook-end 4.6 --reveal 9.8 --build 24.2 --payoff 27.0 --claim 31.6 --logo-beats 13 Choisissez --logo-beats de sorte que payoff + beats × 60/bpm tombe là où le carton de fin arrive.
  • Effets provenant de sources gratuites (clic, whoosh, pop, frappe, crescendo, impact, scintillement). Un son par cause visible.

6. Spécification et révision

  • Écrivez SPEC.md avant les scènes : OBJECTIF, SORTIE, TEMPS, VOIX, DONNÉES, ASPECT, OBJETS, MOUVEMENT, PLANS avec durées, INTERDIT, images de référence QA.
  • Vérifiez chaque battement et jointure : corrigez les jointures dont la direction du mouvement s'inverse (un objet quittant par la droite doit entrer dans la scène suivante par la droite), les éléments qui disparaissent avant d'atterrir, les moitiés vides d'une image héroïque.
  • Écrivez REVIEW.md : choix créatifs, ce qui a été mesuré par rapport à ce qui a été seulement regardé, le plan le plus faible.
  • Audio final : environ -16 à -14 LUFS, crête vraie ≤ -1 dBTP, pas d'écrêtage. Dites que le son a été mesuré, pas entendu.

Individual skills in this repo

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

Skills associés