pawangai/asset-qa

Asset QA

Revisa los resultados de IA antes de subirlos y escribe instrucciones de corrección listas para pegar. La mejor inspección combina tus ojos (leer la imagen directamente) y los scripts (números que el ojo no puede ver: porcentaje de color fuera de la paleta, posición del texto respecto a la zona segura, contraste, saltos entre fotogramas).

Flujo de trabajo

1. Recibir entrada: imagen/video resultado, formato destino (story, reels, feed, square, og, wide, pinterest; python scripts/qa_image.py --formats), marca (paleta de colores de profile.json o --colors), texto que debería estar escrito (lista de frases exactas) e imagen de referencia de logo/personaje si la hay. Si no se especifica el formato destino, deducirlo de la relación de aspecto de la imagen e indicar la suposición.
2. Mirar primero con los ojos. Abrir la imagen (o la hoja de contactos del video) y leer el texto tú mismo. Anotar: ortografía de cada palabra contra el texto esperado, logo, personajes, número de dedos/miembros, objetos extraños, texto aleatorio, bordes recortados. OCR es solo un complemento (inglés, fuentes decorativas a menudo se leen mal), así que la confirmación visual siempre prevalece sobre OCR.
3. Ejecutar los scripts.
   • Imagen: python scripts/qa_image.py resultado.png --format story --profile profile.json --expect "Frase 1|Frase 2"
   • Video: python scripts/qa_video.py clip.mp4 --format reels --profile profile.json --expect-duration 24 (o --colors "Nombre=#HEX,...") luego mirar contact.jpg y los fotogramas marcados.
   • Logo/personaje: python scripts/logo_compare.py referencia.png resultado.png [--crop x0,y0,x1,y1]; una puntuación alta es bastante convincente, una puntuación baja en logotipos planos simples no es prueba de diferencia, así que comparar lado a lado.
4. Redactar informe con tabla: Revisión | Resultado (apto/necesita corrección) | Hallazgo | Corrección. Ordenar de lo más grave (ortografía, logo/personaje, texto cubierto por UI) a lo cosmético. No reportar como apto algo que realmente no revisaste; escribir "no revisado" si no hay datos.
5. Escribir indicaciones de corrección: llenar issues.json y luego python scripts/fixprompts.py issues.json fix.md (tipo: spelling, palette, logo, character, safe_zone, small_text, contrast, extra_text, ratio, anatomy, video_text, video_glitch). Un problema por indicación; ChatGPT y Flow son más estables si se cambia una cosa por intento. Consultar references/qa-checklist.md para el orden de prioridad y estrategias.
6. Entregar: informe breve en la respuesta, indicaciones de corrección en bloque de código (1-3 indicaciones directamente en la respuesta; más de eso guardar en archivo .md y present_files). Indicar la decisión final: apto para subir / corregir primero / regenerar.

Reglas de decisión

• Apto para subir: sin errores ortográficos, logo/personaje correctos, sin texto en zona cubierta por UI, colores dentro de la paleta.
• Corregir primero: uno o dos problemas locales (ortografía, un color, posición).
• Regenerar: personaje/logo cambiado por completo, anatomía dañada, o muchos problemas a la vez; es más rápido regenerar con una indicación más estricta.
• Video con texto dentro: sugerir eliminar el texto del video y agregarlo en CapCut/Canva; el texto en videos de IA rara vez es estable.

Limitaciones que se deben comunicar honestamente

• OCR no reconoce todas las fuentes; "no encontrado" en texto decorativo no es necesariamente un error, y el texto que OCR lee correctamente aún debe verificarse visualmente.
• La verificación de paleta usa la diferencia de color promedio; la iluminación y los degradados hacen que los colores se desvíen ligeramente y eso es normal.
• La zona segura es una guía general; la apariencia de las aplicaciones cambia, así que probar primero una publicación.
• Los scripts no evalúan la estética o la adecuación del mensaje; eso es tu juicio.

Archivos

• scripts/qa_image.py - relación de aspecto, paleta, OCR, zona segura, tamaño y contraste de texto, ortografía contra --expect
• scripts/qa_video.py - información técnica, fotogramas, hoja de contactos, saltos, deriva de color, audio, duración
• scripts/logo_compare.py - comparación de logo/personaje con referencia
• scripts/fixprompts.py - indicaciones de corrección listas para pegar
• references/qa-checklist.md - lista de verificación y estrategias de corrección