Convertir una Grabación en un Informe sobre el que Alguien Pueda Actuar
Carga la grabación de pantalla del error. Reprodúcela, y cada vez que ocurra algo importante, márcalo. La marca de tiempo se captura, se toma un fotograma del video en ese momento y el paso se añade a una lista numerada.
Escribe el resumen, lo que esperabas y lo que sucedió en su lugar, luego copia todo como Markdown para GitHub, formato Jira o texto plano. Los detalles del navegador y la pantalla ya están completados.
La grabación nunca sale de tu máquina. Se reproduce desde un archivo local y los fotogramas se dibujan en tu dispositivo, lo cual es importante cuando el error está en una versión no lanzada o en la cuenta de un cliente.
Por Qué Esto No Usa IA para Escribir el Informe
Un modelo que observa una grabación de pantalla puede describir lo que ve. No puede saber lo que tú esperabas ver, y esa es la mitad de un informe de error que decide si alguien puede actuar sobre él.
“Se hizo clic en Confirmar, el panel de la factura estaba vacío” es una observación. Si eso es un error depende enteramente de lo que debería haber aparecido allí, y la única persona que lo sabe eres tú. Una herramienta que genera el comportamiento esperado a partir de un video está adivinando y presentando la suposición como un hallazgo, lo cual es peor que dejar el campo en blanco, porque una expectativa plausible pero incorrecta envía a un desarrollador por el camino equivocado.
Así que la división aquí es deliberada. La herramienta hace el trabajo mecánico que puede hacer exactamente: marcas de tiempo, fotogramas, entorno, formato, numeración. Tú aportas el juicio. Eso lleva aproximadamente un minuto y el resultado es un informe sobre el que nadie tiene que volver a consultarte.
Las Tres Cosas que los Informes Suelen Olvidar
Después de leer muchos informes de errores incompletos, las mismas lagunas se repiten, y las tres son mecánicas en lugar de difíciles.
Marcas de tiempo. Un informe que dice “ver el video adjunto” hace que el lector vea cuatro minutos para encontrar el momento. Un paso que dice que sucedió a la 1:12 no lo hace.
Entorno. Navegador, sistema operativo, tamaño de pantalla. Todo el mundo sabe que debe incluirlo y casi nadie lo hace, porque significa abrir un panel de configuración mientras estás en plena concentración. Aquí se lee desde tu navegador y ya aparece rellenado en el informe, y puedes corregirlo.
Imágenes fijas. Un fotograma en el momento del fallo es lo que se escanea en una lista de veinte problemas. Extraer fotogramas de un video a mano es lo suficientemente tedioso como para que la gente se lo salte, así que ocurre automáticamente en cada paso que marcas.
Qué Se Captura, Precisamente
Cada paso marcado registra el tiempo exacto de reproducción y un fotograma JPEG del video en ese momento, escalado para mantener el informe ligero. Puedes descargar los fotogramas para adjuntarlos al problema.
El entorno proviene del navegador: su nombre y versión, el sistema operativo, el tamaño de la pantalla con su relación de píxeles y el tamaño del viewport. Los navegadores ahora informan menos sobre sí mismos que antes, por lo que algunos de esos datos pueden aparecer como desconocidos, y cada campo es editable en lugar de bloqueado.
Nada se infiere de los píxeles. La herramienta no intenta leer el texto de error de la pantalla ni adivinar en qué elemento hiciste clic, porque hacerlo de manera poco fiable es peor que no hacerlo.
La Estructura que Rellena
La salida sigue la forma que ha adoptado un informe de errores, porque los sistemas de seguimiento y las personas que los leen lo esperan. Si has estado buscando una plantilla de informe de errores, esta es una que llega ya rellenada en lugar de una que pegas y miras fijamente.
Primero el resumen, en una sola línea, porque esa línea es lo que alguien escanea en una lista de treinta problemas y decide si el tuyo se abre hoy.
Luego los pasos numerados con el código de tiempo en cada uno, el comportamiento esperado, el comportamiento real y el entorno. Ese orden no es decorativo. Un lector revisa los pasos para ver si es reproducible, el par esperado y real para ver si realmente es un error, y el entorno para ver si es el suyo. Enterrar cualquiera de esos datos cuesta un viaje de ida y vuelta.
Lo que una plantilla en blanco no puede hacer es rellenarse a sí misma, que es la parte que hace que la gente se la salte. Aquí los pasos, códigos de tiempo, fotogramas y entorno llegan rellenados, y tú escribes los tres campos que una herramienta genuinamente no puede saber.
Antes de Grabar
El informe es tan bueno como la grabación, y dos hábitos marcan la diferencia.
Comience desde un estado conocido. Una grabación que comienza a mitad de sesión deja al lector adivinando lo que vino antes, por lo que los pasos dejan de ser reproducibles. Comience en una pantalla de inicio de sesión, una página nueva o un punto de partida descrito.
Limpie la pantalla de cualquier cosa que no deba viajar. Tokens en la barra de URL, el nombre de un cliente, un correo electrónico no relacionado en otra pestaña, una clave API en un panel de herramientas de desarrollo. Un informe de error se reenvía, se pega en el chat y lo leen personas ajenas al equipo, y una grabación de pantalla lleva consigo todo lo que estaba en pantalla en ese momento. Esta herramienta nunca sube el video, pero el informe y los fotogramas van a donde los envíe.
Lo Que No Hace
No archiva el problema. No hay conexión con GitHub, Jira ni nada más; usted copia el informe y lo pega donde corresponde, lo que también significa que puede leerlo antes que nadie.
No captura registros, solicitudes de red o salida de consola. Estos viven en sus herramientas de desarrollador y son enormemente importantes para algunos errores. Adjúntelos a través de la ruta segura que su equipo ya utilice en lugar de filmar una consola.
Y no diagnostica nada. No le dirá la causa, qué componente tiene la culpa o si esto duplica un problema existente. Pone la evidencia en una forma en la que alguien pueda trabajar, y ese es todo el trabajo.
Grabando el Error en Primer Lugar
Si aún necesita capturar el problema, el grabador de pantalla graba una pestaña, una ventana o la pantalla completa en el navegador. Para un error que necesita narrar mientras reproduce, grabe con audio y la explicación permanecerá adjunta a la evidencia.
Dos vecinos que vale la pena conocer. Si desea imágenes individuales en lugar de un informe, el extractor de fotogramas de video extrae fotogramas a intervalos. Y si la grabación es larga y desea la explicación hablada como texto, el generador de transcripciones convierte la narración en algo que se pueda buscar.
