Merge-Vorschläge
Merge-Vorschläge
Lassen Sie die Änderungen eines Branches prüfen, bevor sie in einen anderen Branch übernommen werden.
Überblick
Ein Merge-Vorschlag dokumentiert die Anfrage, die Änderungen eines Branches in einen anderen zu übernehmen, und ermöglicht einem Teammitglied, den Diff zuvor zu prüfen. Jeder mit Bearbeitungszugriff auf den Agenten kann einen Vorschlag öffnen, auch für einen Branch, in den er selbst nicht mergen kann. Um den Vorschlag zu mergen, benötigen Sie weiterhin Schreibzugriff auf den Ziel-Branch. So kann eine Änderung einen geschützten Branch erreichen, ohne jedem Mitwirkenden Merge-Berechtigungen dafür zu geben.
Merge-Vorschläge fügen dem direkten Mergen von Branches einen optionalen Prüfungsschritt hinzu. Mergen Sie direkt, wenn Sie Schreibzugriff auf den Ziel-Branch haben und keine zweite Meinung benötigen. Öffnen Sie einen Vorschlag, wenn Sie ihn zuerst prüfen lassen möchten oder der Ziel-Branch geschützt ist und Sie keinen Schreibzugriff darauf haben.
Verfügbarkeit
Merge-Vorschläge befinden sich in der Alpha-Phase. Wenn mehrere Branches eines Agenten gleichzeitig bearbeitet werden, ist es schwierig nachzuverfolgen, welche davon bereit und sicher zum Mergen sind. Merge-Vorschläge bieten Teams einen zentralen Ort, um die Änderungen eines Branches zu prüfen und zu besprechen, Test-Erfolgsraten zwischen Branches zu vergleichen und die neuesten Gespräche des Branches anzusehen.
Die Alpha-Phase ist ein erster Schritt hin zu einem CI/CD-ähnlichen Workflow für Agenten, vergleichbar mit Pull Requests auf GitHub. In den kommenden Wochen sind unter anderem folgende Ergänzungen geplant:
- Erforderliche Tests, die bestanden werden müssen, bevor ein Vorschlag gemergt werden kann.
- Genehmigungen von bestimmten Prüfern anfordern.
- Verantwortliche für verschiedene Bereiche eines Agenten konfigurieren.
Lebenszyklus eines Vorschlags
Jeder Vorschlag hat einen dieser Status:
Solange ein Vorschlag offen ist, können Prüfer eines dieser Urteile abgeben. Das neueste Urteil eines Prüfers ersetzt jedes frühere Urteil desselben Prüfers:
Einen Vorschlag öffnen
Öffnen Sie einen Vorschlag aus dem Branch, dessen Änderungen Sie prüfen lassen möchten:
Aus der Branch-Liste
Über den Tab „Vorschläge“
Öffnen Sie im Tab Branches des Agenten das Optionsmenü des Quell-Branches und wählen Sie Merge- Vorschlag öffnen aus.
Geben Sie dem Vorschlag einen Titel und optional eine Beschreibung und wählen Sie aus den anderen nicht archivierten Branches des Agenten einen Ziel-Branch aus. Das Öffnen eines Vorschlags ändert keinen der beiden Branches. Es dokumentiert nur die Anfrage.
Für ein Quell- und Ziel-Branch-Paar kann jeweils nur ein offener Vorschlag vorhanden sein. Schließen Sie den vorhandenen Vorschlag, bevor Sie einen weiteren zwischen denselben zwei Branches öffnen.
Einen Vorschlag prüfen
Die Seite eines Vorschlags enthält diese Tabs:
Überblick
Änderungen
Testläufe
Gespräche
Die Beschreibung, den Prüfverlauf und ein Formular zum Hinterlassen einer Prüfung.
Jeder mit Bearbeitungszugriff auf den Agenten, außer dem Autor des Vorschlags, kann eine Prüfung mit optionalem Kommentar hinterlassen. Kommentare unterstützen Markdown.
Einen Vorschlag mergen
Das Mergen eines Vorschlags führt denselben Branch-Merge aus wie das direkte Mergen, einschließlich Konfliktlösung und der Option, den Quell-Branch anschließend zu archivieren. Bevor ein Vorschlag gemergt werden kann, muss er diese Anforderungen erfüllen:
- Der mergende Nutzer hat Schreibzugriff auf den Quell- und den Ziel-Branch. Bei einem geschützten Branch bedeutet das, dass er Workspace-Admin sein muss.
- Das neueste Urteil keines Prüfers lautet „Änderungen angefordert“. Ein Prüfer, der Änderungen angefordert hat, muss den Vorschlag genehmigen, bevor er gemergt werden kann.
- Der Vorschlag hat mindestens eine Genehmigung von einer anderen Person als dem Autor. Workspace-Admins können ohne diese Genehmigung mergen.
Das Mergen eines Vorschlags schließt automatisch alle anderen offenen Vorschläge für denselben Quell-Branch, da dessen Änderungen nun übernommen wurden.
Einen Vorschlag schließen
Ein Vorschlag kann jederzeit geschlossen werden, ohne ihn zu mergen, solange er offen ist. Der Autor und die Prüfer können Titel und Beschreibung bearbeiten, bis er geschlossen wird.
- Wenn der Autor seinen eigenen Vorschlag schließt, wird er als zurückgezogen erfasst.
- Wenn eine andere Person ihn schließt, wird er als abgelehnt erfasst.
- Das Archivieren des Quell-Branches schließt alle offenen Vorschläge von oder zu diesem Branch automatisch; sie werden als branch_archived erfasst.
Merge-Vorschläge und Architect
Architect hat Lesezugriff auf die Branches eines Agenten, wenn Sie ihn zu Branches, Versionen und Merges befragen. Daher kann er Ihnen helfen, den Diff eines Vorschlags zu verstehen oder offene Prüfungen in einem Gespräch zusammenzufassen.