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.
- Donde se detuvo el proceso
- Ejecutando pruebas. La suite necesita una base de datos que el espacio de trabajo limpio no posee.
- Qué modificar
- La configuración de compilación y pruebas del proyecto. Reintentar la tarea sin cambios produce el mismo error.
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.
Respuesta
Para una pregunta. Conserva todo el contexto.
Reelaborar
Correcto pero incompleto. Vuelve con tus observaciones.
Pausar
Necesitas verificar algo. Libera el puesto.
Reintentar
Solo para fallos verdaderamente transitorios.
Cancelar y reespecificar
El enfoque o alcance fue incorrecto.
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.
Un lanzamiento se bloquea después de finalizar la tarea.
Una tarea completada significa que su trabajo ya está listo para revisión; esto no indica nada sobre el commit o despliegue del lanzamiento seleccionado. En la página de Lanzamientos página, selecciona el entorno y consulta los impedimentos de las puertas de control. Reevalúa tras completar la lista de verificación o cuando finalice una ejecución del Gráfico de Calidad. Un cambio en el SHA, el alcance o la política hace que las puertas de control y aprobaciones anteriores queden obsoletas. Si un despliegue ya está en curso o su resultado es incierto, inspecciona la ejecución del proveedor antes de solicitar otra.