Agente de Spec
Da forma a una función en un spec que el agente de Ejecución puede construir.
El agente de Spec da forma a una sola función en una especificación escrita. Lee tu código en modo de solo lectura y el contexto que le das, te entrevista sobre la función y escribe un spec: requisitos, lo que queda fuera de alcance, notas de esquema y de pruebas. Nunca escribe código de la aplicación; eso le toca a Ejecución.
Los specs corren contra tu copia de trabajo, así que el workspace necesita un Cimiento listo primero. Ve Cimiento.
Qué compartes para empezar
Dale a la función un título y descríbela (hasta 10,000 caracteres). Nada se le envía a Fragua mientras la compones —puedes editar la solicitud con libertad— y luego presionas Iniciar shaping cuando estés listo. En el camino puedes agregar contexto de apoyo:
-
La solicitud — tu título y descripción de la función.
-
Adjuntos — hasta 20 archivos, 10 MB cada uno: PDF, Markdown, texto, HTML o imágenes. El mismo límite aplica a los archivos que agregues después al continuar una construcción.
-
Documentos de la base de conocimiento — opcionalmente eliges archivos del workspace para montarlos como referencia.
-
Tus documentos de planeación — el resumen, la investigación, el plan y las guías se incluyen automáticamente cuando existen.
Cómo funcionan los turnos
El shaping abre con una pregunta de confirmación, y luego una ronda o dos de preguntas aclaratorias en la página. Cuando el agente tiene suficiente, escribe el spec y lo deja en revisión. Tú llevas la conversación; el resto del workspace sigue en solo lectura.
¿No quedó del todo bien? Envía notas de revisión mientras está en revisión y el agente rehace el spec en la misma sesión; el botón Aceptar espera hasta que la revisión termine.
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
Cualquiera en el workspace puede Aceptar el spec; tú o un administrador pueden editarlo en su lugar después. Tras una construcción también puedes Empezar de nuevo, que borra el intento anterior y vuelve a dar forma desde una descripción nueva.
El ciclo completo
Compones un borrador, le das forma con el agente y lo aceptas. La Ejecución lo construye y abre un pull request; haces merge y lo marcas como entregado. Puedes revisar antes de aceptar, o empezar de nuevo después de una construcción.
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.
Un spec aceptado se toma e implementa automáticamente.