Die Arbeit verstehen06 / 20
Änderungen nach Intent lesen
Auf dieser Seite
Ändert ein Agent in einer Runde Dutzende Dateien, fällt es schwer, die Diffs Datei für Datei durchzugehen und die Frage „Wofür waren diese Änderungen?“ zu beantworten. In Noea lassen sich die Änderungen einer Runde nach dem Intent gruppieren, den sie beantworten, sodass du siehst, für welchen deiner Sätze jede Änderung da ist. Änderungen, die keinen Intent beantworten, stehen getrennt am Ende, nicht mittendrin.
Bei der Änderungskarte beginnen
Hinterlässt eine Runde Dateiänderungen, endet die Antwort mit einer Änderungskarte. Hat sich eine Datei geändert, lautet ihr Titel etwa „grace.ts bearbeitet“; bei mehreren etwa „9 Dateien geändert“, daneben die hinzugefügten und entfernten Zeilen. Auch Dateien, die der Agent über die Kommandozeile geändert hat, zählen.
Hat Erläutern die Runde bearbeitet, steht in der zweiten Zeile der Karte etwa „2 Absichten · 1 ohne Zuordnung“: wie viele Teile deines Intents die Änderungen beantworten und wie viele Änderungen keinen beantworten. Bis dahin bietet die zweite Zeile „Erläutern ausführen, um sie zu gruppieren“ an.
Klicke irgendwo auf die Karte, und das Code-Panel öffnet sich in der Nebenleiste ganz rechts im Hauptbereich und zeigt jede Änderung der Runde. Der Chat selbst wiederholt den Diff der Runde nicht.
Das Code-Panel
Oben im Panel stehen der Titel des Chats und die Nummer der Runde, etwa „Mail zur Schonfrist · Runde 2“; du kannst dort zu anderen Runden mit Änderungen im selben Chat wechseln. Die Schaltfläche oben rechts blendet die Dateiliste ein oder aus, die flach oder nach Ordnern gruppiert sein kann; jede Datei zeigt ihre hinzugefügten und entfernten Zeilen, und ein Klick springt zu ihr. Der Kopf jeder Datei hat „Mit Standardprogramm öffnen“.
Der Diff hat eine einzige Spalte mit Zeilennummern: Hinzugefügte und unveränderte Zeilen zeigen ihre neuen Nummern, entfernte Zeilen ihre alten, abgedunkelt. Unveränderte Zeilen zwischen Änderungen sind zu einer Zeile eingeklappt, die du aufklappen kannst, bis hin zur ganzen Datei. Hat sich eine Datei nach der Runde erneut geändert, zeigt das Panel nur die Änderungen dieser Runde und bietet „Aktuelle Datei zeigen“ an.
Ziehe den linken Rand der Nebenleiste, um das Panel zu verbreitern. Schließt du es, klappt nur die Nebenleiste zu; Dokument und Chat links davon bleiben, wie sie sind.
Nach Intent gruppiert
Das Panel hat zwei Anordnungen, „Nach Datei“ und „Nach Absicht“. Nach Absicht gilt:
- Jede Gruppe ist ein Teil deines Intents. Ihre Überschrift ist der Text dieses Absatzes, mit Dokument und Abschnitt, in dem er steht, klein darüber. Die Gruppen folgen der Reihenfolge der Absätze in deinen Intent-Dokumenten.
- Innerhalb einer Gruppe sind die Änderungen nach zentralem Punkt und dann nach Datei geordnet. Jeder zentrale Punkt ist eine Zwischenüberschrift mit seinem Namen, gefolgt in kleiner Schrift vom ersten Satz seiner Umsetzung.
- Jede Änderung erscheint nur einmal. Beantwortet sie mehrere zentrale Punkte, steht sie unter dem wichtigsten, und die anderen hängen als Chips daran.
- Die letzte Gruppe ist immer „Übrige Änderungen“, für Änderungen, die keinen Intent beantworten.
Mit welcher Anordnung das Panel sich öffnet, hängt davon ab, wie weit Erläutern mit der Runde ist:
| Erläutern | Öffnet sich mit |
|---|---|
| Hat die Runde noch nicht bearbeitet | Nach Datei |
| Läuft, mit schon zugeordneten Erläuterungen zu dieser Runde | Wechselt zu Nach Absicht, sobald die erste Erläuterung veröffentlicht ist; Absätze, die noch untersucht werden, halten einen Platz in ihrer Gruppe |
| Normal beendet | Nach Absicht |
| Hat keinen Absatz zum Untersuchen gefunden | Nach Datei, mit dem Hinweis „Diese Runde hat keine erläuterte Absicht berührt.“ |
Du kannst jederzeit zu Nach Datei zurückwechseln.
Was jede Änderung beantwortet
An jeder Änderung zeigt sich dein Intent in drei Schichten, von dezent bis ausführlich:
- Markierungen neben Zeilen: Zeilen, die eine Erläuterung ausdrücklich zitiert, haben links eine dünne neutrale Markierung. Zeige darauf, um die anderen Zeilen hervorzuheben, die dieselbe Erläuterung zitiert, und den Namen des Intents zu sehen.
- Intent-Chips: Die zentralen Punkte, die eine Änderung beantwortet, hängen an ihrem Kopf, höchstens zwei, der Rest ist zu „+N Absichten“ eingeklappt. Zeige auf einen Chip, um den Absatz und den ersten Satz seiner Erläuterung als Vorschau zu sehen; klicke darauf, um das Dokument im Bereich daneben mit geöffneter Erläuterung zu öffnen.
- Intent-Block: Unter jeder Änderung steht eine eingeklappte Zusammenfassungszeile, etwa „2 Absichten · 1 Lücke“. Öffne sie, um den Text jedes Absatzes zu sehen, den die Änderung beantwortet, mit den Hinweisen aus seiner letzten Erläuterung.
Eine Änderung ist auf eine von drei Arten mit deinem Intent verknüpft: „Von Erläutern zitiert“ heißt, eine Erläuterung zitiert diese Zeilen ausdrücklich; „Nach Zeilen zugeordnet“ heißt, die Änderung liegt innerhalb der Zeilen, die eine Erläuterung zitiert; „Als unberührt beurteilt“ heißt, Erläutern hat die Änderung geprüft und festgestellt, dass sie diesen Absatz nicht betrifft. Eine Änderung, die den Großteil einer Datei umfasst oder deren früherer Inhalt vom Agent gemeldet statt von Noea gelesen wurde, wird nicht nach Zeilen zugeordnet; das Panel markiert sie mit „Nicht nach Zeilen zugeordnet“.
Auf einen Teil deines Intents filtern
„Nach Absicht filtern“ oben in der Dateiliste zeigt nur die Änderungen zu einem Absatz oder einem zentralen Punkt. Wähle „Keine zugeordnete Absicht“, um nur Änderungen zu sehen, die keinen beantworten.
Du kannst auch den umgekehrten Weg gehen, vom Intent zu den Änderungen. Öffne in einem Intent-Dokument die Erläuterung eines Absatzes: „Jüngste Umsetzung“ am Ende der Notiz listet die Runden auf, die ihn kürzlich geändert haben. Öffne eine, und das Code-Panel öffnet sich bei dieser Runde, schon auf diesen Absatz gefiltert.
Nach dem Lesen
„Übrige Änderungen“ sind nicht unbedingt ein Problem; oft sind es Testhilfen, Formatierung oder Abhängigkeits-Updates. Beantwortet aber eine Änderung an der Geschäftslogik keinen Intent, lohnt sich die Frage, warum sie geändert wurde und ob sie in deinen Intent gehört.
Frag den Agent im Chat oder klicke links vom Absatz auf „Hierzu fragen“. Für Entscheidungen, die du festhalten willst, siehe Das Vereinbarte in den Intent schreiben.
Die Gruppierung hängt von den Ergebnissen von Erläutern ab. Zeigt die Karte dauerhaft „Erläutern ausführen, um sie zu gruppieren“, prüfe „Nach dem Implementieren automatisch erläutern“ und „Reine Code-Runden erläutern“ unter „Einstellungen“ → „Automatisierung“, oder klicke einfach darauf; siehe Wenn sich der Code ändert.