openinterpreter/qa-testing

Pruebas de QA - verifica conduciéndolo realmente

Después de construir o cambiar una aplicación o sitio web, no asumas que funciona. Conducelo y verifica.

1. Se requiere red - verifícala primero

Instalar estas herramientas y cargar páginas necesita red saliente, que los sandboxes pueden bloquear. Verifica antes de cualquier otra cosa:

curl -fsI https://github.com >/dev/null 2>&1 && echo "network ok" || echo "network blocked"

Si imprime network blocked, detente e informa al usuario:

Necesito acceso a la red para instalar y ejecutar las herramientas de prueba. Ejecuta /permissions y elige un nivel de acceso que permita la red, luego pregúntame de nuevo.

2. Aplicaciones web y sitios web - agent-browser

En macOS/Linux, prefiere el binario precompilado directamente:

if ! command -v agent-browser >/dev/null; then
  os=$(uname -s | tr '[:upper:]' '[:lower:]'); m=$(uname -m)
  case "$os/$m" in
    darwin/arm64)              asset=agent-browser-darwin-arm64 ;;
    darwin/x86_64)             asset=agent-browser-darwin-x64 ;;
    linux/aarch64|linux/arm64) asset=agent-browser-linux-arm64 ;;
    linux/x86_64)              asset=agent-browser-linux-x64 ;;
  esac
  mkdir -p ~/.local/bin
  curl -fL "https://github.com/vercel-labs/agent-browser/releases/latest/download/$asset" -o ~/.local/bin/agent-browser
  chmod +x ~/.local/bin/agent-browser
fi
agent-browser install
agent-browser skills get core

En Windows, usa el instalador de paquetes porque descarga el binario nativo correspondiente:

if (-not (Get-Command agent-browser -ErrorAction SilentlyContinue)) {
  npm install -g agent-browser
  $env:Path = "$env:APPDATA\npm;$env:Path"
}
agent-browser install
agent-browser skills get core

Luego usa la guía mantenida de la herramienta: agent-browser open <url>, toma una instantánea, actúa sobre las referencias de elementos, y vuelve a tomar una instantánea.

3. Aplicaciones de escritorio nativas - cua-driver

macOS/Linux:

command -v cua-driver >/dev/null || /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/cua-driver/scripts/install.sh)"
cua-driver list-tools

Windows PowerShell:

if (-not (Get-Command cua-driver -ErrorAction SilentlyContinue)) {
  irm https://raw.githubusercontent.com/trycua/cua/main/libs/cua-driver/scripts/install.ps1 | iex
  $env:Path = [Environment]::GetEnvironmentVariable('Path', 'User') + ';' + [Environment]::GetEnvironmentVariable('Path', 'Machine')
}
cua-driver list-tools

Para aplicaciones nativas, verifica un cambio de estado real después de la acción. Un comando de clic que informa éxito no es suficiente por sí mismo. Captura un estado inicial, actúa, luego captura un estado posterior a la acción y compara texto visible, contadores, etiquetas de estado, estado seleccionado, valores de entrada o evidencia de captura de pantalla.

Higiene de comandos de Windows PowerShell

Muchos hosts de Windows todavía ejecutan Windows PowerShell 5.1, donde && no es un separador de declaraciones válido. Usa comandos separados, punto y coma, o comprobaciones explícitas if ($LASTEXITCODE -eq 0) { ... } en su lugar. Pon entre comillas los argumentos de herramientas que comiencen con @, especialmente las referencias de agent-browser.

Principios

• Verifica la red primero.
• Usa command -v antes de instalar.
• Prefiere binarios directos en macOS/Linux cuando estén disponibles.
• Remítete a la documentación de cada herramienta: agent-browser skills get core y cua-driver list-tools.
• Toma instantánea, actúa y vuelve a tomar instantánea para confirmar que cada paso se haya completado.
• Confirma antes de acciones importantes como compras, mensajes, envíos de formularios o eliminaciones.