Que fait Koubou : Générateur de captures d'écran App Store ?
Générez des captures d'écran professionnelles pour l'App Store à l'aide de modèles HTML/CSS avec plus de 100 cadres d'appareils réels, une localisation xcstrings et des dimensions Apple pixel-perfect.
Les captures d'écran sont des publicités, pas de la documentation. Chaque diapositive vend un sentiment, un résultat ou une solution à un problème.
Les instructions de l'utilisateur prévalent toujours sur les valeurs par défaut de cette compétence.
La direction créative est ouverte par défaut. Utilisez les règles de cette compétence pour imposer l'impact, la lisibilité et l'échelle adaptée au canevas, pas pour donner le même aspect à tous les ensembles.
Hiérarchie des règles
Traitez les directives de cette compétence dans cet ordre :
- Contraintes strictes — lisibilité, échelle, clarté des miniatures, marketing produit véridique et conscience réelle du canevas
- Valeurs par défaut fortes — variété, asymétrie, chevauchement, rythme et évitement des mises en page génériques
- Préférences de goût — heuristiques anti-banalité et valeurs par défaut stylistiques qui peuvent être enfreintes lorsqu'une idée plus forte améliore clairement le travail
Si enfreindre une valeur par défaut produit un meilleur ensemble de captures, enfreignez-la délibérément et expliquez le compromis à vous-même avant de générer.
Fichiers de référence (à lire selon les besoins, pas à l'avance) :
setup.md— Installation et configuration du runtime HTMLdesign-guide.md— Principes de conception, règles de rédaction, règles CSS, exemples de modèles HTMLstyle-intake.md— Comment inspecter le langage visuel réel de l'application avant de poser des questionsstyle-interview.md— Questions de style courtes et à fort signal et modèles de conversationyaml-reference.md— Format de configuration YAML, localisation, ressources, appareils, taillescapabilities-reference.md— Capacités complètes de koubou (mode de contenu, points forts, zoom, dégradés)
Phase 1 : Configuration (silencieuse, automatique)
Vérifiez d'abord si kou est disponible. Ne réinstallez pas et ne touchez pas à l'empaquetage Python si kou fonctionne déjà.
Ordre préféré :
kou --version 2>/dev/null
Si kou --version réussit :
- considérez koubou comme installé
- ne lancez pas
pip,pip3ouplaywright install - ne tentez pas de « mettre à niveau » ou de « réparer » l'environnement de l'utilisateur de manière proactive
- exécutez toujours
kou setup-htmlavant de générer, car cette compétence est exclusivement HTML et la commande est conçue pour être répétée sans risque
Si kou --version échoue, lisez setup.md et suivez le chemin le moins invasif pour l'environnement.
Pour la prise en charge du rendu HTML :
- utilisez toujours
kou setup-html - ne sautez pas cette étape simplement parce que HTML a fonctionné lors d'une exécution précédente
- ne lancez pas
playwright install chromiumdirectement
Informez l'utilisateur uniquement si la configuration échoue. Ne modifiez jamais une installation fonctionnelle.
Phase 2 : Lire l'application, puis demander
Ne commencez pas par un questionnaire de style générique. Inspectez d'abord le langage visuel réel de l'application, puis ne demandez que ce qui manque encore ou est ambigu.
Lisez style-intake.md avant de poser des questions de style. Suivez cet ordre.
2.1 Découverte de style (obligatoire avant les questions de style)
Inspectez d'abord les sources du projet local. Recherchez automatiquement avant de demander une direction visuelle à l'utilisateur.
Priorisez ces sources :
Assets.xcassets, icônes d'application, illustrations, logos, ressources de couleur- Dossiers de captures d'écran et marketing existants :
.maestro/screenshots/AppStore/fastlane/screenshots/marketing/
- Documentation produit et positionnement :
README*CLAUDE.md- plans de lancement, copie de page d'accueil, dossiers de documentation
- Jetons de conception et code UI :
- Variables CSS
- Couleurs SwiftUI, dégradés, matériaux, choix typographiques
- fichiers de thème web et constantes de conception partagées
- Artefacts App Store antérieurs s'ils existent :
- modèles précédents
- anciennes campagnes de captures
- ressources marketing localisées
Extrayez et résumez au moins ces signaux :
- couleurs dominantes et couleurs d'accentuation
- contraste global : sombre, clair, mixte, atténué, vif
- densité UI : aérée, équilibrée, dense
- langage des formes : net, doux, arrondi, riche en cartes, plat
- style d'iconographie et d'illustration
- direction typographique si visible
- ton de la copie : calme, technique, ludique, premium, chaleureux, urgent
- si l'application semble calme, technique, chaleureuse, énergique, soignée, ludique, etc.
Si le style de l'application est clair :
- résumez les signaux détectés à l'utilisateur en langage clair
- confirmez que vous allez construire à partir de cette direction au lieu de repartir d'un langage de modèle générique
Si les signaux sont faibles, manquants ou contradictoires :
- dites ce que vous avez trouvé
- posez des questions de suivi ciblées sur l'incertitude au lieu de poser un questionnaire de conception large
2.2 Entretien d'intention (court, à fort signal)
Lisez style-interview.md et ne demandez que le strict minimum. Restez conversationnel. Ne déversez pas toutes les questions à la fois.
Questions de style requises si encore nécessaires :
- Quel sentiment la campagne doit-elle projeter : premium, ludique, éditorial, utilitaire, technique, chaleureux, etc. ?
- Y a-t-il des références App Store, des marques ou des ensembles de captures qui devraient influencer la direction ?
- Qu'est-ce qui est visuellement interdit : dégradés forts, glassmorphisme, sombre uniquement, grilles de cartes, style trop ludique, etc. ?
- Quel trait visuel de l'application elle-même doit encore être reconnaissable dans les captures ?
Questions facultatives uniquement si encore non résolues :
- Direction typographique préférée ou personnalité de police
- Biais clair, sombre ou mixte
- Préférence de densité : plus d'air ou plus d'informations
- Si l'ensemble doit sembler strictement cohérent ou visiblement varié entre les diapositives
2.3 Informations produit (toujours requises)
Après le début de la découverte de style, collectez naturellement les entrées de production restantes :
- Application : Nom, ce qu'elle fait (1 phrase), proposition de valeur principale
- Captures d'écran : Où se trouvent les captures de l'application ? Recherchez automatiquement d'abord :
- Si trouvé, montrez ce que vous avez trouvé et confirmez
- Si non trouvé, demandez comment l'utilisateur les génère
- Préférez les captures de simulateur propres qui montrent clairement l'UI de l'application. Si l'utilisateur peut choisir, préférez les captures iPhone 6,1 pouces récentes comme matériel source
- Fonctionnalités à mettre en avant : Liste priorisée des fonctionnalités/avantages (recommander 3 à 5). Chaque diapositive = 1 fonctionnalité
- Ressources hero : Icône de l'application ou autre ressource de marque. Recherchez automatiquement avant de demander
- Nombre de diapositives : Combien de captures d'écran (recommander 3 à 5 pour commencer, Apple autorise jusqu'à 10)
Facultatif uniquement si pertinent :
- Appareil : Par défaut,
iPhone 16 Pro - Black Titanium - Portrait. Demandez uniquement si iPad/Mac/autre a du sens - Localisation : Uniquement si le projet a déjà des xcstrings ou une prise en charge multilingue
- Ressources supplémentaires : Éléments UI flottants, badges, illustrations de support
- Contraintes supplémentaires : Réclamations requises, styles interdits ou contraintes marketing
2.4 Décision de style (obligatoire avant le HTML)
Avant de rédiger les modèles, décidez et verrouillez explicitement ces six éléments :
signaux de marque détectésstyle de campagne choisivoix de la copiesystème d'arrière-planrythme de composition de l'appareilplan de variation entre les diapositives
Chaque élément doit être justifié soit par :
- des preuves de l'application issues de la découverte de style, ou
- un retour direct de l'utilisateur lors de l'entretien
Si vous ne pouvez pas justifier l'un d'eux, continuez à poser des questions ciblées avant de concevoir.
Dérivé (NE PAS demander sauf si bloqué)
- Dégradés ou textures d'arrière-plan à partir des couleurs de la marque et de l'ambiance UI
- Répartition de la mise en page (hero → fonctionnalité-haut → fonctionnalité-bas → alternance)
- Copie du titre à partir des fonctionnalités et de la proposition de valeur
- Palette secondaire à partir de la palette réelle de l'application
- Classe de canevas à partir de
project.device+project.output_sizeviakou inspect-frame - Si le nom de l'application doit apparaître ou non. Par défaut : omettez-le sauf s'il ajoute une réelle valeur de marque à une taille lisible
- Si l'icône de l'application doit apparaître. Par défaut : utilisez-la avec parcimonie sur les diapositives hero ou de clôture, pas comme un petit élément décoratif
Principe : si le contexte est disponible localement, utilisez-le avant de demander. Les questions de style viennent après l'inspection, pas avant.
Phase 3 : Générer
Lisez design-guide.md avant de générer les modèles. Lisez yaml-reference.md avant d'écrire la configuration.
-
Créez un répertoire de travail (par exemple,
AppStore/ou là où cela a du sens pour le projet) -
Exécutez
kou setup-html -
Lisez
project.deviceetproject.output_sizeà partir du YAML -
Exécutez
kou inspect-frame "<appareil>" --output-size <taille> --output jsonet utilisez cette géométrie avant d'écrire le CSS -
Rédigez l'arc narratif et 2 à 3 options de titre/sous-titre par diapositive avant de toucher à la mise en page. Choisissez d'abord le plus fort. La qualité de la copie passe avant le CSS
-
Traduisez la décision de style en un brief de campagne :
- ce que l'ensemble doit ressembler
- quels motifs sont autorisés
- quels motifs sont interdits
- combien de variation les 5 premières diapositives doivent montrer
-
Créez
templates/avec des modèles HTML — au moins 3 mises en page distinctes, et les 3 premières diapositives ne doivent pas répéter le même archétype de composition -
Dans chaque modèle HTML, ajoutez
data-kou-idetdata-kou-roleà ces éléments avant d'écrire du CSS :- Titre principal :
data-kou-id="headline" data-kou-role="headline" - Copie de support :
data-kou-id="subtitle" data-kou-role="supporting" - Image de l'appareil principal :
data-kou-id="device" data-kou-role="device" - Titres/sous-titres de fonctionnalités (diapositives de clôture/fonctionnalités) :
data-kou-id="feature-N-title" data-kou-role="feature-title",data-kou-id="feature-N-sub" data-kou-role="feature-sub"
Sans cela, le tableau
elementsdu sidecar de mise en page sera vide et le QA post-rendu sera aveugle. Voir les exemples de modèles dansdesign-guide.mdpour les modèles d'annotation corrects. - Titre principal :
-
Créez
config.yamlavec la configuration koubou (lisezyaml-reference.mdpour le format) -
Utilisez du CSS qui s'adapte au canevas et à la longueur de la copie : utilisez
vwouclamp()délibérément, privilégiez CSS Grid, le chevauchement et les couches positionnées en absolu, et vérifiez l'échelle de texte calculée finale sur le canevas réel -
Avant d'écrire du HTML : planifiez les zones de texte/appareil pour chaque diapositive (quelle zone possède quel pourcentage du canevas). Ne commencez pas le CSS tant que les zones ne sont pas claires
-
Exécutez :
kou generate config.yaml --output json -
Pour chaque capture HTML générée, lisez
layout_pathà partir du résultat JSON et inspectez le sidecar avant de décider que la mise en page est acceptable -
QA post-rendu (obligatoire — ne sautez pas) :
- Examinez chaque diapositive générée visuellement
- Ouvrez chaque fichier
*.layout.jsonsidecar référencé parlayout_path - Vérifiez par rapport à la liste de rejet dans
design-guide.md - Vérifiez que l'ensemble rendu reflète toujours le style de l'application que vous avez découvert au lieu des valeurs par défaut génériques de l'App Store
- Utilisez le JSON de mise en page uniquement pour la géométrie objective : positions, espace occupé, proportions et chevauchements mathématiques
- Si
elementsest vide pour une diapositive HTML qui devrait être mesurée, considérez cela comme une annotation manquante ou cassée et corrigez le modèle - Vérifiez : pas d'icônes émojis, pas de grilles de cartes identiques, pas d'appareils décentrés, pas de texte en dessous de l'échelle minimale, pas de recadrage involontaire de l'appareil (le haut/encoche de l'appareil doit être visible sur les diapositives hero ; le contenu de l'écran doit être lisible)
- Appliquez le test d'échange de logo : ces diapositives fonctionneraient-elles pour un concurrent ?
- Si une diapositive échoue, corrigez et régénérez avant de la montrer à l'utilisateur
-
Ouvrez le dossier de sortie :
open <répertoire_sortie> -
Demandez si l'utilisateur souhaite des ajustements — itérez sur des diapositives spécifiques sans tout régénérer
Règles d'itération
- Lorsque l'utilisateur demande de modifier une diapositive spécifique, modifiez uniquement ce modèle + l'entrée de configuration
- Lorsque l'utilisateur demande un changement de style global (couleurs, polices, ambiance, densité, audace), mettez à jour tous les modèles
- Réexécutez
kou generate config.yaml --output jsonaprès les modifications pour que les nouvelles valeurslayout_pathet les sidecars restent synchronisés - Utilisez
kou live config.yamlsi l'utilisateur souhaite un aperçu en temps réel pendant l'édition - Si une diapositive semble petite, augmentez d'abord l'échelle ou changez de mise en page. Ne cachez pas le problème avec des dégradés ou des étiquettes supplémentaires
- Si la copie force un texte minuscule, réécrivez la copie ou choisissez une mise en page plus appropriée ; n'acceptez jamais une diapositive timide parce que « le texte devait tenir »
- Maintenez une variété élevée : l'objectif est la cohérence de la campagne, pas la répétition de la mise en page
- Ne vous arrêtez pas après le premier rendu réussi si la sortie enfreint toujours les règles de conception ou la liste de vérification de rejet
- Si l'utilisateur demande un changement d'ambiance, réinterprétez l'ensemble dans les limites de qualité au lieu de défendre les valeurs par défaut précédentes
- Si la capture d'écran et le JSON de mise en page sont en désaccord, faites confiance à la capture d'écran rendue pour le goût et enquêtez sur l'annotation ou le timing du rendu au lieu de forcer une décision de mise en page à partir d'une géométrie obsolète
Règles strictes
Contraintes strictes
- N'utilisez jamais d'émojis comme icônes — utilisez des formes CSS (barres d'accentuation, points) ou du texte uniquement
- N'utilisez jamais de phrases de copie interdites — « révolutionnaire », « transparent », « débloquer », « révolutionnaire », etc.
- Appliquez le test d'échange de logo — si le nom d'un concurrent conviendrait, l'ensemble est trop générique
- Chaque modèle HTML doit avoir des annotations
data-kou-id— au minimum :headline,subtitleetdevice. Sielementsdans le sidecar de mise en page est vide après la génération, les annotations sont manquantes — corrigez le modèle avant que le QA ne passe. Ne présentez pas de diapositives non annotées à l'utilisateur.
Échelle
- Sur les portraits iPhone hauts (
iPhone6_9,iPhone6_7), les titres hero doivent être>=10vw, les titres de mise en page latérale>=10vw, les sous-titres>=4.5vw - Utilisez
vwouclamp()uniquement si la taille calculée dépasse toujours le minimum sur le canevas cible - Sur les diapositives de contraste ou de clôture, le cluster de contenu doit occuper 60 %+ de la hauteur du canevas
Valeurs par défaut fortes
- N'utilisez pas la même composition de téléphone droit centré sur des diapositives consécutives
- Ne laissez pas de grandes bandes vides (>15 % de la hauteur du canevas) entre le titre et l'appareil
- Évitez de combiner
rotate()+translate()sur les appareils centrés à moins que le centre visuel ne semble toujours intentionnel après le rendu - N'utilisez pas une simple colonne flex centrée lorsque la diapositive a besoin de chevauchement, de recadrages de bord ou de composition en couches
- Planifiez les zones de texte/appareil avant d'écrire du CSS (voir design-guide.md Planification des zones appareil-texte)
- Si vous utilisez des grilles de cartes, décalez, mettez en évidence ou simplifiez-les, sauf si une grille stricte sert véritablement le concept
Contenu
- N'ajoutez pas de petites étiquettes de catégorie, de titres de nom d'application par défaut
- Ne rendez pas le nom de l'application sous forme de petit texte décoratif, sauf s'il est clairement lisible