Communitygithub.com

lhaovo/short-video-skills

Prépare les assets visuels pour la génération de vidéos courtes : transforme une liste d'assets en素材 prêts à être utilisés par un modèle de génération d'images. Ordonne la production, classe les assets, génère des candidats, valide la cohérence, enregistre les fichiers numérotés et met à jour le statut de la liste. Supporte trois sources : prises de vue réelles, génération AI et素材 officiels. À utiliser lorsque l'utilisateur dit « prépare les素材 », « sors les assets », « image de première image », « vues à trois faces du personnage », « exécute l'image produit », « les assets ne correspondent pas », « quelles images pour cette scène ». Fait uniquement les images et les valide, n'écrit pas de storyboard et ne génère pas de vidéo.

Qu'est-ce que short-video-skills ?

Ce skill, nommé « 资产准备台 » (Station de Préparation d'Assets), est conçu pour les workflows de génération de vidéos courtes. Il résout un problème fondamental : garantir la cohérence visuelle d'un même élément à travers toutes les images. En entrée, il prend une liste d'assets ou un storyboard ; en sortie, il produit des images nommées de manière standardisée, directement référençables comme première image par un outil de génération vidéo comme `short-video-generate`. Le skill ne rédige pas de storyboard, ne génère pas de vidéo, et ne produit pas de prompts vidéo. Il se concentre exclusivement sur la phase de création et de validation des images. Il classe les assets en trois niveaux (Ancrage, Dérivé, Jetable) pour optimiser les efforts, et suit un processus en sept étapes : lire la liste, ordonner, classer, générer des candidats, valider, enregistrer, et mettre à jour le statut. Il supporte les prises de vue réelles, la génération AI (via un script intégré `scripts/kie_gen.py`), et les素材 officiels, avec une gestion stricte des versions et de la cohérence. Une validation automatique via un script (`scripts/check_assets.py`) est disponible pour garantir l'intégrité des assets avant livraison. Le skill insiste sur des règles strictes de cohérence, notamment la comparaison côte à côte des images dérivées avec leur ancrage, pour éviter les incohérences géométriques, d'éclairage ou d'impression. Il est particulièrement utile sur les plateformes d'agents comme Claude Code ou Cursor, où l'automatisation de la préparation des assets est cruciale pour la productivité.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/lhaovo/short-video-skills/tree/HEAD/short-video-assets

Demander à votre IA préférée

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

Documentation

Poste de Préparation d'Assets (资产准备台)

La capacité à générer des vidéos dépend de cette étape. Le seul problème à résoudre : faire en sorte que la même chose soit la même chose dans chaque image.

L'entrée est une liste d'assets (ou un storyboard), la sortie est un ensemble d'images nommées par numéro, directement référençables comme première image par short-video-generate.

Ce poste ne rédige pas de storyboard, ne découpe pas de segments, n'écrit pas de prompts vidéo et ne génère pas de vidéo. Il est responsable de la partie « image ».


I. Quatre Règles d'Or

  1. D'abord l'ancrage, ensuite la dérivation. Tant que la version maître n'est pas définie, ne faites pas d'images sous différents angles. Les images d'angle sont développées à partir de la version maître ; si la version maître est erronée, tout le groupe l'est aussi.
  2. Ne modifiez qu'une seule variable à la fois. Si vous changez l'angle, ne changez pas l'éclairage ; si vous changez l'éclairage, ne changez pas l'angle. Si vous modifiez les deux en même temps, il sera impossible de déterminer la cause d'un problème.
  3. Ajoutez des candidats, ne remplacez jamais. v1, v2 coexistent. La version choisie est notée dans le bon de travail. La génération est probabiliste ; supprimer l'ancienne version revient à supprimer une solution de repli.
  4. Les images et la liste doivent correspondre. Le numéro est le nom du fichier. Si la liste contient PR-01, le répertoire doit contenir PR-01_*.

II. Les Assets sont Classés en Trois Niveaux

Toutes les images ne méritent pas le même investissement. Classez d'abord, puis allouez les efforts.

NiveauQu'est-ce que c'est ?ExempleExigence
AncrageRéférence d'identité pour tout le film, référencée à plusieurs endroitsImage principale du produit, vues à trois faces du personnage, vue panoramique de la scène principaleLe plus strict : plusieurs candidats, validation item par item, ne plus modifier après la version finale
DérivéAngles, états, détails développés à partir de l'ancrageDos du produit, état ouvert, gros plan de la mainDoit être comparé côte à côte avec l'ancrage
JetableN'apparaît qu'une seule fois, n'affecte pas la cohérencePlans vides, effets lumineux,素材 de transitionAcceptable si c'est suffisant, pas besoin de plusieurs candidats

Un mauvais classement gaspille du temps : Traiter un plan vide comme un ancrage peut bloquer une vidéo de 30 secondes pendant trois jours ; traiter l'image principale du produit comme un jetable obligera à tout refaire pour chaque segment suivant.


III. Sources : Trois Possibilités, Choisissez Selon l'Usage

SourceQuand l'utiliser ?Attention
Prise de vue réelleObjet réel, besoin de précision, implique des paramètres ou des effetsMeilleure option, mais nécessite des素材
Génération AIPas d'objet réel, scène fictive, ambiance, main humaineNécessite de verrouiller la géométrie et l'impression, plusieurs candidats
素材 OfficielsImage principale, image d'emballage fournie par la marqueÀ utiliser directement comme ancrage, le plus stable

Les prises de vue réelles ne sont pas obligatoires. Pour un film entièrement généré par AI, l'ensemble des assets peut être produit par AI, à condition qu'il y ait une cohérence interne.

Un Risque à Signaler Clairement à l'Avance

Si ce film doit annoncer des paramètres ou effets spécifiques (capacité, durée, ingrédients, résultat) au public, et que le produit à l'écran est généré par AI, alors l'image et l'allégation ne correspondront pas – au mieux, cela sera signalé dans les commentaires, au pire, cela constituera une publicité mensongère.

Une seule façon de gérer cela : s'il y a une allégation, l'image du produit doit être une prise de vue réelle ou un素材 officiel ; s'il n'y a pas d'allégation, pure ambiance ou contenu fictif, la génération AI est parfaitement suffisante.

Il suffit de poser la question avant de commencer ; ne découvrez pas le problème une fois le film terminé.

Comment Exécuter la Génération AI

Utilisez le script intégré scripts/kie_gen.py (KIE GPT Image 2). Il effectue la soumission, l'interrogation, le téléchargement et l'enregistrement selon la convention de nommage en une seule fois :

# Texte vers image (la résolution par défaut est 1K, suffisante)
python scripts/kie_gen.py generate --prompt "…" --ratio 9:16 \
  --out 04-素材/01-资产图/PR-01_产品主图_v1.png

# Image vers image : utilisez l'ancrage comme référence
python scripts/kie_gen.py generate --prompt "…" --ref PR-01_产品主图_v1.png \
  --out 04-素材/01-资产图/S01_f01_v1.png

# Batch : lisez une table de tâches JSON (par défaut 5 tâches en parallèle)
python scripts/kie_gen.py batch --tasks tasks.json --out-dir 04-素材/01-资产图 --dry-run
python scripts/kie_gen.py batch --tasks tasks.json --out-dir 04-素材/01-资产图

La résolution par défaut est 1K : ces images seront finalement rééchantillonnées par le modèle vidéo. Faire une image source plus grande ne préserve pas les détails, cela augmente seulement le taux d'échec. N'ajoutez --resolution 2K que pour un agrandissement et recadrage séparé (pour la couverture) ou pour une version maître sur fond blanc à réutiliser.

Par défaut, le batch exécute 5 images en parallèle. La génération d'image prend 10 à 40 secondes ; exécuter 6 images en série signifie attendre 3 à 4 minutes. Avec 5 images en parallèle, le temps total est environ égal à celui de l'image la plus lente plus un tour. En cas de limitation de débit (code != 200 ou 429), utilisez --concurrency 2. Ne modifiez pas le prompt à cause d'une limitation de débit.

Quatre règles :

  1. Utilisez d'abord --dry-run pour voir le corps de la requête, puis exécutez vraiment. Soumettre vingt images en un seul batch avec des paramètres erronés, c'est vingt gaspillages.
  2. La clé API ne passe que par la variable d'environnement KIE_API_KEY. Ne l'écrivez pas dans les scripts, les tables de tâches ou les bons de travail.
  3. Générez d'abord l'ancrage, confirmez le style, puis le reste en batch. Pour les assets de niveau ancrage, réduisez la concurrence et examinez chaque image une par une.
  4. Notez le taskId dans le bon de travail. Il servira de référence pour régénérer la même image plus tard.

Pour la syntaxe, les limites de paramètres et la gestion des échecs, voir references/ai-generation.md.


IV. Processus en Sept Étapes

1 Lire la liste → 2 Ordonner → 3 Classer → 4 Générer des candidats → 5 Valider → 6 Enregistrer → 7 Mettre à jour le statut

Étape 1 · Lire la Liste

Lisez le numéro, le type, l'usage, la source et les segments de référence à partir de 02-资产清单.md.

Si la liste ne contient pas de prompt d'image, utilisez les quatre types de squelettes dans references/prompt-fixups.md pour les compléter ; sinon, utilisez-les directement, ne les réécrivez pas.

Étape 2 · Ordonner la Production

Ancrage → Dérivé → Jetable

Au sein d'une même catégorie, triez par nombre de références. Plus un asset est référencé, plus il doit être fait en premier. Raison : si un asset très référencé doit être refait, cela impactera le plus grand nombre de segments.

Pour les lieux réutilisés sur plusieurs segments dont la continuité spatiale est importante, divisez les assets en deux couches selon les besoins :

  1. Version maître de la structure spatiale : sans personne, sans action ; verrouillez les matériaux du sol/mur, les vitrines et les volumes du bâtiment, la structure de fond fixe, les relations de profondeur spatiale, ainsi que la source et la direction approximative de la lumière principale. Ne verrouillez pas les positions de caméra spécifiques, les échelles de plan, les personnages ou les accessoires temporaires.
  2. Sous-version maître de la position de caméra : dérivez du même espace les plans vides réellement utilisés : plan large de face, plan rapproché de côté, plongée, contre-plongée ou gros plan. La première image est dérivée de la sous-version maître de la position de caméra correspondante, évitant ainsi que tout le film hérite de la même perspective et composition.

Pour chaque espace, ne faites que les angles de vue réellement utilisés ; ne forcez pas un nombre fixe. La direction de la lumière doit maintenir la continuité spatiale, mais les versions d'éclairage (midi/soir) sont déterminées par la chronologie du scénario. Évitez d'incorporer inutilement des caractéristiques temporelles fortes dans la version maître de base. Validez d'abord les positions de caméra représentatives côte à côte, puis dérivez en batch les premières images.

Étape 3 · Classer

Attribuez un niveau à chaque numéro (Ancrage / Dérivé / Jetable) et inscrivez-le dans le bon de travail. Cette étape ne prend qu'une minute, mais détermine le nombre de candidats à générer pour la suite.

Étape 4 · Générer des Candidats

NiveauNombre de candidatsDescription
Ancrage4–6Choisissez-en un comme version finale, gardez les autres comme alternatives
Dérivé2–3Comparez avec l'ancrage puis sélectionnez
Jetable1–2Utilisable suffit

Avant de générer, confirmez trois choses : le format de l'image est-il correct ? Le fond est-il correct (fond blanc ou scène) ? Y a-t-il des éléments superflus (texte, filigrane, main) ?

Lors de l'utilisation de la génération AI, utilisez d'abord --dry-run pour vérifier les paramètres, puis soumettez dans l'ordre Ancrage → Dérivé, par lots de 4 à 6.

Étape 5 · Validation

Passez en revue les sept critères de references/acceptance.md. Six critères sur sept doivent être satisfaits pour conserver l'image. Si les critères clés (géométrie, impression) ne sont pas satisfaits, rejetez l'image directement.

Étape 6 · Enregistrement

04-素材/01-资产图/
├── PR-01_产品主图_v1.png
├── PR-01_产品主图_v2.png   ← Alternative, ne supprimez pas
├── SC-01_办公桌面_v1.png
└── CH-01_女性手部_v1.png

Format de nommage : <numéro>_<usage>_v<N>.<ext>. Le numéro doit correspondre à celui de la liste (les suffixes d'état A/B sont conservés), l'usage fait 2 à 8 caractères, peut être subdivisé avec des underscores, la version est incrémentée.

Étape 7 · Mettre à Jour le Statut

Changez le statut de la liste en « Disponible / Disponible avec alternative / À compléter », et notez la version choisie dans le bon de travail. Si vous ne mettez pas à jour le statut, l'étape suivante ne saura pas quelle version référencer.


V. Comment Garantir la Cohérence

Pour plusieurs images d'un même numéro, l'alignement repose sur quatre choses :

  1. Même description du sujet : copiée du prompt de l'ancrage, sans modification
  2. Même position lumineuse : la direction de la lumière principale et la température de couleur sont figées, les images dérivées ne changent pas d'éclairage
  3. Même format et fond : si c'est un fond blanc, tout est fond blanc ; si c'est une scène, tout est scène
  4. Comparaison côte à côte : placez les deux images l'une à côté de l'autre, vérifiez la géométrie, la couleur, l'impression, les proportions

La comparaison côte à côte est la méthode la plus efficace. En regardant une image seule, tout semble correct ; mises côte à côte, on découvre que la largeur de la tasse est de deux millimètres trop grande ou que le logo est décalé d'une ligne.

Voir les détails dans references/acceptance.md.


VI. Auto-Vérification (Script Exécutable)

python scripts/check_assets.py --dir <répertoire de production>

Cinq critères :

#CritèreNiveau
A1Chaque numéro de la liste a un fichier correspondantCritique
A2Le nom du fichier suit le format <numéro>_<usage>_v<N>Critique
A3Il n'y a pas de fichiers orphelins dans le répertoire, absents de la listeAvertissement
A4Chaque image a une résolution ≥ 720 pixels sur le petit côtéAvertissement
A5Les assets de niveau ancrage ont ≥ 2 candidatsAvertissement

Codes de sortie : 0 = Succès / 2 = Élément(s) critique(s) / 3 = Impossible de lire le répertoire.


VII. Limites

  • Ne rédige pas de storyboard : les besoins en assets proviennent du storyboard et de la liste ; ne modifiez pas le contenu vous-même
  • N'écrit pas de prompts vidéo : c'est le travail de l'étape amont ; ce poste ne fait que compléter les prompts d'image
  • Ne génère pas de vidéo : ne traite que des images statiques
  • Ne remplace pas le jugement : les critères de validation sont donnés, mais la décision finale « cette image est-elle utilisable ? » revient à l'humain
  • Ne garantit pas une sortie parfaite du premier coup : la génération est probabiliste ; ce poste garantit « des candidats, une validation, des versions »

VIII. Documents de Référence

FichierQuand le lire
references/production.mdPour ordonner, classer, générer des candidats, enregistrer et mettre à jour le statut
references/acceptance.mdPour valider, comparer côte à côte, rejeter et recommencer
references/prompt-fixups.mdLorsque la liste ne contient pas de prompt, ou qu'une image ne sort pas correctement après plusieurs tentatives
references/ai-generation.mdLors de l'utilisation de la génération AI : paramètres, syntaxe, batch, gestion des échecs
assets/asset-production-sheet.mdPour créer un bon de travail avant de commencer, mettre à jour le statut à la livraison
assets/batch-tasks-example.jsonExemple de table de tâches pour la génération en batch
scripts/kie_gen.pyPour soumettre, interroger, télécharger et enregistrer selon la convention de nommage
scripts/check_assets.pyÀ exécuter avant la livraison

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

lhaovo/short-video-skills

一条短视频从策划到发布的流程总控:建制作目录、依次走「剧本分镜 → 提示词 → 生成 → 交付 → 发布」五段、每段设门禁、记录流程状态、支持跨会话续做。当用户要开一条新片子、问「下一步做什么」、想接着做某条没做完的片子、要把分镜变成提示词、要整理素材与成片、要准备发布包时使用。本技能只规定流程、目录与产物标准,不重复各环节的写作规范。

lhaovo/short-video-skills

把已过 G2 的生成清单落成真实视频片段——按段建 KIE Seedance 任务、轮询、下载、媒体体检、抽帧质检、听声核台词,并把每段的状态与请求指纹写进生成台账。三种模式互斥(文生 / 首帧图生 / 首尾帧图生)。旁白由模型直接念,台词照稿写进提示词,不走独立 TTS 配音。当用户提到视频生成、出片段、跑 Seedance、首帧图生、首尾帧、原生音频、台词念错、任务查询、片段下载、生成失败重试时使用。只管「把已定的画面和台词变成成段素材」,不重新设计视觉、不改台词文本、不做字幕、不做剪辑。

lhaovo/short-video-skills

把「我想拍点什么」变成一条想清楚的片子——先定主题(出 5 个候选、标明类型、给出推荐与淘汰理由),再定结构与分段剧本,最后切成镜头级内容分镜。支持两种入口:一句话主题(需要发散选题)与已有拆解剧本(跳过选题,先问复刻需求与复刻强度再判定改写)。当用户提到选题、定主题、短视频策划、写剧本、写大纲、分镜、镜头脚本、不知道拍什么、内容怎么排、科普干货、剧情软广、钩子怎么写、复刻别人的剧本时使用。只管内容层(讲什么、怎么讲),不碰执行层;内置的内容红线只防明显自伤,不替代合规审查。

lhaovo/short-video-skills

把已定稿的分镜表翻成可直接执行的两份清单——资产清单(要准备哪些图、每张图的图像提示词)与生成清单(每段视频的时长、模式、素材引用与提示词)。覆盖画面化、资产编号、切分生成单元、Seedance 视频提示词写法、首帧方案、一致性与失败诊断。当用户说「把分镜变成提示词」「写视频提示词」「这条片子要哪些图」「生成清单」「某个镜头生成不出来」时使用。只做翻译与清单,不重新编排内容,不直接出图出片。

Skills associés