pawangai/asset-qa

Asset QA

Verifique o resultado da IA antes de publicar e escreva comandos de correção prontos para uso. A melhor inspeção combina seus olhos (lendo a imagem diretamente) e scripts (números que o olho não vê: percentual de cor fora da paleta, posição do texto em relação à zona segura, contraste, variações entre quadros).

Fluxo de trabalho

1. Receba a entrada: imagem/vídeo resultante, formato de destino (story, reels, feed, square, og, wide, pinterest; python scripts/qa_image.py --formats), marca (paleta de cores de profile.json ou --colors), texto que deveria estar escrito (lista de frases exatas) e imagem de referência do logotipo/personagem, se houver. Se o formato de destino não for fornecido, deduza-o da proporção da imagem e mencione sua suposição.
2. Olhe primeiro com os olhos. Abra a imagem (ou a folha de contato do vídeo) e leia o texto você mesmo. Anote: ortografia de cada palavra em relação ao texto esperado, logotipo, personagem, número de dedos/membros, objetos estranhos, texto aleatório, bordas cortadas. OCR é apenas um complemento (inglês, fontes decorativas frequentemente são mal interpretadas), portanto a confirmação visual sempre se sobrepõe ao OCR.
3. Execute os scripts.
   • Imagem: python scripts/qa_image.py resultado.png --format story --profile profile.json --expect "Frase 1|Frase 2"
   • Vídeo: python scripts/qa_video.py clipe.mp4 --format reels --profile profile.json --expect-duration 24 (ou --colors "Nome=#HEX,...") e depois veja contact.jpg e os quadros marcados.
   • Logotipo/personagem: python scripts/logo_compare.py referencia.png resultado.png [--crop x0,y0,x1,y1]; pontuação alta é convincente o suficiente, pontuação baixa em logotipos planos e simples não é prova de diferença, então compare lado a lado.
4. Monte o relatório com tabela: Verificação | Resultado (aprovado/precisa de correção) | Constatação | Correção. Ordene do mais prejudicial (ortografia, logotipo/personagem, texto coberto pela UI) para o cosmético. Não relate "aprovado" em itens que você não verificou de verdade; escreva "não verificado" quando os dados não existirem.
5. Escreva o prompt de correção: preencha issues.json e depois execute python scripts/fixprompts.py issues.json fix.md (tipos: spelling, palette, logo, character, safe_zone, small_text, contrast, extra_text, ratio, anatomy, video_text, video_glitch). Um problema por prompt; ChatGPT e Flow são mais estáveis se você alterar uma coisa por tentativa. Consulte references/qa-checklist.md para ordem de prioridade e estratégia.
6. Entregue: relatório resumido na resposta, prompts de correção em bloco de código (1-3 prompts diretamente na resposta; mais do que isso, salve em arquivo .md e present_files). Mencione a decisão final: pronto para publicar / corrigir primeiro / refazer.

Regras de decisão

• Pronto para publicar: sem erros de ortografia, logotipo/personagem conforme, nenhum texto na zona coberta pela UI, cores dentro da paleta.
• Corrigir primeiro: um ou dois problemas localizados (ortografia, uma cor, posição).
• Refazer: personagem/logotipo alterado por completo, anatomia danificada ou muitos problemas ao mesmo tempo; é mais rápido refazer com um prompt mais rigoroso.
• Vídeo com texto interno: sugira remover o texto do vídeo e adicioná-lo no CapCut/Canva; o texto em vídeos de IA raramente é estável.

Limitações que devem ser honestamente comunicadas

• O OCR não reconhece todas as fontes; "não encontrado" em texto decorativo não significa necessariamente erro, e texto lido corretamente pelo OCR ainda precisa ser verificado visualmente.
• A verificação de paleta usa diferença de cor média; iluminação e gradientes fazem as cores variarem ligeiramente, e isso é normal.
• A zona segura é uma referência geral; a aparência do aplicativo muda, portanto, teste uma postagem primeiro.
• Os scripts não avaliam beleza ou adequação da mensagem; isso é uma avaliação sua.

Arquivos

• scripts/qa_image.py - proporção, paleta, OCR, zona segura, tamanho e contraste do texto, ortografia em relação a --expect
• scripts/qa_video.py - informações técnicas, quadros, folha de contato, variações, desvio de cor, áudio, duração
• scripts/logo_compare.py - comparação de logotipo/personagem com referência
• scripts/fixprompts.py - prompts de correção prontos para copiar e colar
• references/qa-checklist.md - lista de verificação e estratégia de correção