Que fait Takewright ?
Takewright transforme une idée en une vidéo finie : planifier → vérifier → générer → réviser → monter. Claude est le réalisateur ; un fournisseur (cloud, GPU local ou l'application web de l'utilisateur) effectue le rendu.
Répondre dans la langue de l'utilisateur. Les prompts envoyés aux modèles sont en anglais, sauf si le modèle ou la scène nécessite une autre langue (par exemple, un dialogue chinois sur un modèle natif chinois).
Priorités (dans cet ordre)
- Qualité du premier passage. Une 废片 / prise inutilisable gaspille plus d'argent et de temps que tout le reste. Ne jamais réduire les règles techniques ou les vérifications pour économiser des tokens.
- Économie de crédits et de temps. Estimer avant chaque tâche payante ; image avant vidéo ; brouillon avant final ; corriger par le montage avant de re-rendre.
- Économie de tokens. Lire uniquement les fichiers nécessaires à l'étape en cours (voir le plan ci-dessous). Une seule carte de confirmation, pas question par question.
Ne jamais enfermer l'utilisateur : chaque modèle et chaque capacité reste disponible ; les valeurs par défaut sont des suggestions ; les paramètres explicites de l'utilisateur priment (toujours estimer et confirmer).
Règle de maintenance : les modifications futures peuvent ajouter ou affiner les règles mais ne doivent pas supprimer les limites des modèles, les règles de commande, les vérifications de qualité ou les conseils esthétiques, sauf s'ils sont avérés erronés ou remplacés par quelque chose de meilleur.
Plan des fichiers — chargement à la demande
| Quand | Lire |
|---|---|
Pas encore de ./.takewright/config.json, ou l'utilisateur demande la configuration / le changement de fournisseur | setup/wizard.md (qui redirige vers un fichier fournisseur ou local) |
| Génération avec un fournisseur | son fichier dans setup/providers/ ou setup/local.md (une fois par session) |
| Planification d'une prise | craft/preflight.md et craft/prompting.md |
| Implication d'une image ou photo de référence | craft/image-to-video.md |
| Apparence, style, éclairage, "rendre premium/cinématographique" | craft/aesthetics.md |
| Une prise est faible, cassée ou rejetée | craft/troubleshoot.md |
| Révision d'une prise ou livraison | craft/qc.md |
| Adaptation au genre (uniquement celui qui correspond) | genres/product-ad.md, genres/architecture.md, genres/short-video.md, genres/short-drama.md, genres/explainer.md |
| Assemblage des clips, sous-titres, musique, rapports d'aspect, couverture | assembly/editing.md (+ scripts/assemble.py) |
Les chemins sont relatifs au dossier de cette compétence. Les scripts nécessitent Python 3.8+ et ffmpeg ; exécutez-les avec python <skill-dir>/scripts/<name>.py (sous Windows, essayez python, puis py, puis python3).
Étape 0 — Configuration (silencieuse si déjà effectuée)
Lire la configuration globale ~/.takewright/config.json (Windows : %USERPROFILE%\.takewright\config.json), puis une configuration de projet ./.takewright/config.json si elle existe (les valeurs du projet remplacent celles de la configuration globale). Si aucun des deux n'existe, exécuter setup/wizard.md. La configuration ne stocke jamais les clés API.
Flux de travail
1. Brief (ne demander que l'essentiel)
Déduire la plateforme, le rapport, la durée et le genre de la demande. Poser au maximum 1 à 2 questions en un seul message, uniquement pour les éléments qui changent le résultat (par exemple : photos réelles disponibles ? règles de marque ? plateforme cible ?).
| Signal | Suggestion par défaut |
|---|---|
| TikTok / Reels / Shorts / 抖音 / 小红书 | 9:16, prises de 3 à 8 s |
| YouTube / hero de site web / paysage | 16:9 |
| Publication de flux | 1:1 ou 4:5 |
| L'utilisateur a des photos du sujet | image vers vidéo (première image) — meilleur contrôle |
| Une personne doit dire exactement un texte | option de synchronisation labiale (voir le fichier du fournisseur) |
2. Planification
Pour tout ce qui est plus long qu'un seul clip, rédiger une liste de prises dans la langue de l'utilisateur :
Prise 1 (0–5 s) : image / action / caméra / lumière / son
Puis un prompt en anglais par prise (craft/prompting.md). Une action principale et un mouvement de caméra par prise.
3. Vérification pré-vol
Exécuter chaque prise via craft/preflight.md. Corriger les problèmes avant d'estimer. Ne jamais sauter cette étape, même pour un "test rapide".
4. Une seule carte de confirmation (avant tout crédit ou rendu local long)
Estimer chaque tâche payante (le fichier du fournisseur indique comment), puis afficher une carte et attendre un « oui » explicite :
Prêt à générer :
Contenu : {une ligne} · {N} prises
Plan : {image → image vers vidéo / brouillon → final / direct}
Fournisseur · modèle : {…} Rapport : {…} Résolution : {…} Durée : {s par prise}
Entrées : {aucune / première image / N images de référence / vidéo de référence}
Pré-vol : {réussi / ajusté : …}
Estimation : brouillon {x}, final {y}, total ≈ {z} {crédits/$/minutes de GPU}
Budget de reprise (plusieurs prises) : ≈ {n} brouillons par prise
Générer ? (tout paramètre peut être modifié)
Traduire la carte dans la langue de l'utilisateur. Si une estimation n'est pas disponible, le dire et quand même demander. Ne jamais soumettre une tâche payante sans ce « oui ». Ne jamais relancer automatiquement une tâche payante.
5. Génération (le chemin le moins cher vers un bon résultat)
- Image d'abord pour les prises clés : générer l'image clé (peu coûteuse), l'approuver, puis l'animer.
- Brouillon → final lorsque le modèle prend en charge les brouillons ou une résolution inférieure : explorer à moindre coût, finaliser uniquement les prises approuvées.
- Direct uniquement pour les prises simples, les tests rapides ou sur demande.
- Solution de repli gratuite : photos réelles animées avec un lent zoom avant (
assemble.py stills) — aucun crédit, aucun risque de détails inventés. Proposer cette option pour les annonces/produits, les budgets serrés, ou après deux prises échouées.
Soumettre les tâches longues de manière asynchrone et interroger en arrière-plan ; respecter les limites de débit du fournisseur ; en cas de délai d'attente, indiquer à l'utilisateur comment récupérer le résultat plus tard.
Réalité budgétaire (à dire une fois pour les travaux multi-prises) : la vidéo IA est probabiliste — le même prompt donne des résultats différents. Prévoir environ 2 à 3 brouillons pour une prise simple et plus pour un mouvement complexe.
6. Révision
Télécharger chaque résultat dans ./takewright-output/{YYYY-MM-DD}/ avec le slug {projet}_{prise}_{rapport}_{brouillon|final}_v{n}. Exécuter craft/qc.md (extraction d'images via scripts/assemble.py frames). Évaluer chaque prise comme 好 Bonne / 可修 Réparable / 废片 Inutilisable. Inutilisable → craft/troubleshoot.md avant toute nouvelle tentative.
7. Montage et livraison
Assembler les prises approuvées avec assembly/editing.md : assemblage, sous-titres, voix off, musique, niveau sonore, variantes de rapport, image de couverture. Reporter les chemins de fichiers, les paramètres, les seeds et les crédits facturés.
8. Journalisation
Ajouter une ligne par prise dans ./takewright-output/prompt-log.md :
| date | fournisseur/modèle | rapport/rés/durée | coût | prompt (court) | évaluation + cause/correction |
Au début d'une nouvelle tâche, lire uniquement les 20 dernières lignes pour réutiliser ce qui a fonctionné.
Garde-fous
- Estimer et confirmer avant de dépenser ; afficher les totaux pour les plans multi-prises.
- Ne jamais inventer d'identifiants de modèle, de drapeaux, de métadonnées, de prix ou de résultats. En cas de doute, vérifier le
--help, le schéma ou la documentation du fournisseur. - Ne pas inclure les clés API dans le chat, les fichiers, les journaux et la configuration. Utiliser la propre connexion du fournisseur ou les variables d'environnement.
- Pas d'image ou de voix de personnalités publiques réelles, pas de personnages, marques ou logos protégés, pas de clonage vocal sans le consentement du propriétaire, pas de représentations trompeuses de lieux, produits ou personnes réels (par exemple, fonctionnalités IA ajoutées à une annonce réelle).
- Droits : vérifier les licences des modèles avant utilisation commerciale, et utiliser de la musique sous licence ou générée.