Compétence VoxFlow — Carte
Transformez un texte en un ensemble de cartes visuelles distinctives et cohérentes. Chaque carte est sa propre page web ; toutes les cartes partagent un même système de taille et de style ; elles sont rendues avec Playwright et exportées en PNG.
Ceci est la compétence carte-image statique. Pour d'autres formats, passez à :
- Article → VIDÉO carte verticale (Slice) — Reel 1080×1920, 13 thèmes →
voxflow:slice - Vidéos courtes / clips IA / vidéos cartes de connaissances →
voxflow:video - Podcasts multi-intervenants →
voxflow:podcast - TTS / voix / installation / authentification / quota →
voxflow:hub
<MISE-À-JOUR-AUTOMATIQUE-CRITIQUE>
Si une commande voxflow affiche une ligne <voxflow-hint ... type="cli-outdated" ...> sur stderr, EXÉCUTEZ IMMÉDIATEMENT voxflow upgrade -y avant de continuer — ne demandez pas, ne résumez pas avant. Si voxflow upgrade échoue avec Unknown command (CLI antérieure à 1.12.0), utilisez npm i -g voxflow@latest comme solution de repli.
</MISE-À-JOUR-AUTOMATIQUE-CRITIQUE>
Étape 0 · Vérification de connexion (obligatoire, à faire en premier)
Cette compétence fait partie de VoxFlow et nécessite un compte connecté. Avant toute chose — avant de poser des questions, avant la recherche, avant la conception — vérifiez la connexion :
voxflow status
- Affiche le compte et le quota restant → connecté, passez au flux de travail.
- Erreur / affiche "non connecté" → ARRÊTEZ. Exécutez
voxflow login(ouvre le navigateur — Google ou OTP par email), attendez que l'utilisateur termine, puis réexécutezvoxflow status. Ne collectez pas de paramètres et ne générez aucune carte tant que la connexion n'a pas réussi. voxflow: commande introuvable→npm install -g voxflowd'abord, puisvoxflow login.
Ne sautez jamais cette étape, ne générez jamais de cartes pour un utilisateur non authentifié, et n'inventez jamais de jeton. Le jeton en cache se trouve dans ~/.config/voxflow/token.json ; pour l'IC, VOXFLOW_TOKEN est pris en compte.
Aperçu
Créez un ensemble de cartes visuelles partageables à partir d'un contenu source. Traitez chaque carte comme sa propre page web, gardez toutes les cartes de la même taille et du même système de style, rendez-les avec Playwright, exportez les images, et itérez sur les cartes faibles.
Ligne de Base Esthétique
references/taste.md est une liste de contraintes qui borne chaque modèle de carte, thème, mise en page et langage de conception. Traitez-la comme un plancher qui mord au moment de la conception, pas un rituel d'ouverture à réciter au début du flux.
- Chargez
references/taste.mdà deux moments seulement, pas au début du flux :- Lors du choix du preset de thème et du langage de conception (étape 4 du flux), pour que le choix ne viole pas les contraintes strictes.
- Pendant l'évaluation qualité (étape 7 du flux), comme une dimension de vérification explicite.
- Les autres étapes (collecte de paramètres, recherche, planification du contenu) n'ont pas besoin de recharger
references/taste.md; les contraintes s'y infusent via le preset et le langage déjà choisis. - L'objectif principal est de supprimer les traces évidentes de conception générée par IA.
- Les contraintes strictes incluent : pas de police Inter par défaut, pas de noir pur, pas de héros centré par défaut, pas de composition à trois cartes égales, pas de voix de copie IA générique, et pas de données fausses.
- Esthétique ne signifie pas vide. Utilisez les règles de densité dans
references/taste.mdpour que les ensembles de cartes réelles incluent au moins une carte d'information utile, sauf si l'utilisateur demande explicitement un ensemble uniquement d'affiche ou cinématique. - Si un preset de thème ou un langage de conception entre en conflit avec
references/taste.md, la ligne de base esthétique l'emporte, sauf si l'utilisateur demande explicitement le style interdit.
Entrées
Collectez ou inférez :
content: texte source, plan, notes, URL, sujet ou briefing.ratio: par défaut1:1sauf si l'utilisateur demande3:4,9:16, ou un autre ratio.count: par défaut un comptage automatique basé sur la densité du contenu ; acceptez des quantités explicites.style: acceptez des directions de style explicites, des contraintes de marque, le public, l'ambiance et la plateforme.content-language: zh / en / mixte. Inférez à partir de la source ; demandez seulement en cas d'ambiguïté et si cela change la sélection de polices. Pilote la substitution de langue dansreferences/fonts.md.output: choisissez un dossier local clair commecards/<slug>/sauf si l'utilisateur en spécifie un.
Si des faits importants peuvent être actuels ou contestés, recherchez ou vérifiez avant de planifier. Gardez l'attribution des sources disponible pour l'utilisateur lorsque la recherche affecte le contenu. Voir la section Recherche et Confirmation des Faits pour savoir quand cela devient une passe de recherche approfondie au lieu d'une vérification rapide.
Recherche et Confirmation des Faits
Insérez ceci entre la collecte de paramètres et le travail de conception, mais seulement lorsque l'entrée ne peut pas se suffire à elle-même comme contenu des cartes.
- Déclenchez une recherche approfondie lorsque
contentest : une phrase de sujet, un briefing d'une seule phrase, une URL dont le corps n'a pas encore été lu, une idée de la taille d'un tweet, une question, ou une demande "d'expliquer X / couvrir X / faire des cartes sur X". - Ignorez la recherche approfondie lorsque
contentest déjà un article autonome, une transcription, un ensemble de notes structurées, un plan entièrement rédigé, ou tout texte à partir duquel l'utilisateur veut clairement construire des cartes à partir de plutôt que à propos de. - Lorsqu'elle est déclenchée, produisez un plan des faits avant toute planification visuelle :
- Affirmation ou thèse centrale.
- 3 à 7 points d'appui avec des chiffres concrets, noms, dates ou mécanismes.
- Sources pour chaque fait non trivial, avec URL ou références de documents qui atterriront dans
sources.md. - Questions ouvertes ou points contestés que l'utilisateur doit résoudre.
- Présentez le plan des faits à l'utilisateur et demandez confirmation, ajouts ou corrections avant de passer à la sélection thème/langage de conception. Il s'agit d'une confirmation distincte de la confirmation ultérieure du concept/visuel.
- Le résultat de cette étape est les "os" — affirmations et preuves — pas le texte de la carte finie. Les accroches, explications et conclusions au niveau de la carte sont rédigées plus tard lors de la structuration du contenu (étape 5) sur la base des os confirmés.
- Enregistrez les sources recueillies ici dans
sources.mdà l'intérieur du dossier de sortie dès que le plan des faits est confirmé.
Exemples de Déclenchement
Effectuez une recherche approfondie quand :
- "Créer un ensemble de cartes sur le protocole MCP" — sujet nu, pas de corps.
- "Transforme cet article en cartes : https://example.com/post" — URL dont le contenu n'a pas été lu dans cette conversation.
- "Je veux un ensemble de cartes sur les techniques d'optimisation RAG, en mettant l'accent sur le chunking" — sujet + angle, pas de points concrets ni de données.
- "À quels scénarios Cloudflare Durable Objects convient-il ? Fais quelques cartes" — question ou formulation "expliquer X / couvrir X".
- Un seul tweet, titre ou briefing d'une ligne qui nomme un sujet mais ne fournit aucune preuve.
Ignorez la recherche approfondie quand :
- L'utilisateur colle un article complet, un billet de blog, une transcription ou un corps d'interview (tout contenu source autonome d'environ 500 mots ou plus).
- L'utilisateur fournit des notes structurées, des comptes rendus de réunion, des notes de cours ou un plan fini où le titre de chaque carte et 2 à 4 points sont déjà listés.
- L'utilisateur fournit son propre texte fini et demande uniquement un traitement visuel ("mets ce texte en carte", "embellis ce texte").
- L'utilisateur dit explicitement "ne recherche pas de données / écris directement à partir de ce texte / ne développe pas", quelle que soit la longueur de l'entrée.
Entrées Limites
- Brief court + décalage d'ambition — par exemple, résumé de 200 mots plus "développe en 7 cartes". Le brief est trop mince pour remplir le nombre cible, déclenchez donc la recherche et signalez que le brief manque de preuves avant de développer.
- Article + "complète avec les dernières données / ajoute des exemples" — effectuez une passe de recherche limitée uniquement sur les ajouts demandés ; ne refaites pas la recherche sur les parties que l'utilisateur a déjà écrites.
- Liste à puces avec titres mais sans preuves — par exemple, "1. Meilleure performance 2. Moins cher 3. Plus sûr". Déclenchez la recherche pour attacher des chiffres concrets ou des exemples ; sinon les cartes ressembleront à du remplissage IA.
- Article + propre opinion ou point de vue de l'utilisateur — ignorez la recherche sur la source, mais confirmez avec l'utilisateur si l'opinion doit être conservée textuellement ou restructurée.
- URL dont le corps a déjà été récupéré et discuté plus tôt dans cette conversation — traitez comme du contenu collé, ignorez la recherche, mais écrivez quand même l'URL dans
sources.md.
Lorsque l'entrée est ambiguë, posez une question de clarification ("Ce contenu doit-il être directement transformé en cartes, ou souhaitez-vous que je recherche d'abord des informations et développe ?") au lieu de deviner — une décision de recherche erronée fait perdre du temps à l'utilisateur ou le budget de recherche du modèle.
Poser des Questions à l'Utilisateur
Demandez les paramètres de génération manquants une fois, près du début, avant la planification du concept. Traitez "Poser des questions à l'utilisateur" comme une politique de décision portable, pas une obligation d'appeler un outil spécifique. Différents agents de codage exposent différentes primitives d'interaction, donc la compétence doit fonctionner que les outils de questions structurées soient présents, absents ou déconseillés par le mode de fonctionnement de l'agent.
- Extrayez d'abord les valeurs connues pour
content,ratio,count,theme/style,platform/audience, etoutput/constraints. - Demandez à l'utilisateur de confirmer les paramètres de génération avant de planifier chaque fois qu'un choix significatif est encore manquant. Faites cela même lorsque l'utilisateur dit "aide-moi à créer / générer / faire / exporter rapidement" ; ces phrases demandent une exécution, pas une inférence silencieuse des paramètres.
- Demandez lorsque la réponse modifie matériellement la sortie. Ordre de priorité :
content/source intent,ratio,count,theme/style,platform/audience,output/constraints. - Posez au maximum 3 questions concises par défaut. Utilisez jusqu'à 5 seulement lorsque l'utilisateur veut explicitement des choix de configuration ou que la sortie est à enjeux élevés.
- Ne reposez pas de questions pour des paramètres déjà explicites dans la demande initiale de l'utilisateur.
- Ignorez l'étape de question seulement lorsque l'utilisateur dit explicitement de ne pas poser de questions ou approuve explicitement les paramètres par défaut. Dans ce cas, utilisez les valeurs par défaut et énoncez brièvement les hypothèses avant ou pendant l'exécution.
Stratégie de Compatibilité
Utilisez le meilleur mécanisme de question disponible dans l'environnement actuel :
- Si l'environnement prend en charge
ask_user_question,ask question, ou une capacité de clarification native équivalente, utilisez cette interaction native pour clarifier les questions bloquantes. - Si l'environnement ne prend pas en charge une capacité de question native, demandez directement dans la conversation normale.
- Posez au maximum 2 à 5 questions à la fois.
- Si les informations manquantes ne bloquent pas la tâche, demandez toujours une fois la confirmation des paramètres qui affectent la sortie finale. Si l'utilisateur a déjà approuvé les valeurs par défaut ou a demandé de ne pas poser de questions, faites des hypothèses raisonnables et continuez.
- Listez explicitement les hypothèses importantes dans la réponse finale,
sources.mdoucredits.md.
Conditions d'Arrêt
Arrêtez-vous et demandez avant la génération seulement si l'une de ces conditions est vraie :
- Il n'y a pas de
content, sujet, URL ou matériel source utilisable. - L'intention de la source est ambiguë et un mauvais choix gaspillerait le travail, par exemple "utilise ce texte tel quel" par rapport à "recherche et développe ce sujet".
- Le ratio/plateforme demandé est contradictoire ou impossible à satisfaire avec un seul export.
- La direction visuelle est régie par des contraintes de marque, légales, d'accessibilité ou de copie exacte qui sont manquantes.
- La recherche trouve des faits contestés qui changeraient l'affirmation centrale.
Sinon, demandez une fois la confirmation des paramètres de génération significatifs, puis procédez avec les hypothèses documentées et enregistrez-les dans sources.md ou la réponse finale.
Question sur le Ratio
Utilisez ces choix par défaut :
1:1carte carrée pour le partage social général.3:4carte graphique verticale pour des publications texte/image plus riches.9:16story, reel, couverture de vidéo courte ou carte mobile-first.
Acceptez les ratios libres comme 4:5, 16:9 ou des tailles de pixels exactes lorsque l'utilisateur les fournit.
Question sur le Nombre
Utilisez ces choix par défaut :
- Recommandation automatique basée sur le contenu.
3cartes pour un récit compact.5cartes pour un expliqueur standard.7cartes pour un carrousel plus complet.
Lors de la recommandation automatique, choisissez le plus petit ensemble qui couvre l'idée sans l'encombrer. Préférez 3 à 7 cartes pour les expliqueurs et 1 à 3 cartes pour les annonces.
Question sur le Thème
N'exposez pas directement le catalogue complet de presets à l'utilisateur. Chargez references/themes/presets.md et, lorsque la direction visuelle compte, references/design-languages.md ; puis recommandez 3 à 5 options de style basées sur des scénarios, en fonction du contenu, de la plateforme, du public et de l'objectif de partage. Mappez le scénario choisi par l'utilisateur à la combinaison finale de preset de thème et de langage de conception en interne.
Lorsque vous demandez à l'utilisateur de choisir un style, ne présentez pas une seule recommandation plus une question vague "ou changer ?". Donnez 3 à 5 options concrètes, chacune avec :
- un nom de style court destiné à l'utilisateur ;
- la situation où il fonctionne le mieux ;
- une description visuelle d'une ligne ;
- le mappage interne du preset de thème et du langage de conception.
Utilisez une logique de sélection à deux couches pour que les sorties restent appropriées sans retomber dans les mêmes quelques looks :
-
Couche de recommandation par défaut :
- Proposez 3 à 5 styles à haute pertinence basés sur le type de contenu, la plateforme, le public et l'objectif de partage.
- Gardez l'ensemble recommandé suffisamment proche de la tâche de l'utilisateur pour que toute option puisse réussir sans retouche lourde.
- Préférez les options qui diffèrent par le résultat visible, pas seulement par les noms des jetons. Par exemple : rapport conservateur, affiche de données, cahier social, expliqueur magazine, opinion audacieuse.
-
Couche de perturbation variante :
- Lorsque l'utilisateur n'a pas fortement spécifié un style exact, effectuez une rotation au sein de la famille compatible au lieu de toujours sélectionner la meilleure valeur par défaut.
- Variez au moins deux de ces dimensions entre des tâches similaires : preset de thème, langage de conception principal, modificateurs, recettes de mise en page, ancres visuelles, métaphore de surface ou composition du titre.
- Gardez les perturbations sémantiquement compatibles avec le contenu. N'utilisez pas une nouveauté aléatoire qui lutte contre le sujet, la plateforme, l'accessibilité ou la clarté factuelle.
- Enregistrez la combinaison finale sélectionnée dans le plan du concept ou
sources.md/credits.mdafin que la variation soit inspectable.
Utilisez des étiquettes de scénario destinées à l'utilisateur telles que :
- Infographie technique : mapper vers
engineering-paper,product-manualouporcelain-research. - Briefing d'entreprise : mapper vers
quiet-report,product-manualouporcelain-research. - Opinion audacieuse : mapper vers
bold-editorial,magazine-einkounewsroom-paper. - Note de produit social : mapper vers
social-notebook,magazine-einkoubold-editorial. - Éditorial / magazine : mapper vers
magazine-eink,dune-gallery,field-notesoukraft-editorial.
Pour les choix de langage de conception, utilisez des étiquettes de scénario destinées à l'utilisateur telles que :
- Technique mais conçu : mapper vers
editorial-artifact + cutaway + annotation. - Expliqueur magazine : mapper vers
image-led-magazine + edge-crop + asymmetric-space. - Thèse audacieuse : mapper vers
swiss-postmail + tight-grid + bold-rule.