Comprendre le travail06 / 20
Lire les changements par intention
Sur cette page
Quand un Agent modifie des dizaines de fichiers en un tour, parcourir les diffs fichier par fichier rend difficile de répondre à « à quoi servaient ces changements ? ». Dans Noea, les changements d’un tour peuvent être regroupés selon l’intention à laquelle ils répondent, pour voir à laquelle de vos phrases chaque changement sert. Les changements qui ne répondent à aucune intention sont listés à part à la fin, sans être mélangés aux autres.
Partir de la carte des changements
Quand un tour laisse des modifications de fichiers, la réponse se termine par une carte des changements. Si un seul fichier a changé, son titre ressemble à « grace.ts modifié » ; si plusieurs ont changé, il ressemble à « 9 fichiers modifiés », avec les lignes ajoutées et supprimées à côté. Les fichiers que l’Agent a modifiés par la ligne de commande comptent aussi.
Une fois que Expliquer a traité le tour, la seconde ligne de la carte ressemble à « 2 intentions · 1 sans correspondance » : combien de parties de votre intention les changements servent, et combien de changements ne répondent à aucune. D’ici là, la seconde ligne propose « Lancer Expliquer pour les grouper ».
Cliquez n’importe où sur la carte et le panneau de code s’ouvre dans la barre auxiliaire à l’extrême droite de la zone principale, avec tous les changements du tour. La conversation elle-même ne répète pas le diff du tour.
Le panneau de code
Le haut du panneau affiche le titre de la conversation et le numéro du tour, par exemple « E-mail de période de grâce · Tour 2 », et permet de passer aux autres tours avec changements de la même conversation. Le bouton en haut à droite affiche ou masque la liste des fichiers, qui peut être à plat ou groupée par dossier ; chaque fichier indique ses lignes ajoutées et supprimées, et un clic y mène directement. L’en-tête de chaque fichier propose « Ouvrir avec l’application par défaut ».
Le diff n’a qu’une seule colonne de numéros de ligne : les lignes ajoutées et inchangées affichent leurs nouveaux numéros, et les lignes supprimées affichent leurs anciens numéros, atténués. Les lignes inchangées entre deux changements sont repliées sur une seule ligne que vous pouvez déplier, jusqu’au fichier entier. Si un fichier a encore changé après le tour, le panneau n’affiche que les changements de ce tour et propose « Afficher le fichier actuel ».
Faites glisser le bord gauche de la barre auxiliaire pour élargir le panneau. La fermer ne fait que replier la barre auxiliaire ; le document et la conversation à sa gauche restent tels quels.
Regroupés par intention
Le panneau offre deux présentations, « Par fichier » et « Par intention ». Par intention :
- Chaque groupe est une partie de votre intention. Son en-tête est le texte de ce paragraphe, avec le document et la section où il se trouve en petit au-dessus. Les groupes suivent l’ordre des paragraphes dans vos documents d’intention.
- Dans un groupe, les changements sont rangés par point clé, puis par fichier. Chaque point clé est un sous-titre portant son nom, suivi en petits caractères de la première phrase de sa réalisation.
- Chaque changement n’apparaît qu’une fois. S’il répond à plusieurs points clés, il est placé sous le principal, et les autres y sont accrochés sous forme de pastilles.
- Le dernier groupe est toujours « Autres modifications », pour les changements qui ne répondent à aucune intention.
La présentation avec laquelle le panneau s’ouvre dépend de l’avancement d’Expliquer sur le tour :
| Expliquer | S’ouvre en |
|---|---|
| N’a pas encore traité le tour | Par fichier |
| En cours, avec des explications déjà rattachées à ce tour | Passe à Par intention dès la publication de la première explication ; les paragraphes encore en cours d’analyse gardent leur place dans leur groupe |
| Terminé normalement | Par intention |
| N’a trouvé aucun paragraphe à analyser | Par fichier, avec la note « Ce tour n’a touché aucune intention expliquée. » |
Vous pouvez revenir à Par fichier à tout moment.
À quoi répond chaque changement
Sur chaque changement, votre intention apparaît en trois couches, de la plus légère à la plus détaillée :
- Marques à côté des lignes : les lignes qu’une explication cite explicitement ont une fine marque neutre sur leur gauche. Pointez-la pour mettre en évidence les autres lignes citées par la même explication et voir le nom de l’intention.
- Pastilles d’intention : les points clés auxquels répond un changement sont accrochés à son en-tête, deux au maximum, le reste étant replié dans « +N intentions ». Pointez une pastille pour prévisualiser le paragraphe et la première phrase de son explication ; cliquez dessus pour ouvrir le document dans le volet voisin, avec cette explication ouverte.
- Bloc d’intention : sous chaque changement se trouve une ligne de résumé repliée, par exemple « 2 intentions · 1 écart ». Ouvrez-la pour voir le texte de chaque paragraphe auquel le changement répond, avec les points d’attention de sa dernière explication.
Un changement est rattaché à votre intention de l’une de trois façons : « Cité par Expliquer » signifie qu’une explication cite explicitement ces lignes ; « Apparié par lignes » signifie que le changement tombe dans les lignes citées par une explication ; « Jugé sans effet » signifie que Expliquer a examiné le changement et constaté qu’il n’affecte pas ce paragraphe. Un changement qui couvre l’essentiel d’un fichier, ou dont le contenu antérieur a été rapporté par l’Agent et non lu par Noea, n’est pas apparié par lignes ; le panneau l’indique par « Non classé par lignes ».
Filtrer sur une partie de votre intention
« Filtrer par intention », en haut de la liste des fichiers, n’affiche que les changements d’un paragraphe ou d’un point clé. Choisissez « Aucune intention correspondante » pour ne voir que les changements qui ne répondent à aucune.
Vous pouvez aussi aller dans l’autre sens, de l’intention vers les changements. Ouvrez l’explication d’un paragraphe dans un document d’intention : « Implémentation récente », à la fin de la note, liste les tours qui l’ont modifié récemment. Ouvrez-en un, et le panneau de code s’ouvre sur ce tour, déjà filtré sur ce paragraphe.
Après la lecture
Les « Autres modifications » ne sont pas forcément un problème ; ce sont souvent des utilitaires de test, du formatage ou des mises à jour de dépendances. Mais si un changement de logique métier ne répond à aucune intention, il vaut la peine de demander pourquoi il a eu lieu et s’il doit figurer dans votre intention.
Posez la question à l’Agent dans la conversation, ou cliquez sur « Poser une question à ce sujet » à gauche du paragraphe. Pour les décisions que vous voulez garder, voir Consigner ce que vous avez tranché.
Le regroupement dépend des résultats d’Expliquer. Si la carte continue d’afficher « Lancer Expliquer pour les grouper », vérifiez « Expliquer automatiquement après l’implémentation » et « Expliquer les tours de code seul » dans Réglages → Automatisation, ou cliquez simplement dessus ; voir Quand le code change.