Proposte di unione
Panoramica
Una proposta di merge registra una richiesta di unire le modifiche di un branch in un altro e consente a un membro del team di esaminare il diff prima che avvenga. Chiunque abbia accesso di modifica all’agente può aprire una proposta, anche verso un branch in cui non può eseguire personalmente il merge. Per unire la proposta è comunque necessario avere accesso in scrittura al branch di destinazione: una proposta consente quindi a una modifica di raggiungere un branch protetto senza concedere a ogni collaboratore i diritti di merge su di esso.
Le proposte di merge aggiungono un passaggio di revisione facoltativo al merge diretto dei branch. Esegui il merge direttamente quando hai accesso in scrittura al branch di destinazione e non ti serve un secondo parere. Apri una proposta quando vuoi che venga prima esaminata oppure quando il branch di destinazione è protetto e non hai accesso in scrittura.
Disponibilità
Le proposte di merge sono in alpha. Quando sono in corso contemporaneamente più branch di un agente, diventa difficile capire quali sono pronti e sicuri da unire. Le proposte di merge offrono al team un unico luogo in cui esaminare e discutere le modifiche di un branch, confrontare i tassi di superamento dei test tra branch e visualizzare le conversazioni più recenti del branch.
L’alpha è un primo passo verso un workflow in stile CI/CD per gli agenti, simile alle pull request su GitHub. Nelle prossime settimane sono previste queste aggiunte:
- Test obbligatori che devono essere superati prima di poter unire una proposta.
- Richiesta di approvazioni a revisori specifici.
- Configurazione dei responsabili per diverse parti di un agente.
Ciclo di vita di una proposta
Ogni proposta ha uno di questi stati:
Finché una proposta è aperta, i revisori esprimono uno di questi giudizi. L’ultimo giudizio di un revisore sostituisce quelli precedenti dello stesso revisore:
Aprire una proposta
Apri una proposta dal branch di cui vuoi far esaminare le modifiche:
Dall'elenco dei branch
Dalla scheda Proposte
Nella scheda Branch dell’agente, apri il menu delle opzioni del branch di origine e seleziona **Apri proposta di merge **.
Assegna alla proposta un titolo, una descrizione facoltativa e scegli un branch di destinazione tra gli altri branch non archiviati dell’agente. L’apertura di una proposta non modifica nessuno dei due branch: registra soltanto la richiesta.
Una coppia di branch di origine e destinazione può avere al massimo una proposta aperta alla volta. Chiudi quella esistente prima di aprirne un’altra tra gli stessi due branch.
Esaminare una proposta
La pagina di una proposta contiene queste schede:
Panoramica
Modifiche
Esecuzioni dei test
Conversazioni
La descrizione, la cronologia delle revisioni e un modulo per lasciare una revisione.
Chiunque abbia accesso di modifica all’agente, tranne l’autore della proposta, può lasciare una revisione con un commento facoltativo. I commenti supportano Markdown.
Unire una proposta
L’unione di una proposta esegue lo stesso merge del branch del merge diretto, inclusi la risoluzione dei conflitti e l’opzione di archiviare successivamente il branch di origine. Prima di poter essere unita, una proposta deve soddisfare questi requisiti:
- L’utente che esegue il merge ha accesso in scrittura sia al branch di origine sia a quello di destinazione. In un branch protetto, ciò significa essere un amministratore del workspace.
- L’ultimo giudizio di nessun revisore è “modifiche richieste”. Un revisore che ha richiesto modifiche deve approvare prima che la proposta possa essere unita.
- La proposta ha almeno un’approvazione da qualcuno diverso dal suo autore. Gli amministratori del workspace possono eseguire il merge senza questa approvazione.
L’unione di una proposta chiude automaticamente qualsiasi altra proposta aperta per lo stesso branch di origine, poiché le sue modifiche sono state ormai trasferite.
Chiudere una proposta
Una proposta può essere chiusa senza eseguire il merge in qualsiasi momento mentre è aperta. L’autore e i revisori possono modificarne titolo e descrizione finché non viene chiusa.
- Quando l’autore chiude la propria proposta, questa viene registrata come ritirata.
- Quando la chiude chiunque altro, viene registrata come rifiutata.
- Archiviando il branch di origine si chiude automaticamente qualsiasi proposta aperta da o verso di esso, registrata come branch_archived.
Proposte di merge ed ElevenAgents Architect
Architect può aprire proposte di merge per te. Dopo aver apportato e testato una modifica in un branch, legge i commit del branch e l’anteprima del merge, quindi apre una proposta con le sezioni Riepilogo, Test e Come esaminare. Può anche suggerirti dei revisori tra cui scegliere. Poiché Architect agisce per tuo conto, la proposta ti indica come autore.
Architect non può esaminare, approvare, unire o chiudere una proposta. Questi passaggi vengono sempre svolti da persone. Consulta Proposte e convalida per il flusso completo.