Mergevoorstellen
Overzicht
Een mergevoorstel legt een verzoek vast om de wijzigingen van één branch in een andere samen te voegen en laat een teamgenoot de diff beoordelen voordat dat gebeurt. Iedereen met bewerkingstoegang tot de agent kan een voorstel openen, zelfs voor een branch waarin diegene zelf niet kan mergen. Voor het mergen van het voorstel is nog steeds schrijftoegang tot de doelbranch vereist. Zo kan een wijziging een beschermde branch bereiken zonder dat elke bijdrager mergebevoegdheden daarvoor krijgt.
Mergevoorstellen voegen een optionele beoordelingsstap toe aan branches rechtstreeks mergen. Merge rechtstreeks wanneer je schrijftoegang hebt tot de doelbranch en geen second opinion nodig hebt. Open een voorstel als je eerst een beoordeling wilt, of als de doelbranch beschermd is en je er geen schrijftoegang toe hebt.
Beschikbaarheid
Mergevoorstellen bevinden zich in alpha. Wanneer er tegelijk aan meerdere branches van een agent wordt gewerkt, is het lastig om bij te houden welke klaar en veilig zijn om te mergen. Mergevoorstellen bieden een team één plek om de wijzigingen van een branch te beoordelen en te bespreken, slagingspercentages van tests tussen branches te vergelijken en de meest recente gesprekken van de branch te bekijken.
De alpha is een eerste stap richting een CI/CD-workflow voor agents, vergelijkbaar met pull requests op GitHub. Geplande toevoegingen in de komende weken zijn onder meer:
- Verplichte tests die moeten slagen voordat een voorstel kan worden gemerged.
- Goedkeuringen aanvragen van specifieke reviewers.
- Eigenaren configureren voor verschillende onderdelen van een agent.
Levenscyclus van voorstellen
Elk voorstel heeft een van deze statussen:
Zolang een voorstel open is, geven reviewers een van deze beoordelingen. De meest recente beoordeling van een reviewer vervangt elke eerdere beoordeling van diezelfde reviewer:
Een voorstel openen
Open een voorstel vanuit de branch waarvan je de wijzigingen wilt laten beoordelen:
Vanuit de branchlijst
Vanaf het tabblad Proposals
Open op het tabblad Branches van de agent het optiemenu van de bronbranch en selecteer **Open merge proposal **.
Geef het voorstel een titel, een optionele beschrijving en kies een doelbranch uit de andere niet-gearchiveerde branches van de agent. Het openen van een voorstel wijzigt geen van beide branches; het legt alleen het verzoek vast.
Een paar van bron- en doelbranch kan maximaal één open voorstel tegelijk hebben. Sluit het bestaande voorstel voordat je er nog een opent tussen dezelfde twee branches.
Een voorstel beoordelen
De pagina van een voorstel heeft deze tabbladen:
Overzicht
Wijzigingen
Testruns
Gesprekken
De beschrijving, beoordelingsgeschiedenis en een formulier om een beoordeling achter te laten.
Iedereen met bewerkingstoegang tot de agent, behalve de auteur van het voorstel zelf, kan een beoordeling met een optionele opmerking achterlaten. Opmerkingen ondersteunen markdown.
Een voorstel mergen
Een voorstel mergen voert dezelfde branchmerge uit als rechtstreeks mergen, inclusief conflictoplossing en de optie om de bronbranch daarna te archiveren. Voordat een voorstel kan worden gemerged, moet het aan deze vereisten voldoen:
- De gebruiker die merget heeft schrijftoegang tot zowel de bron- als de doelbranch. Op een beschermde branch betekent dit dat je workspacebeheerder bent.
- De meest recente beoordeling van geen enkele reviewer is “changes requested”. Een reviewer die wijzigingen heeft aangevraagd, moet goedkeuren voordat het voorstel kan worden gemerged.
- Het voorstel heeft ten minste één goedkeuring van iemand anders dan de auteur. Workspacebeheerders kunnen mergen zonder deze goedkeuring.
Het mergen van een voorstel sluit automatisch elk ander open voorstel voor dezelfde bronbranch, omdat de wijzigingen daarvan nu zijn doorgegaan.
Een voorstel sluiten
Een voorstel kan op elk moment worden gesloten zonder te mergen zolang het open is. De auteur en reviewers kunnen de titel en beschrijving wijzigen totdat het is gesloten.
- Wanneer de auteur het eigen voorstel sluit, wordt dit vastgelegd als withdrawn.
- Wanneer iemand anders het sluit, wordt dit vastgelegd als rejected.
- Door de bronbranch te archiveren, worden alle open voorstellen van of naar die branch automatisch gesloten en vastgelegd als branch_archived.
Mergevoorstellen en ElevenAgents Architect
Architect kan mergevoorstellen voor je openen. Nadat deze een wijziging op een branch heeft aangebracht en getest, leest Architect de commits en mergepreview van de branch en opent een voorstel met de secties Summary, Testing en How to review. Architect kan ook reviewers voorstellen waaruit je kunt kiezen. Omdat Architect namens jou handelt, vermeldt het voorstel jou als auteur.
Architect kan een voorstel niet beoordelen, goedkeuren, mergen of sluiten. Die stappen worden altijd door mensen uitgevoerd. Zie Voorstellen en validatie voor de volledige flow.