Guías
Documentación
Trabajar con agentes

Agente de Diagnóstico de issues

Encuentra la causa raíz de un error y propone un arreglo.

El agente de Diagnóstico de issues es el hermano ligero del agente de Spec, hecho para errores. Describes qué está fallando; él lee tu código en modo de solo lectura y escribe un diagnóstico: la causa raíz y un arreglo propuesto. No hay spec ni lista de tareas, solo el diagnóstico.

Antes de empezar

El diagnóstico lee tu copia de trabajo, así que el workspace necesita un Cimiento listo primero. Ve Cimiento.

Qué compartes para empezar

Dale al issue un título y describe el problema (hasta 10,000 caracteres). Puedes adjuntar capturas o logs: hasta 20 archivos, 10 MB cada uno, el mismo límite que aplica a los archivos que agregues después al continuar un arreglo. Nada se le envía a Fragua mientras lo compones; presiona Iniciar diagnóstico cuando estés listo. A diferencia de los specs, los issues no usan documentos de la base de conocimiento, solo tus adjuntos.

Cómo funcionan los turnos

El agente puede hacer una pregunta aclaratoria o dos en la página, o ir directo al diagnóstico cuando tu descripción es suficientemente clara. Luego escribe la causa raíz y el arreglo propuesto y lo deja en revisión.

Puedes enviar notas de revisión mientras está en revisión y el agente rehace el diagnóstico en la misma sesión.

Cómo va un ciclo de turnos
Lo describes El agente pregunta Respondes Borrador Revisión Aceptar

El paso de preguntar y responder se repite hasta que el agente tiene suficiente para escribir el borrador. Después del borrador, enviar notas de revisión reabre la misma conversación.

Aceptar el resultado

Aprueba el diagnóstico para arreglo y el agente de Ejecución lo construye automáticamente, abriendo un pull request igual que un spec. Tras un arreglo puedes Empezar de nuevo desde una descripción nueva.

Bueno saber

  • Mientras una corrida está en curso, solo la persona que la inició puede responder; los demás en el workspace la siguen en modo de solo lectura.

  • Si una corrida se atora o cambias de opinión, puedes cancelarla y luego reiniciarla o reanudarla desde donde se quedó.

  • Fragua te avisa cuando un borrador está listo o una corrida falla, así no tienes que quedarte observándola.

Aprobado, ahora se arregla

Un arreglo aprobado lo implementa automáticamente el agente de Ejecución.

Leer la guía de Ejecución