Visuais da Página
O trabalho não é "criar imagens bonitas". O trabalho é apoiar a conversão sem mentir visualmente sobre o que está sendo vendido.
Se o produto, embalagem, interface ou materiais exigirem precisão, encaminhe adequadamente.
Entradas obrigatórias
workspace/pages/[page-name]/strategy.jsonworkspace/brand/profile.mdworkspace/brand/palette.jsonworkspace/pages/[page-name]/copy.md- quaisquer referências de produto, embalagem, capturas de tela ou ativos de imagem fornecidos pelo operador
Política do provedor
Use os artefatos da marca Page Factory como fonte da verdade.
workspace/brand/extract.mdeworkspace/brand/profile.mddefinem o entendimento canônico da marca- a integração da marca no lado do provedor é contexto de suporte para geração de imagem, não um substituto para extração ou perfilamento
- ordem preferencial de provedores: Bloom como primeira passagem, Nano Banana como fallback, depois ativos manuais/operador quando a fidelidade for crítica para a confiança
A seleção do provedor é obrigatória.
Se Bloom estiver configurado ou esperado para a execução, você deve verificar Bloom primeiro. Não substitua silenciosamente por geração de imagem nativa do Cowork, ferramentas de imagem genéricas integradas ou sugestões de imagem ad hoc quando Bloom for o provedor pretendido.
Se Bloom não estiver configurado, bloqueado ou não puder ser alcançado:
- diga isso explicitamente
- pergunte ao operador se deve:
- fornecer/configurar Bloom
- usar fallback do Nano Banana
- fornecer ativos manuais/operador
- não continue silenciosamente com um provedor mais fraco em uma execução crítica para a confiança
Se Nano Banana for o caminho de fallback, confirme se o operador forneceu o adaptador/comando ou fluxo de trabalho baseado em API necessário. Não presuma que o Nano Banana existe apenas porque o nome aparece na documentação.
Orientações específicas para Bloom
Quando Bloom estiver disponível:
- verifique se a marca já existe no Bloom
- se não, integre a marca a partir da URL de origem
- se o contexto da marca Bloom estiver fraco ou incompleto, preencha-o usando os fatos de marca extraídos, perfil e paleta do repositório
- carregue referências de produto, embalagem ou interface antes de gerar tomadas de produto exato
- use edições/redimensionamentos do Bloom quando a composição base for forte e a solicitação de alteração for estreita
Fallback para Nano Banana quando:
- Bloom estiver indisponível ou não configurado
- a integração do Bloom falhar repetidamente
- Bloom tiver créditos insuficientes
- uma imagem obrigatória falhar no QA visual após tentativas razoáveis
Antes de mudar para Nano Banana, observe explicitamente por que Bloom não foi usado:
- indisponível
- não configurado
- bloqueado pelo runtime
- falha no QA após tentativas
- créditos insuficientes
Auxiliar do provedor
Use o ponto de entrada do provedor de imagens local da skill para executar a geração real de imagens com fallback de provedor:
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]
Use skills/page-visuals/scripts/ como a interface principal para Cowork ou qualquer runtime que apenas carregue a pasta da skill.
As cópias /scripts na raiz do repositório são conveniências de desenvolvimento local, não um requisito de empacotamento.
Classes de preservação
Cada visual planejado deve ser classificado antes da sugestão (prompt).
1. Preservação exata do produto
Use quando a forma, materiais, embalagem, interface ou design industrial do produto forem importantes para a confiança ou compreensão.
Requisitos:
- preservar a silhueta
- preservar as proporções
- preservar a aparência do material
- preservar a embalagem quando relevante
- preservar o conteúdo da interface/tela quando relevante
- usar referências sempre que disponíveis
2. Preservação de ambiente com marca
Use quando o produto pode estar em um contexto específico da marca, mas não exige fidelidade perfeita do objeto.
Requisitos:
- corresponder à paleta e ao mundo do público
- manter o clima da marca e o realismo da categoria
- evitar encenação de foto de banco de imagens
3. Visual de suporte conceitual
Use quando a imagem é explicativa, atmosférica ou de suporte de fundo, em vez de prova de produto crítica para a confiança.
Requisitos:
- apoiar o mecanismo ou o trabalho da seção
- permanecer subordinado ao texto
- não introduzir detalhes falsos do produto
Hierarquia de priorização de tomadas
Gere nesta ordem:
- prova / visual do mecanismo
- visual de clareza do produto
- visual de aspiração de estilo de vida
- visual decorativo de suporte
Se o tempo ou orçamento for limitado, descarte o 4 primeiro.
Saída obrigatória do plano de tomadas
Escreva workspace/pages/[page-name]/visuals/index.md com:
# Plano Visual: [page-name]
Gerado:
| Tomada | Seção | Classe de preservação | Propósito | Referências obrigatórias | Status |
|---|---|---|---|---|---|
| hero-1 | hero | produto exato / ambiente com marca / suporte conceitual | | | planejado |
Quando os visuais forem realmente gerados, estenda o plano com metadados do provedor quando possível:
## Execuções do provedor
| Tomada | Provedor | Fonte do contexto da marca | IDs / referências de imagem de origem | Resultado |
|---|---|---|---|---|
| hero-1 | bloom | perfil do repositório + integração Bloom | bloom:img_123, ref local do produto | aprovado |
Também escreva workspace/pages/[page-name]/visuals/manifest.json com campos legíveis por máquina para:
- provedor usado
- provedor de fallback e motivo do fallback quando aplicável
- ID da marca Bloom e IDs de imagem quando aplicável
- referências de origem usadas para a tomada
- caminho de saída local
- status e notas
Regras de sugestão (prompting)
Sempre inclua:
- seção e trabalho pretendidos
- classe de preservação
- requisito de composição
- direção da paleta
- clima / iluminação
- restrições de fidelidade
- exclusões explícitas
Para preservação exata do produto
A sugestão deve declarar:
- preservar a silhueta e proporções do objeto
- preservar o acabamento do material
- preservar embalagem/interface apenas da referência
- sem texto inventado ou marcas alteradas
- anexar ou carregar referências antes da geração sempre que o provedor suportar
Para ambiente com marca
A sugestão deve declarar:
- contexto do público
- momento de uso autêntico
- integração da paleta através do ambiente, adereços, guarda-roupa ou iluminação
- sem poses enlatadas de banco de imagens
Para suporte conceitual
A sugestão deve declarar:
- trabalho da seção
- nível de minimalismo / abstração
- sem detalhes falsos que contenham alegações
Tratamento de capturas de tela / interface
Se a estratégia marcar o tratamento de capturas de tela como obrigatório:
- preservar capturas de tela ou referências de interface
- não forjar precisão de interface de forma livre
- se não houver ativos de interface reais, levante uma bandeira e rebaixe o plano de tomadas
Rubrica de QA visual
Cada imagem gerada deve ser pontuada:
| Dimensão | Pontuação /10 | Limite de aprovação |
|---|---|---|
| ajuste à seção | 8 | |
| fidelidade da paleta | 8 | |
| fidelidade da silhueta / geometria | 8 quando aplicável | |
| fidelidade do material | 8 quando aplicável | |
| fidelidade da embalagem / interface | 8 quando aplicável | |
| clareza da composição | 8 | |
| ausência de artefatos | 9 | |
| ausência de artefatos de texto | 10 |
Rejeite e regenere se qualquer dimensão obrigatória falhar.
Lógica de falha
Se a fidelidade exata do produto estiver falhando repetidamente:
- pare de usar sugestões vagas de clima de marca
- exija referências mais precisas
- rebaixe para fotografia preservada ou ativo fornecido pelo operador, se disponível
- nunca finja exatidão porque o modelo está com dificuldades
Se Bloom for o provedor de primeira passagem e falhar repetidamente:
- tente edição/redimensionamento nativo do provedor antes da regeneração completa quando o problema for composição ou corte, em vez de fidelidade central
- se Bloom ainda não conseguir passar no QA, mude para Nano Banana
- se ambos os provedores falharem e a tomada for crítica para a confiança, exija ativos reais do operador
Não deixe o Cowork substituir silenciosamente o Bloom por seu comportamento de imagem padrão. Se o runtime não puder acessar o Bloom, pause e diga isso.
Referência de avaliação
Para critérios de pontuação e limites de aprovação, consulte skills/page-qa/references/eval-rubric.md.
Entrega
Após os visuais serem aprovados, execute page-build.