Las tareas fallan. La mayoría de los errores son problemas de configuración o de especificaciones, no algo misterioso, y se reducen a unas pocas categorías.
Primero, revisa dónde se detuvo.
La ejecución muestra en qué etapa falló. Ese dato por sí solo delimita la causa mejor que cualquier otra cosa:
| Fallo en | Casi siempre significa |
|---|---|
| Antes de escribir cualquier código | El comando de compilación o instalación es incorrecto para un espacio de trabajo limpio. |
| Mientras se realiza el cambio | Se trata de un trabajo realmente complejo o de una dependencia faltante. |
| Ejecución de pruebas | El comando de prueba es incorrecto o la suite necesita un servicio. |
| Verificación | Un filtro bloqueador; revisa los Hallazgos. |
| Revisión | Hallazgos que no pudieron corregirse automáticamente. |
Los fallos antes de escribir el cambio se deben a la configuración. Consulta Configuración de compilación y pruebas.
No está bloqueado, está en cola.
Una Tarea en PENDING no está bloqueada. Está esperando un slot libre para el agente. Revisa
capacidad antes que nada: esta es la alarma falsa más común.
Te está pidiendo algo.
NEEDS_HUMAN_REVIEW significa que la tarea llegó a una decisión que solo tú puedes tomar. No es un
error. Responde a la pregunta y continuará desde donde se detuvo.
Responde con precisión. Una respuesta vaga genera otra suposición y otra pausa.
Se está ejecutando mucho más tiempo de lo esperado.
Dos causas habituales:
Una suite de pruebas lenta o bloqueada. Coroid ejecuta tu suite; si se bloquea en un espacio de trabajo limpio, la tarea espera. Reprodúcelo ejecutando la suite contra un clon nuevo.
Una especificación lo suficientemente amplia como para que el agente siga encontrando más trabajo por hacer. La señal es una lista de archivos cada vez mayor. Cancela, delimita el alcance con una línea explícita de fuera de alcance y vuelve a ejecutar. Consulta Especificaciones.
Elegir qué hacer
En orden creciente de coste:
- Responder — para
NEEDS_HUMAN_REVIEW. Es la opción más económica y conserva todo el contexto. - Rehacer — el trabajo está bien hecho pero es incompleto. Vuelve al agente desarrollador con tus Hallazgos y su contexto intactos.
- Pausar — necesitas comprobar algo primero. Libera el slot; se puede reanudar.
- Reintentar — solo para errores verdaderamente transitorios. Reintentar un problema de configuración solo lo reproducirá.
- Cancelar y reespecificar — el enfoque o el alcance eran incorrectos. Es la opción más costosa, y a menudo la decisión correcta.
Errores que se repiten en varias tareas
El mismo error en la misma etapa en tareas no relacionadas indica un problema de configuración del proyecto, no de la tarea. Deja de reejecutar tareas y corrige la configuración.