difit

Über „difit“

Der „difit“-Skill fordert den Nutzer nach vorgenommenen Codeänderungen über „difit“, ein lokales Tool zur Anzeige von Diff-Dateien, zur Codeüberprüfung auf. Damit wird das Problem gelöst, Feedback aus der manuellen Überprüfung in den Arbeitsablauf des Agenten zu integrieren: Der Agent startet „difit“ für ein ausgewähltes Diff-Ziel, der Benutzer hinterlässt Überprüfungskommentare in der Benutzeroberfläche von „difit“, und diese Kommentare werden bei Beendigung von „difit“ an die Standardausgabe ausgegeben, sodass der Agent die Arbeit fortsetzen und die Kommentare bearbeiten kann. Wird der Server ohne Kommentare heruntergefahren, behandelt der Agent dies so, als wären keine Überprüfungskommentare bereitgestellt worden.

Die Skill definiert eine kleine Befehlsoberfläche. Sie wählt die Binärdatei „difit“ aus, sofern verfügbar; andernfalls greift sie auf „npx difit“ zurück. Sollte der „npx“-Fallback in einer Sandbox-Umgebung Netzwerkzugriff erfordern, fordert sie zunächst erweiterte Berechtigungen und die Zustimmung des Benutzers an, anstatt stillschweigend fortzufahren. Zu den Überprüfungszielen gehören nicht festgeschriebene Änderungen, der HEAD-Commit, in die Staging-Area gestellte Änderungen, nicht in die Staging-Area gestellte Änderungen, ein einzelner Commit oder ein Vergleich zwischen zwei Commits oder Branches. Optionale Startkommentare können über --comment als JSON-Thread-Objekte angehängt werden, die an Dateipfade und Zeilenbereiche angeheftet sind; dies ist nützlich, um Überprüfungsergebnisse direkt im Diff anzuzeigen, und nicht verfolgte Dateien können mit --include-untracked einbezogen werden. Das Tool kann nur innerhalb eines von Git verwalteten Verzeichnisses verwendet werden.

Zielgruppe sind Entwickler, die nach der Bearbeitung von Code durch den Agenten einen „Human-in-the-Loop“-Prüfpunkt wünschen. Die Funktion ist sicherheitsbewusst: Sie weist ausdrücklich an, niemals Geheimnisse, Tokens, Passwörter, API-Schlüssel, private Schlüssel oder andere anmeldedatenähnliche Informationen aus dem Diff in Kommentartexte oder Befehlszeilenargumente zu kopieren. Ihre Aktionen beschränken sich auf die Ausführung eines lokalen Review-Tools über Git-Diffs, wodurch sie unbedenklich ist.

FAQ

Wie gelangt das Überprüfungsfeedback zum Agenten?

Wenn der Benutzer Kommentare in „difit“ hinterlässt, werden diese beim Beenden des Befehls „difit“ an stdout ausgegeben, und der Agent setzt anschließend die Arbeit fort, um sie zu bearbeiten. Wird „difit“ ohne Kommentare geschlossen, wird dies so behandelt, als wären keine Überprüfungs-Kommentare vorhanden.

Was passiert, wenn difit nicht installiert ist?

Der Skill verwendet „difit“, wenn der Befehl „-v difit“ erfolgreich ist, andernfalls greift er auf „npx difit“ zurück. Sollte dieser npx-Fallback in einer Sandbox ohne entsprechende Berechtigung Netzwerkzugriff benötigen, fordert er vor der Ausführung erweiterte Berechtigungen und die Zustimmung des Benutzers an.

Was kann ich damit überprüfen?

Nicht festgeschriebene Änderungen, den HEAD-Commit, vorbereitete Änderungen, nicht vorbereitete Änderungen, einen einzelnen Commit oder einen Vergleich zwischen zwei Commits oder Branches, optional einschließlich nicht verfolgter Dateien mit --include-untracked.

Gibt es Einschränkungen bei der Verwendung?

Ja, es kann nur innerhalb eines von Git verwalteten Verzeichnisses verwendet werden, da es mit Git-Diffs arbeitet.

Wie geht es mit sensiblen Daten in Diffs um?

Es wird ausdrücklich festgelegt, dass Geheimnisse, Tokens, Passwörter, API-Schlüssel, private Schlüssel oder andere anmeldedatenähnliche Informationen niemals aus dem Diff in --comment-Inhalte oder Befehlszeilenargumente kopiert werden dürfen.

Alle Dateien