ce-test-browser

Acerca de ce-test-browser

Un flujo de trabajo para ejecutar pruebas de navegador de extremo a extremo en las páginas afectadas por una solicitud de incorporación de cambios (pull request) o por modificaciones en una rama, utilizando exclusivamente la interfaz de línea de comandos (CLI) de agent-browser. Evita deliberadamente cualquier sistema alternativo de automatización de navegadores o integración con MCP; en Claude Code no utiliza las herramientas MCP de Chrome, y en Codex no sustituye a otras herramientas de navegación. agent-browser se utiliza para abrir páginas, hacer clic en elementos, rellenar formularios, realizar capturas de pantalla y extraer contenido renderizado. Acepta un argumento que puede ser un número de solicitud de incorporación de cambios (PR), un nombre de rama, la palabra «current» o el indicador «--port».

El flujo de trabajo comprueba primero si «agent-browser» está instalado y se detiene con instrucciones para ejecutar «/ce-setup» si falta. A continuación, pregunta si se debe ejecutar con interfaz gráfica o sin ella, excepto en el modo pipeline, donde por defecto se ejecuta sin interfaz gráfica sin bloquear el proceso. El alcance de la prueba se determina a partir de los archivos modificados utilizando «gh pr view» para un número de PR o «git diff» comparado con la rama «main» para «current» o una rama. Los archivos modificados se asignan a rutas que pueden someterse a prueba mediante una tabla de patrones que abarca vistas de Rails, controladores, controladores de Stimulus, ViewComponents, diseños, hojas de estilo, ayudantes y rutas de aplicaciones y componentes de Next.js, generando así una lista de URL que deben someterse a prueba.

La gestión de puertos distingue entre el modo manual y el modo pipeline. Determina un puerto preferido a partir de un argumento explícito `--port`, instrucciones del proyecto en contexto, scripts `dev/start` de `package.json`, archivos de entorno o un valor predeterminado de 3000, evitando deliberadamente buscar el puerto en el texto. En el modo de canalización, busca hacia arriba un puerto libre, ya que pueden ejecutarse varios agentes en paralelo, e inicia un servidor de desarrollo en segundo plano si ninguno está a la escucha, esperando hasta 30 segundos; en el modo manual, utiliza directamente el puerto preferido y solicita al usuario que inicie el servidor si este no está en ejecución. Para cada ruta afectada, navega por ella y captura una instantánea interactiva, utilizando el indicador --headed cuando el usuario ha elegido la opción «watch», y a continuación verifica elementos clave como el título de la página o el encabezado, así como los elementos interactivos principales. Úsalo para comprobar que las páginas afectadas por un cambio siguen mostrándose y funcionando correctamente.

Preguntas frecuentes

¿Qué herramienta de automatización del navegador utiliza esta habilidad?

Exclusivamente la CLI de agent-browser. No utiliza las herramientas de Chrome MCP en Claude Code ni sustituye otras herramientas de navegación en Codex.

¿Qué ocurre si «agent-browser» no está instalado?

Indica al usuario que ejecute /ce-setup para obtener el comando de instalación actual, que instale agent-browser y que vuelva a intentarlo; a continuación, se detiene porque la habilidad no puede funcionar sin ella.

¿Cómo decide qué páginas probar?

Obtiene los archivos modificados desde la vista «gh pr» (para una solicitud de incorporación de cambios) o mediante «git diff» comparado con la rama «main» (para una rama o la versión actual) y, a continuación, asigna esos archivos a rutas utilizando una tabla de patrones de archivos para crear una lista de URL.

¿Cómo se elige el puerto del servidor de desarrollo?

Por orden de prioridad: un argumento --port explícito, instrucciones del proyecto en contexto, scripts de desarrollo de package.json, archivos de entorno como .env y, por último, el valor predeterminado 3000. No busca el puerto en el texto.

¿En qué se diferencia el modo «pipeline»?

Omite la cuestión de si se ejecuta con interfaz gráfica o sin ella y, por defecto, opta por la ejecución sin interfaz gráfica; busca hacia arriba un puerto realmente libre, ya que los agentes pueden ejecutarse en paralelo; e inicia automáticamente un servidor de desarrollo en segundo plano si no hay ninguno a la escucha.