Visuales de Página
El trabajo no es "hacer imágenes bonitas". El trabajo es apoyar la conversión sin mentir visualmente sobre lo que se vende.
Si el producto, empaque, interfaz de usuario o materiales requieren precisión, enruta en consecuencia.
Entradas requeridas
workspace/pages/[page-name]/strategy.jsonworkspace/brand/profile.mdworkspace/brand/palette.jsonworkspace/pages/[page-name]/copy.md- cualquier referencia de producto, empaque, capturas de pantalla o activos de imagen proporcionados por el operador
Política de proveedores
Usa los artefactos de marca de Page Factory como fuente de verdad.
workspace/brand/extract.mdyworkspace/brand/profile.mddefinen la comprensión canónica de la marca- la incorporación de marca del lado del proveedor es contexto de soporte para la generación de imágenes, no un sustituto de la extracción o el perfilamiento
- orden de proveedores preferido: Bloom como primer pase, Nano Banana como respaldo, luego activos manuales/del operador cuando la fidelidad es crítica para la confianza
La selección del proveedor es obligatoria.
Si Bloom está configurado o se espera para la ejecución, debes verificar Bloom primero. No sustituyas silenciosamente la generación de imágenes nativa de Cowork, herramientas de imagen genéricas integradas o prompts de imagen ad hoc cuando Bloom sea el proveedor previsto.
Si Bloom no está configurado, está bloqueado o no se puede alcanzar:
- dilo explícitamente
- pregunta al operador si:
- proporcionar/configurar Bloom
- usar el respaldo Nano Banana
- suministrar activos manuales/del operador
- no continúes silenciosamente con un proveedor más débil en una ejecución crítica para la confianza
Si Nano Banana es la ruta de respaldo, confirma que el operador ha proporcionado el adaptador/comando o flujo de trabajo basado en API requerido. No asumas que Nano Banana existe solo porque el nombre aparece en la documentación.
Guía específica para Bloom
Cuando Bloom esté disponible:
- verifica si la marca ya existe en Bloom
- si no, incorpora la marca desde la URL de origen
- si el contexto de la marca en Bloom es débil o incompleto, complétalo usando los hechos de marca extraídos del repositorio, el perfil y la paleta
- sube referencias de producto, empaque o interfaz de usuario antes de generar tomas de producto exacto
- usa ediciones/redimensionamientos de Bloom cuando la composición base sea sólida y la solicitud de cambio sea limitada
Usa Nano Banana como respaldo cuando:
- Bloom no esté disponible o no esté configurado
- la incorporación de Bloom falle repetidamente
- Bloom tenga créditos insuficientes
- una imagen requerida no pase el control de calidad visual después de reintentos razonables
Antes de cambiar a Nano Banana, indica explícitamente por qué no se usó Bloom:
- no disponible
- no configurado
- bloqueado por el tiempo de ejecución
- fallo de control de calidad después de reintentos
- créditos insuficientes
Ayudante de proveedor
Usa el punto de entrada del proveedor de imágenes local al skill para ejecutar la generación de imágenes real con respaldo de proveedor:
bash skills/page-visuals/scripts/image-provider.sh \
--page-name [page-name] \
--shot-id [shot-id] \
--prompt "[prompt]" \
--preservation-class [exact_product|branded_environment|concept_support]
Usa skills/page-visuals/scripts/ como la interfaz principal para Cowork o cualquier tiempo de ejecución que solo suba la carpeta del skill.
Las copias en /scripts de la raíz del repositorio son comodidades de desarrollo local, no un requisito de empaquetado.
Clases de preservación
Cada visual planificado debe clasificarse antes de generar el prompt.
1. Preservación de producto exacto
Úsala cuando la forma, los materiales, el empaque, la interfaz de usuario o el diseño industrial del producto sean importantes para la confianza o la comprensión.
Requisitos:
- preservar la silueta
- preservar las proporciones
- preservar el aspecto del material
- preservar el empaque cuando sea relevante
- preservar el contenido de la interfaz de usuario/pantalla cuando sea relevante
- usar referencias siempre que estén disponibles
2. Preservación de entorno de marca
Úsala cuando el producto pueda ubicarse en un contexto específico de la marca pero no requiera una fidelidad perfecta del objeto.
Requisitos:
- coincidir con la paleta y el mundo de la audiencia
- mantener el ambiente de la marca y el realismo de la categoría
- evitar la escenificación de fotos de stock
3. Visual de soporte conceptual
Úsala cuando la imagen sea explicativa, atmosférica o de soporte de fondo, en lugar de una prueba de producto crítica para la confianza.
Requisitos:
- apoyar el mecanismo o la función de la sección
- permanecer subordinada al texto
- no introducir detalles falsos del producto
Jerarquía de priorización de tomas
Genera en este orden:
- visual de prueba / mecanismo
- visual de claridad del producto
- visual de aspiración de estilo de vida
- visual decorativo de soporte
Si el tiempo o el presupuesto son limitados, elimina el 4 primero.
Salida requerida del plan de tomas
Escribe workspace/pages/[page-name]/visuals/index.md con:
# Plan Visual: [page-name]
Generado:
| Toma | Sección | Clase de preservación | Propósito | Referencias requeridas | Estado |
|---|---|---|---|---|---|
| hero-1 | hero | producto exacto / entorno de marca / soporte conceptual | | | planificado |
Cuando los visuales se generen realmente, extiende el plan con metadatos del proveedor cuando sea posible:
## Ejecuciones del proveedor
| Toma | Proveedor | Fuente de contexto de marca | IDs de imagen de origen / referencias | Resultado |
|---|---|---|---|---|
| hero-1 | bloom | perfil del repositorio + incorporación en Bloom | bloom:img_123, referencia local del producto | aprobado |
También escribe workspace/pages/[page-name]/visuals/manifest.json con campos legibles por máquina para:
- proveedor utilizado
- proveedor de respaldo y motivo del respaldo cuando corresponda
- ID de marca de Bloom e IDs de imagen cuando corresponda
- referencias de origen utilizadas para la toma
- ruta de salida local
- estado y notas
Reglas de generación de prompts
Incluye siempre:
- la sección y función previstas
- clase de preservación
- requisito de composición
- dirección de la paleta
- ambiente / iluminación
- restricciones de fidelidad
- exclusiones explícitas
Para preservación de producto exacto
El prompt debe indicar:
- preservar la silueta y proporciones del objeto
- preservar el acabado del material
- preservar el empaque/interfaz de usuario solo a partir de la referencia
- sin texto inventado ni marcas de marca alteradas
- adjuntar o subir referencias antes de la generación siempre que el proveedor lo soporte
Para entorno de marca
El prompt debe indicar:
- contexto de la audiencia
- momento de uso auténtico
- integración de la paleta a través del entorno, accesorios, vestuario o iluminación
- sin poses de fotos de stock prefabricadas
Para soporte conceptual
El prompt debe indicar:
- función de la sección
- nivel de minimalismo / abstracción
- sin detalles falsos que afirmen hechos
Manejo de capturas de pantalla / interfaz de usuario
Si la estrategia marca el manejo de capturas de pantalla como requerido:
- preservar las capturas de pantalla o referencias de interfaz de usuario
- no falsificar precisiones de interfaz de usuario a mano alzada
- si no hay activos reales de interfaz de usuario, levanta una bandera y degrada el plan de tomas
Rúbrica de control de calidad visual
Cada imagen generada debe ser puntuada:
| Dimensión | Puntuación /10 | Umbral de aprobación |
|---|---|---|
| ajuste a la sección | 8 | |
| fidelidad de la paleta | 8 | |
| fidelidad de silueta / geometría | 8 cuando corresponda | |
| fidelidad del material | 8 cuando corresponda | |
| fidelidad del empaque / interfaz de usuario | 8 cuando corresponda | |
| claridad de la composición | 8 | |
| ausencia de artefactos | 9 | |
| ausencia de artefactos de texto | 10 |
Rechazar y regenerar si alguna dimensión requerida falla.
Lógica de fallo
Si la fidelidad del producto exacto falla repetidamente:
- deja de usar prompts vagos de ambiente de marca
- exige referencias más precisas
- degrada a fotografía conservada o activo proporcionado por el operador si está disponible
- nunca finjas exactitud porque el modelo está teniendo dificultades
Si Bloom es el proveedor de primer pase y falla repetidamente:
- intenta editar/redimensionar nativo del proveedor antes de la regeneración completa cuando el problema sea la composición o el recorte en lugar de la fidelidad central
- si Bloom aún no puede superar el control de calidad, cambia a Nano Banana
- si ambos proveedores fallan y la toma es crítica para la confianza, requiere activos reales del operador
No permitas que Cowork reemplace silenciosamente Bloom con su comportamiento de imagen predeterminado. Si el tiempo de ejecución no puede acceder a Bloom, pausa y dilo.
Referencia de evaluación
Para criterios de puntuación y umbrales de aprobación, consulta skills/page-qa/references/eval-rubric.md.
Transferencia
Después de que los visuales sean aprobados, ejecuta page-build.