Entender el trabajo06 / 20
Leer los cambios por intención
En esta página
Cuando un agente cambia decenas de archivos en un turno, repasar los diffs archivo por archivo hace difícil responder a «¿para qué eran estos cambios?». En Noea, los cambios de un turno se pueden agrupar por la intención a la que responden, así ves qué frase tuya corresponde a cada cambio. Los cambios que no responden a ninguna intención se enumeran aparte al final, no mezclados.
Empieza desde la tarjeta de cambios
Cuando un turno deja cambios en archivos, la respuesta termina con una tarjeta de cambios. Si cambió un archivo, su título dice algo como «grace.ts editado»; si cambiaron varios, algo como «9 archivos modificados», con las líneas añadidas y quitadas al lado. Los archivos que el agente cambió por línea de comandos también cuentan.
Una vez que Explicar ha tratado el turno, la segunda línea de la tarjeta dice algo como «2 intenciones · 1 sin correspondencia»: a cuántas partes de tu intención responden los cambios y cuántos cambios no responden a ninguna. Hasta entonces, la segunda línea ofrece «Ejecutar Explicar para agruparlos».
Haz clic en cualquier punto de la tarjeta y el panel de código se abre en la barra auxiliar, en el extremo derecho del área principal, mostrando todos los cambios del turno. El propio chat no repite el diff del turno.
El panel de código
La parte superior del panel muestra el título del chat y el número de turno, como «Correo del periodo de gracia · Turno 2», y te permite cambiar a otros turnos con cambios del mismo chat. El botón de arriba a la derecha muestra u oculta la lista de archivos, que puede ser plana o agrupada por carpeta; cada archivo muestra sus líneas añadidas y quitadas, y al hacer clic en uno se salta a él. La cabecera de cada archivo tiene «Abrir con la aplicación predeterminada».
El diff tiene una sola columna de números de línea: las líneas añadidas y sin cambios muestran sus números nuevos, y las líneas quitadas muestran sus números antiguos, atenuados. Las líneas sin cambios entre cambios se pliegan en una fila que puedes abrir, hasta mostrar el archivo entero. Si un archivo cambió de nuevo después del turno, el panel muestra solo los cambios de este turno y ofrece «Mostrar el archivo actual».
Arrastra el borde izquierdo de la barra auxiliar para ensanchar el panel. Cerrarlo solo pliega la barra auxiliar; el documento y el chat a su izquierda se quedan como están.
Agrupado por intención
El panel tiene dos disposiciones, «Por archivo» y «Por intención». Por intención:
- Cada grupo es una parte de tu intención. Su cabecera es el texto de ese párrafo, con el documento y la sección en que se encuentra, en pequeño, encima. Los grupos siguen el orden de los párrafos en tus documentos de intención.
- Dentro de un grupo, los cambios se organizan por punto clave y después por archivo. Cada punto clave es un subtítulo con su nombre, seguido en letra pequeña de la primera frase de su implementación.
- Cada cambio aparece una sola vez. Si responde a varios puntos clave, va bajo el principal, y los demás cuelgan de él como chips.
- El último grupo es siempre «Otros cambios», para los cambios que no responden a ninguna intención.
Con qué disposición se abre el panel depende de hasta dónde ha llegado Explicar con el turno:
| Explicar | Se abre con |
|---|---|
| Aún no ha tratado el turno | Por archivo |
| En curso, con explicaciones ya asociadas a este turno | Cambia a Por intención cuando se publica la primera explicación; los párrafos aún en investigación reservan un lugar en su grupo |
| Terminó con normalidad | Por intención |
| No encontró ningún párrafo que investigar | Por archivo, con una nota que dice «Este turno no tocó ninguna intención explicada.» |
Puedes volver a Por archivo en cualquier momento.
A qué responde cada cambio
En cada cambio, tu intención aparece en tres capas, de la más ligera a la más detallada:
- Marcas junto a las líneas: las líneas que una explicación cita expresamente tienen una marca fina neutra a su izquierda. Señálala para resaltar las demás líneas que cita la misma explicación y ver el nombre de la intención.
- Chips de intención: los puntos clave a los que responde un cambio cuelgan de su cabecera, dos como máximo, y el resto se pliega en «+N intenciones». Señala un chip para previsualizar el párrafo y la primera frase de su explicación; haz clic en él para abrir el documento en el panel contiguo, con esa explicación abierta.
- Bloque de intención: debajo de cada cambio hay una línea de resumen plegada, como «2 intenciones · 1 brecha». Ábrela para ver el texto de cada párrafo al que responde el cambio, con los elementos de atención de su explicación más reciente.
Un cambio se asocia a tu intención de una de tres formas: «Citado por Explicar» significa que una explicación cita expresamente esas líneas; «Coincide por líneas» significa que el cambio cae dentro de las líneas que cita una explicación; «Juzgado sin efecto» significa que Explicar revisó el cambio y vio que no afecta a ese párrafo. Un cambio que abarca la mayor parte de un archivo, o cuyo contenido anterior lo informó el agente en lugar de leerlo Noea, no se clasifica por líneas; el panel lo marca como «Sin clasificar por líneas».
Filtra por una parte de tu intención
«Filtrar por intención», en la parte superior de la lista de archivos, muestra solo los cambios de un párrafo o de un punto clave. Elige «Sin intención correspondiente» para ver solo los cambios que no responden a ninguna.
También puedes ir en sentido contrario, de la intención a los cambios. Abre la explicación de un párrafo en un documento de intención: «Implementación reciente», al final de la nota, enumera los turnos que lo cambiaron hace poco. Abre uno y el panel de código se abre en ese turno, ya filtrado a este párrafo.
Después de leer
«Otros cambios» no son necesariamente un problema; suelen ser funciones auxiliares de prueba, formato o actualizaciones de dependencias. Pero si un cambio en la lógica de negocio no responde a ninguna intención, merece preguntar por qué cambió y si pertenece a tu intención.
Pregunta al agente en el chat, o haz clic en «Preguntar sobre esto» a la izquierda del párrafo. Para las decisiones que quieres conservar, consulta Escribir lo acordado en la intención.
La agrupación depende de los resultados de Explicar. Si la tarjeta sigue mostrando «Ejecutar Explicar para agruparlos», revisa «Explicar automáticamente después de implementar» y «Explicar los turnos solo de código» en Configuración → Automatización, o haz clic en ella; consulta Cuando el código cambia.