Playwright Pro
Kit de pruebas Playwright de grado de producción para agentes de codificación de IA.
Comandos Disponibles
Cuando se instala como plugin de Claude Code, estos comandos están disponibles como /pw::
| Comando | Qué hace |
|---|---|
/pw:init | Configurar Playwright — detecta el framework, genera configuración, CI, primera prueba |
/pw:generate <spec> | Generar pruebas a partir de una historia de usuario, URL o componente |
/pw:review | Revisar pruebas para detectar antipatrones y brechas de cobertura |
/pw:fix <test> | Diagnosticar y corregir pruebas fallidas o inestables |
/pw:migrate | Migrar desde Cypress o Selenium a Playwright |
/pw:coverage | Analizar qué está probado vs. qué falta |
/pw:testrail | Sincronizar con TestRail — leer casos, enviar resultados |
/pw:browserstack | Ejecutar en BrowserStack, obtener informes multinavegador |
/pw:report | Generar informe de pruebas en tu formato preferido |
Flujo de Trabajo de Inicio Rápido
La secuencia recomendada para la mayoría de los proyectos:
1. /pw:init → crea la configuración, el pipeline de CI y una primera prueba de humo
2. /pw:generate → genera pruebas a partir de tu especificación o URL
3. /pw:review → valida calidad y señala antipatrones ← siempre ejecutar después de generate
4. /pw:fix <test> → diagnostica y repara cualquier prueba fallida/inestable ← ejecutar cuando CI se ponga rojo
Puntos de control de validación:
- Después de
/pw:generate— siempre ejecuta/pw:reviewantes de confirmar; detecta automáticamente antipatrones de localizadores y aserciones faltantes. - Después de
/pw:fix— vuelve a ejecutar la suite completa localmente (npx playwright test) para confirmar que la corrección no introduce regresiones. - Después de
/pw:migrate— ejecuta/pw:coveragepara confirmar la paridad con la suite anterior antes de retirar las pruebas de Cypress/Selenium.
Ejemplo: Generar → Revisar → Corregir
# 1. Generar pruebas a partir de una historia de usuario
/pw:generate "Como usuario puedo iniciar sesión con correo electrónico y contraseña"
# Generado: tests/auth/login.spec.ts
# → Playwright Pro crea el archivo usando la plantilla de autenticación.
# 2. Revisar las pruebas generadas
/pw:review tests/auth/login.spec.ts
# → Señala: una prueba usó page.locator('input[type=password]') — sugiere getByLabel('Contraseña')
# → Corrección aplicada automáticamente.
# 3. Ejecutar localmente para confirmar
npx playwright test tests/auth/login.spec.ts --headed
# 4. Si una prueba es inestable en CI, diagnosticarla
/pw:fix tests/auth/login.spec.ts
# → Identifica aserción web-first faltante; reemplaza waitForTimeout(2000) con expect(locator).toBeVisible()
Reglas de Oro
getByRole()antes que CSS/XPath — resistente a cambios en el marcado- Nunca
page.waitForTimeout()— usa aserciones web-first expect(locator)reintenta automáticamente;expect(await locator.textContent())no- Aísla cada prueba — sin estado compartido entre pruebas
baseURLen configuración — cero URLs hardcodeadas- Reintentos:
2en CI,0localmente - Trazas:
'on-first-retry'— depuración enriquecida sin ralentización - Fixtures en lugar de globales —
test.extend()para estado compartido - Un comportamiento por prueba — múltiples aserciones relacionadas están bien
- Simular solo servicios externos — nunca simules tu propia aplicación
Prioridad de Localizadores
1. getByRole() — botones, enlaces, encabezados, elementos de formulario
2. getByLabel() — campos de formulario con etiquetas
3. getByText() — texto no interactivo
4. getByPlaceholder() — entradas con marcador de posición
5. getByTestId() — cuando no hay opción semántica
6. page.locator() — CSS/XPath como último recurso
Qué Incluye
- 9 habilidades con instrucciones detalladas paso a paso
- 3 agentes especializados: arquitecto-de-pruebas, depurador-de-pruebas, planificador-de-migración
- 55 plantillas de prueba: autenticación, CRUD, pago, búsqueda, formularios, panel de control, configuración, incorporación, notificaciones, API, accesibilidad
- 2 servidores MCP (TypeScript): integraciones con TestRail y BrowserStack
- Hooks inteligentes: validación automática de calidad de pruebas, detección automática de proyectos Playwright
- 6 documentos de referencia: reglas de oro, localizadores, aserciones, fixtures, errores comunes, pruebas inestables
- Guías de migración: tablas de mapeo de Cypress y Selenium
Configuración de Integración
TestRail (Opcional)
export TESTRAIL_URL="https://tu-instancia.testrail.io"
export TESTRAIL_USER="[email protected]"
export TESTRAIL_API_KEY="tu-clave-api"
BrowserStack (Opcional)
export BROWSERSTACK_USERNAME="tu-nombre-de-usuario"
export BROWSERSTACK_ACCESS_KEY="tu-clave-de-acceso"
Referencia Rápida
Ver el directorio reference/ para:
golden-rules.md— Las 10 reglas no negociableslocators.md— Prioridad completa de localizadores con chuletaassertions.md— Referencia de aserciones web-firstfixtures.md— Patrones de fixtures personalizados y storageStatecommon-pitfalls.md— Los 10 errores principales y correccionesflaky-tests.md— Comandos de diagnóstico y correcciones rápidas
Ver templates/README.md para el índice completo de plantillas.
Cuándo Usar
Usa esta habilidad cuando necesites orientación o automatización para playwright-pro.