difit

À propos de « difit »

La skill « difit » demande à l’utilisateur d’effectuer une révision du code via difit, un outil local de visualisation des différences, une fois que des modifications ont été apportées au code. Elle résout le problème de l’intégration des commentaires de révision humaine dans le flux de travail de l’agent : l’agent lance difit sur une cible de comparaison choisie, l’utilisateur laisse des commentaires de révision dans l’interface utilisateur de difit, et ces commentaires sont affichés sur stdout lorsque difit se ferme, afin que l’agent puisse poursuivre son travail et y donner suite. Si le serveur est arrêté sans commentaires, l’agent considère qu’aucun commentaire de révision n’a été fourni.

La compétence définit une interface de commande réduite. Elle sélectionne le binaire « difit » s’il est disponible ; à défaut, elle utilise npx « difit » ; et si cette solution de secours via npx nécessite un accès réseau dans un environnement sandboxé, elle demande d’abord des autorisations étendues et l’accord de l’utilisateur plutôt que de procéder en silence. Les cibles de révision comprennent les modifications non validées, le commit HEAD, les modifications préparées, les modifications non préparées, un commit unique, ou une comparaison entre deux commits ou deux branches. Des commentaires de démarrage facultatifs peuvent être joints via l’option --comment sous forme d’objets JSON de type « thread » associés à des chemins d’accès et des plages de lignes, ce qui est utile pour afficher les résultats de la révision directement dans le diff ; les fichiers non suivis peuvent être inclus avec l’option --include-untracked. Cet outil ne peut être utilisé qu’au sein d’un répertoire géré par Git.

Les utilisateurs cibles sont les développeurs qui souhaitent un point de contrôle de révision « human-in-the-loop » après que l’agent a modifié le code. Cette compétence est soucieuse de la sécurité : elle interdit explicitement de copier des secrets, des jetons, des mots de passe, des clés API, des clés privées ou tout autre élément de type identifiant depuis le diff vers le corps des commentaires ou les arguments de ligne de commande. Ses actions se limitent à l’exécution d’un outil de révision local sur des diffs Git, ce qui la rend inoffensive.

FAQ

Comment les commentaires de révision parviennent-ils à l’agent ?

Lorsque l’utilisateur laisse des commentaires dans difit, ceux-ci sont affichés sur stdout à la fin de l’exécution de la commande `difit`, et l’agent poursuit ensuite son travail pour y remédier. Si difit est fermé sans commentaires, cela est considéré comme l’absence de commentaires de révision.

Que se passe-t-il si difit n’est pas installé ?

La skill utilise difit si la commande `-v difit` aboutit ; dans le cas contraire, elle se rabat sur `npx difit`. Si cette solution de secours via npx nécessite un accès au réseau dans un bac à sable sans autorisation, elle demande des droits élevés et l’approbation de l’utilisateur avant de s’exécuter.

Que puis-je examiner avec cet outil ?

Les modifications non validées, le commit HEAD, les modifications mises en attente, les modifications non mises en attente, un commit unique, ou une comparaison entre deux commits ou deux branches, en incluant éventuellement les fichiers non suivis avec l'option --include-untracked.

Y a-t-il des contraintes d’utilisation ?

Oui, il ne peut être utilisé qu’au sein d’un répertoire géré par Git, car il fonctionne sur des diffs Git.

Comment gère-t-il les données sensibles dans les différences ?

Il est explicitement indiqué de ne jamais copier de secrets, de jetons, de mots de passe, de clés API, de clés privées ou d’autres éléments de type identifiant depuis le diff dans le corps des options --comment ou dans les arguments de ligne de commande.

Tous les fichiers