Accueil / Fondamentaux et boucle d'agent

Lire et approuver un diff

Un diff se lit ligne par ligne avant d'être approuvé, et l'approbation elle-même se fait aujourd'hui par un menu à options nommées plutôt que par une frappe libre de lettre.

Un diff marque en moins ce qui disparaît d'un fichier et en plus ce qui s'ajoute. Une modification chirurgicale, qui ne touche que ce qui est nécessaire, se reconnaît à la brièveté de ces deux blocs, peu de lignes en moins, peu de lignes en plus, concentrées sur le point précis de la demande.

Un menu, pas une frappe libre

Quand Claude propose de modifier un fichier, l'invite de permission qui s'affiche est aujourd'hui un menu à options nommées, Yes, Yes and don't ask again, qui vaut jusqu'à la fin de la session pour une édition de fichier, et No. Cette édition n'est pas enregistrée dans le fichier lui même : le tableau des permissions le montre, elle dure jusqu'à la fin de session. Ce n'est que pour une commande shell ou un domaine WebFetch qu'un choix mémorisé survit à la session et au redémarrage, de façon permanente et par dépôt. On se déplace vers l'option voulue et on valide par Entrée. La touche Tab ouvre, avant de valider, un champ de commentaire attaché à l'option choisie, ce qui permet d'expliquer un refus plutôt que de le laisser muet. Aucune option nommée de ce menu ne permet d'éditer directement le contenu du diff affiché à cet endroit précis. Éditer un contenu proposé passe par un autre canal, la combinaison Ctrl+G, qui ouvre un plan dans l'éditeur de texte par défaut avant approbation, un mécanisme distinct de l'édition d'un diff de code déjà proposé à ce stade.

Lire avant d'approuver, ligne par ligne

La lecture ligne par ligne reste le geste qui protège, quel que soit le mécanisme d'approbation en place. Un diff qui touche vingt fichiers pour un changement annoncé comme localisé mérite un refus, ou un commentaire explicite ajouté par Tab, plutôt qu'une approbation rapide. Voici un exemple de diff minimal, produit sur des fichiers fabriqués pour la démonstration :

mkdir -p /tmp/demo-diff
printf 'ligne un\nligne deux\nligne trois\n' > /tmp/demo-diff/avant.txt
printf 'ligne un\nligne deux modifiée\nligne trois\n' > /tmp/demo-diff/apres.txt
diff /tmp/demo-diff/avant.txt /tmp/demo-diff/apres.txt

La sortie affiche une seule ligne retirée et une seule ligne ajoutée, exactement le périmètre attendu d'une modification chirurgicale. Un diff qui, pour la même demande, déplacerait aussi les lignes un et trois sort du périmètre nécessaire.

Le mode qui supprime cette invite entièrement, --dangerously-skip-permissions, équivaut au mode de permission bypass présenté dans la leçon sur les permissions et le mode plan. Ce mode est refusé par défaut si la session tourne en tant que root ou sous sudo sur Linux et macOS, sauf à l'intérieur d'un bac à sable reconnu, et sa première utilisation interactive affiche une boîte de dialogue d'avertissement à accepter une fois.