Visuels de Page
Le travail n'est pas de "créer de belles images". Le travail est de soutenir la conversion sans mentir visuellement sur ce qui est vendu.
Si le produit, l'emballage, l'interface utilisateur ou les matériaux nécessitent de la précision, acheminez en conséquence.
Entrées requises
workspace/pages/[nom-de-la-page]/strategy.jsonworkspace/brand/profile.mdworkspace/brand/palette.jsonworkspace/pages/[nom-de-la-page]/copy.md- toute référence produit, d'emballage, capture d'écran ou ressource image fournie par l'opérateur
Politique de fournisseur
Utilisez les artefacts de marque de Page Factory comme source de vérité.
workspace/brand/extract.mdetworkspace/brand/profile.mddéfinissent la compréhension canonique de la marque- l'intégration de la marque côté fournisseur est un contexte de support pour la génération d'images, pas un substitut à l'extraction ou au profilage
- ordre de fournisseur préféré : Bloom en premier passage, Nano Banana en repli, puis ressources manuelles/opérateur lorsque la fidélité est critique pour la confiance
La sélection du fournisseur est obligatoire.
Si Bloom est configuré ou attendu pour l'exécution, vous devez d'abord vérifier Bloom. Ne remplacez pas silencieusement par la génération d'images native de Cowork, des outils d'image génériques intégrés ou un prompting d'image ad hoc lorsque Bloom est le fournisseur prévu.
Si Bloom n'est pas configuré, bloqué ou inaccessible :
- dites-le explicitement
- demandez à l'opérateur s'il souhaite :
- fournir/configurer Bloom
- utiliser Nano Banana en repli
- fournir des ressources manuelles/opérateur
- ne continuez pas silencieusement avec un fournisseur plus faible lors d'une exécution critique pour la confiance
Si Nano Banana est la voie de repli, confirmez que l'opérateur a fourni l'adaptateur/commande ou le flux de travail basé sur API requis. Ne présumez pas que Nano Banana existe simplement parce que le nom apparaît dans la documentation.
Conseils spécifiques à Bloom
Lorsque Bloom est disponible :
- vérifiez si la marque existe déjà dans Bloom
- si ce n'est pas le cas, intégrez la marque à partir de l'URL source
- si le contexte de marque Bloom est faible ou incomplet, complétez-le avec les faits de marque extraits du dépôt, le profil et la palette
- téléchargez les références produit, d'emballage ou d'interface utilisateur avant de générer des prises de vue de produit exact
- utilisez les modifications/redimensionnements de Bloom lorsque la composition de base est solide et que la demande de changement est restreinte
Repli vers Nano Banana lorsque :
- Bloom est indisponible ou non configuré
- l'intégration Bloom échoue de manière répétée
- Bloom a des crédits insuffisants
- une image requise échoue au contrôle qualité visuel après des tentatives raisonnables
Avant de passer à Nano Banana, notez explicitement pourquoi Bloom n'a pas été utilisé :
- indisponible
- non configuré
- bloqué par l'environnement d'exécution
- échec du contrôle qualité après tentatives
- crédits insuffisants
Assistant fournisseur
Utilisez le point d'entrée du fournisseur d'images local à la compétence pour exécuter la génération d'images réelle avec repli de fournisseur :
bash skills/page-visuals/scripts/image-provider.sh \
--page-name [nom-de-la-page] \
--shot-id [identifiant-de-la-prise] \
--prompt "[prompt]" \
--preservation-class [exact_product|branded_environment|concept_support]
Utilisez skills/page-visuals/scripts/ comme interface principale pour Cowork ou tout environnement d'exécution qui ne télécharge que le dossier de la compétence.
Les copies skills/page-visuals/scripts dans la racine du dépôt sont des commodités de développement local, pas une exigence d'empaquetage.
Classes de préservation
Chaque visuel planifié doit être classé avant le prompting.
1. Préservation exacte du produit
À utiliser lorsque la forme, les matériaux, l'emballage, l'interface utilisateur ou le design industriel du produit sont importants pour la confiance ou la compréhension.
Exigences :
- préserver la silhouette
- préserver les proportions
- préserver l'aspect des matériaux
- préserver l'emballage le cas échéant
- préserver le contenu de l'interface utilisateur/écran le cas échéant
- utiliser des références chaque fois que possible
2. Préservation de l'environnement de marque
À utiliser lorsque le produit peut se situer dans un contexte spécifique à la marque mais ne nécessite pas une fidélité parfaite de l'objet.
Exigences :
- faire correspondre la palette et le monde du public
- garder l'ambiance de la marque et le réalisme de la catégorie
- éviter la mise en scène de photos libres de droits
3. Visuel de support conceptuel
À utiliser lorsque l'image est explicative, atmosphérique ou de soutien de fond plutôt qu'une preuve de produit critique pour la confiance.
Exigences :
- soutenir le mécanisme ou le travail de la section
- rester subordonné à la copie
- ne pas introduire de détails de produit fictifs
Hiérarchie de priorisation des prises de vue
Générez dans cet ordre :
- visuel de preuve / mécanisme
- visuel de clarté du produit
- visuel d'aspiration lifestyle
- visuel de support décoratif
Si le temps ou le budget est limité, supprimez le 4 en premier.
Sortie du plan de prises de vue requis
Écrivez workspace/pages/[nom-de-la-page]/visuals/index.md avec :
# Plan Visuel : [nom-de-la-page]
Généré :
| Prise | Section | Classe de préservation | Objectif | Références requises | Statut |
|---|---|---|---|---|---|
| hero-1 | hero | exact product / branded environment / concept support | | | planifiée |
Lorsque les visuels sont réellement générés, étendez le plan avec les métadonnées du fournisseur lorsque possible :
## Exécutions du fournisseur
| Prise | Fournisseur | Source du contexte de marque | IDs / Références de l'image source | Résultat |
|---|---|---|---|---|
| hero-1 | bloom | profil du dépôt + intégration Bloom | bloom:img_123, référence produit locale | approuvée |
Écrivez également workspace/pages/[nom-de-la-page]/visuals/manifest.json avec des champs lisibles par machine pour :
- fournisseur utilisé
- fournisseur de repli et raison du repli le cas échéant
- ID de marque Bloom et IDs d'image le cas échéant
- références source utilisées pour la prise
- chemin de sortie local
- statut et notes
Règles de prompting
Incluez toujours :
- la section prévue et le travail
- la classe de préservation
- l'exigence de composition
- la direction de la palette
- l'ambiance / l'éclairage
- les contraintes de fidélité
- les exclusions explicites
Pour la préservation exacte du produit
Le prompt doit indiquer :
- préserver la silhouette et les proportions de l'objet
- préserver la finition des matériaux
- préserver l'emballage/l'interface utilisateur uniquement à partir de la référence
- pas de texte inventé ni de marques modifiées
- attacher ou télécharger les références avant la génération chaque fois que le fournisseur le permet
Pour l'environnement de marque
Le prompt doit indiquer :
- le contexte du public
- un moment d'utilisation authentique
- l'intégration de la palette à travers l'environnement, les accessoires, la garde-robe ou l'éclairage
- pas de poses de photos libres de droits standard
Pour le support conceptuel
Le prompt doit indiquer :
- le travail de la section
- le niveau de minimalisme / d'abstraction
- pas de détails porteurs de fausses allégations
Gestion des captures d'écran / interface utilisateur
Si la stratégie marque la gestion des captures d'écran comme requise :
- préserver les captures d'écran ou les références d'interface utilisateur
- ne pas fabriquer à la main une précision d'interface utilisateur fictive
- si aucun actif d'interface utilisateur réel n'existe, levez un drapeau et dégradez le plan de prise
Grille d'évaluation de la qualité visuelle
Chaque image générée doit être notée :
| Dimension | Score /10 | Seuil de passage |
|---|---|---|
| adéquation à la section | 8 | |
| fidélité à la palette | 8 | |
| fidélité de la silhouette / géométrie | 8 le cas échéant | |
| fidélité des matériaux | 8 le cas échéant | |
| fidélité de l'emballage / interface utilisateur | 8 le cas échéant | |
| clarté de la composition | 8 | |
| absence d'artefacts | 9 | |
| absence d'artefacts textuels | 10 |
Rejetez et régénérez si une dimension requise échoue.
Logique d'échec
Si la fidélité exacte du produit échoue de manière répétée :
- arrêtez d'utiliser des prompts vagues d'ambiance de marque
- exigez des références plus précises
- dégradez vers une photographie conservée ou une ressource fournie par l'opérateur si disponible
- ne simulez jamais l'exactitude parce que le modèle a des difficultés
Si Bloom est le fournisseur de premier passage et échoue de manière répétée :
- essayez une modification/redimensionnement natif du fournisseur avant une régénération complète lorsque le problème est la composition ou le recadrage plutôt que la fidélité centrale
- si Bloom ne peut toujours pas passer le contrôle qualité, passez à Nano Banana
- si les deux fournisseurs échouent et que la prise est critique pour la confiance, exigez de véritables ressources opérateur
Ne laissez pas Cowork remplacer silencieusement Bloom par son propre comportement d'image par défaut. Si l'environnement d'exécution ne peut pas accéder à Bloom, marquez une pause et dites-le.
Référence d'évaluation
Pour les critères de notation et les seuils de passage, voir skills/page-qa/references/eval-rubric.md.
Transition
Après l'approbation des visuels, exécutez page-build.