Una tarea es una unidad de trabajo que culmina en un pull request. Inicie una desde Nuevo trabajo.
Elija una buena primera tarea
La mejor primera tarea es pequeña, real y cercana a las pruebas existentes. Algo como
"añadir un --json indicador a la orden de exportación, para que coincida con la estructura de salida que ya acepta la orden de importación" le brinda a Coroid un objetivo claro y le permite evaluar el resultado con precisión.
Evite, para una primera ejecución:
- cualquier cosa relacionada con autenticación, pagos o migración de datos
- trabajo que requiera una decisión de diseño que aún no haya tomado
- limpiezas vagas: "mejorar la gestión de errores" no tiene un punto final definido
Describa lo que desea
Escriba el resultado esperado, no la implementación. Indique qué debe ser cierto cuando el trabajo finalice e incluya cualquier elemento poco evidente: archivos relevantes, convenciones a seguir, elementos que no deben modificarse.
No necesita redactar el plan. Eso es lo primero que produce Coroid, y usted puede aprobarlo.
Si existe contexto que el código no contenga —un ADR, una guía de estilo, un ticket— adjúntelo. Consulte Contexto del proyecto para saber qué ya conoce Coroid sin necesidad de indicárselo.
Revisar la especificación
Coroid convierte su descripción en una especificación: qué se va a construir, qué está fuera de alcance y los criterios de aceptación que determinan el éxito. Aparece en la pestaña Especificaciones de la tarea.
Léelo antes de que se construya nada. Si los criterios de aceptación no coinciden con lo que realmente deseas, corrígelos ahora: son lo que la fase de verificación utilizará para las pruebas posteriores. Consulta las Especificaciones.
Aprobar el plan
Para cualquier cambio que vaya más allá de una modificación trivial, la especificación se convierte en un plan: un conjunto ordenado de pasos. Lo aprobarás antes de que se escriba el código.
Este es el momento más económico para intervenir. Rechazar un plan te costará un minuto; rechazar un pull request ya terminado te costará toda una ejecución.
Observar su ejecución
Una vez aprobado, la tarea entra en PENDING hasta que se libere una ranura para el agente, y luego
IN_PROGRESS. Puedes seguir la ejecución en tiempo real: los pasos realizados, las herramientas invocadas, los archivos modificados y los resultados de las pruebas a medida que se generan.
No necesita estar pendiente. Las Notificaciones le avisarán cuando sea necesario intervenir o cuando la tarea esté lista.
Qué esperar
- Duración La duración depende del tamaño del cambio y del tiempo que tarde su suite de pruebas, no del número de ranuras de agente disponibles. Las ranuras determinan cuántas tareas se ejecutan simultáneamente.
NEEDS_HUMAN_REVIEWNo supone un fallo. Significa que Coroid ha llegado a una decisión que solo usted puede tomar. Resuélvala y la tarea continuará.- El retrabajo es algo habitual. Si el revisor encuentra algún problema, la tarea se devuelve al desarrollador antes de que usted la vea.
Siguiente
Revisar y fusionar el resultado — qué se entrega y qué debe comprobarse.