AlemTuzlak/skills

Pruébalo

Prueba el cambio de la misma manera en que una persona lo usa. No afirmes que funciona sin esa prueba.

Esta habilidad no se carga automáticamente al decir "listo". El usuario debe solicitarla. No carga otras habilidades.

Cuándo Usarlo

Cárgala cuando el usuario:

• ejecute /prove-it
• diga "pruébalo", "prueba los cambios", "muéstrame en el navegador", o una idea similar (incluso en el primer mensaje)

Omítelo si no lo pidió. Omite cambios solo de tipos, comentarios, archivos de bloqueo, documentación sin comportamiento.

Reglas Estrictas

1. El usuario lo pidió. Si no pidió probar, esta habilidad no se ejecuta.
2. No digas que funciona, está listo o está corregido a menos que esta habilidad realmente lo haya probado. Omitir significa no probado.
3. Una captura de pantalla de una pantalla no es una prueba. Haz clic, escribe, envía, navega.
4. Sin nuevo paquete, dependencia, aplicación de ejemplo o ejecutor de navegador a menos que el usuario haya elegido esa opción y haya dicho que sí.
5. Detén cualquier servidor que esta habilidad haya iniciado antes de que termine la habilidad. No dejes dev / preview ejecutándose.

UI vs servidor

• UI (página, componente, ruta, formulario, estado visible): pruébalo en el navegador.
• Servidor / API / biblioteca sin pantalla: pregunta cómo probarlo. No elijas en silencio.
• Ambos: navegador para la UI, y pregunta cómo probar la parte del servidor.

Procedimientos

Procedimiento 1: Clasificar

1. Enumera las superficies: UI, servidor/API, o ambas.
2. UI → Procedimiento 2.
3. Servidor/API → Procedimiento 3.
4. Ambas → Procedimiento 2, luego Procedimiento 3 para la API.

Procedimiento 2: Navegador (UI)

1. Si la aplicación no se está ejecutando, inicia solo un comando existente (dev, preview, el inicio documentado del repositorio). Si no existe ninguno, di que la UI no se puede probar. Ofrece omitir, o que el usuario inicie la aplicación.
2. Úsala como un usuario:
   • haz clic, escribe, envía, navega
   • cada ruta/página que comparte este estado
   • UI vacía y de error si este cambio las tiene
   • escritorio y una ventana estrecha si el diseño o CSS cambiaron
3. Busca roturas, no solo el camino feliz.
4. En el chat, di lo que hiciste y lo que viste. No digas "se ve bien" sin pasos.
5. Detén el proceso del paso 1 si esta habilidad lo inició.
6. Procedimiento 4.

Procedimiento 3: Preguntar (servidor / API)

1. Detente. Muestra 2–3 opciones. Pon una primera opción razonable. Incluye siempre omitir.
   • ejemplo / patio de juegos / demo existente
   • aplicación de ejemplo que use la nueva API (solo si confirman lugar + cualquier nuevo paquete/dependencia)
   • curl o un pequeño script contra un servidor en ejecución
   • omitir
2. Espera. No construyas ni ejecutes hasta que elijan.
3. Si omitir: di no probado. No digas que funciona. Detente (sin Procedimiento 4).
4. Si patio de juegos existente: ejecútalo, luego pruébalo en el navegador si tiene UI, o muestra la salida del comando si es un script.
5. Si aplicación de ejemplo: pregunta dónde. Prefiere un ejemplo existente. No añadas un paquete o dependencia a menos que hayan dicho que sí. Luego ejecútala y pruébala.
6. Si curl/script: ejecútalo. Cita el código de salida y la parte de la salida que prueba la afirmación.
7. Procedimiento 4.

Procedimiento 4: Informe opcional

1. Después de una prueba real, pregunta: ¿escribir un informe con capturas? Por defecto no.
2. Si no: detente. El chat ya tiene la evidencia.
3. Si sí: escribe .agent/scratch/prove-it.md (sobrescribe). Añade .agent/scratch/ a .gitignore si falta (igual que otros archivos temporales). Incluye lo que se hizo clic y las capturas. Abre el archivo. No lo confirmes.
4. Omitir prueba → sin informe.

Procedimiento 5: Detener

Después de la prueba o de omitir, detente. No inicies trabajo no relacionado desde esta habilidad.

Árbol de Decisión

• El usuario no pidió probar → esta habilidad no aplica.
• UI → Procedimiento 2 → 4 → 5.
• Servidor/API → Procedimiento 3 → 4 → 5 (omitir termina en 3).
• Ambas → 2 luego 3, luego 4 → 5.
• Sin comando de inicio y aplicación no ejecutándose → di que no se puede probar la UI. Omitir o el usuario la inicia.
• El usuario dice omitir → no probado. Sin afirmación de éxito.

Señales de Alerta

Señal	Qué significa	Qué hacer en su lugar
Decir listo porque las pruebas pasaron	Esta habilidad no fue solicitada, o la prueba fue omitida	Solo afirmar probado después del Procedimiento 2 o 3.
Una captura, sin clics	No es un camino de usuario	Procedimiento 2 paso 2.
Construir examples/foo antes de que elija	Aplicación no solicitada	Procedimiento 3. Espera.
Añadir Playwright / un nuevo servidor	Nueva dependencia	Solo comando de inicio existente.
Dejar pnpm dev ejecutándose	Vigilante dejado activo	Regla estricta 5.
"Omitir, pero funciona"	Omitir convertido en afirmación	Di no probado.
Archivo de informe en docs/	Documentación del producto	.agent/scratch/prove-it.md.
Abrir el informe cuando dijo que no	Archivo no solicitado	Procedimiento 4 por defecto no.
Probar solo la página para una nueva API pública	Mitad del servidor omitida en silencio	Procedimiento 3 para la API.

Manejo de Errores

• Sin herramientas de navegador: di que la UI no se puede probar aquí. Ofrece omitir, o que ellos hagan clic mientras esperas en una URL. No falsifiques una captura.
• El comando de inicio falla: cita el error. No digas que la UI funciona. Ofrece omitir o una corrección, luego prueba de nuevo.
• La prueba falla (el clic hace lo incorrecto, curl no es 200): di no probado. Nombra qué falló. No lo des por terminado.
• Eligen aplicación de ejemplo y luego rechazan un nuevo paquete: usa curl, un ejemplo existente, o omitir. No añadas el paquete de todos modos.
• Fallo al escribir el archivo temporal: mantén la prueba en el chat. Di que el archivo de informe no se escribió.

No veas nada más. El chat es la evidencia por defecto. El archivo markdown es opcional.