Die Agent-Review-Schleife schließen
Verfolge, was ein Agent geändert hat, prüfe es als Mensch und öffne nur erneut, wenn eine weitere Korrektur nötig ist.
6 Min.In dieser Anleitung
Agent-Rückmeldung
Ein Agent kann jeden Pin als changed, blocked, not applicable oder not located melden, mit summary, reason, geänderten Dateien, commit und pull request. Wiederholte Zustellung mit demselben Idempotenzschlüssel ist sicher; widersprüchlicher Inhalt unter diesem Schlüssel wird abgelehnt.
Menschliche Prüfung
Ein changed-Ergebnis setzt einen open- oder reopened-Pin auf correction ready. Nur ein Mensch kann eine Korrektur akzeptieren oder einen accepted-Pin erneut öffnen. Agenten können ihre eigene Arbeit nicht akzeptieren, und ungültige Zustandsübergänge werden abgelehnt.
- Normaler Ablauf: open → correction ready → accepted.
- Wenn die Prüfung fehlschlägt: accepted → reopened → correction ready.
Eine Ausführung erfassen und als Mensch akzeptieren
Ein Agent meldet Arbeit zur captureId der Capture und zu jeder pinId. Wiederhole eine Zustellung mit demselben Schlüssel nur, wenn das Ergebnis unverändert ist; eine andere Zusammenfassung, andere Dateien oder ein anderer Status brauchen einen neuen Schlüssel. Unbekannte Pins oder Captures werden abgelehnt, ohne private Kommentare zu wiederholen.
Eine Person akzeptiert eine Korrektur oder öffnet einen accepted-Pin in der Review-Oberfläche erneut. Agenten können ihre eigene Arbeit nicht akzeptieren. Nach einem menschlichen erneuten Öffnen ist der vorgesehene Retry ein zweites changed-Ergebnis. Lass anonyme Loop-Metriken aus, sofern du nicht opt-in aktivierst.
- Veröffentliche ein changed-Ergebnis für dieselbe
captureIdundpinIdund bestätige, dass der Viewer den Pin als bereit zur Annahme zeigt. - Verwende einen Zustellschlüssel nur erneut, wenn das Ergebnis identisch ist; erzeuge einen neuen Schlüssel, wenn sich Dateien, Zusammenfassung oder Status tatsächlich geändert haben.
- Wenn die Prüfung fehlschlägt, öffne als Mensch erneut, veröffentliche ein zweites Ergebnis, akzeptiere erneut und behalte die Capture-IDs vorher und nachher.