Vai alla navigazione

Proposte di merge

Richiedi la revisione delle modifiche di un branch prima che raggiungano un altro branch.

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 ciò avvenga. Chiunque abbia accesso in modifica all’agente può aprire una proposta, anche verso un branch in cui non può effettuare il merge autonomamente. 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 all’unione diretta dei branch. Effettua il merge direttamente quando hai accesso in scrittura al branch di destinazione e non ti serve un secondo parere. Apri una proposta se vuoi che venga prima revisionata oppure se il branch di destinazione è protetto e non hai accesso in scrittura.

Disponibilità

Le proposte di merge sono in alpha. Quando più branch di un agente sono in lavorazione contemporaneamente, diventa difficile capire quali siano pronti e sicuri da unire. Le proposte di merge offrono al team un unico luogo per revisionare e discutere le modifiche di un branch, confrontare le percentuali di superamento dei test tra branch e vedere 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. Le aggiunte previste nelle prossime settimane includono:

  • Test obbligatori che devono essere superati prima di poter unire una proposta.
  • La richiesta di approvazioni a revisori specifici.
  • La configurazione di responsabili per diverse parti di un agente.

Ciclo di vita di una proposta

Ogni proposta ha uno di questi stati:

StatoSignificato
ApertaIn attesa di revisione o merge.
UnitaLe modifiche del branch di origine sono state unite al branch di destinazione.
ChiusaRitirata dall’autore, rifiutata da qualcun altro o chiusa automaticamente perché il branch di origine è stato archiviato.

Mentre una proposta è aperta, i revisori esprimono uno di questi giudizi. L’ultimo giudizio di un revisore sostituisce qualsiasi giudizio precedente dello stesso revisore:

Stato della revisioneSignificato
ApprovataIl revisore è soddisfatto delle modifiche.
Modifiche richiesteIl revisore vuole che qualcosa venga risolto prima del merge.

Aprire una proposta

Apri una proposta dal branch di cui vuoi far revisionare le modifiche:

Nella scheda Branches dell’agente, apri il menu delle opzioni del branch di origine e seleziona **Open merge proposal **.

Opzione Open merge proposal nel menu delle opzioni di un branch

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 solo 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.

Revisionare una proposta

La pagina di una proposta include queste schede:

La descrizione, la cronologia delle revisioni e un modulo per lasciare una revisione.

Scheda Panoramica di una proposta di merge

Chiunque abbia accesso in modifica all’agente, a eccezione dell’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 di branch del merge diretto, inclusa 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 a entrambi i branch, di origine e 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 che non sia il suo autore. Gli amministratori del workspace possono effettuare 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 ormai confluite altrove.

Chiudere una proposta

Una proposta può essere chiusa senza effettuare il merge in qualsiasi momento finché è aperta. L’autore e i revisori possono modificarne il titolo e la descrizione fino alla chiusura.

  • Quando l’autore chiude la propria proposta, viene registrata come ritirata.
  • Quando la chiude chiunque altro, viene registrata come rifiutata.
  • L’archiviazione del branch di origine chiude automaticamente tutte le proposte aperte da o verso di esso, registrandole come branch_archived.

Proposte di merge ed ElevenAgents Architect

Architect può aprire proposte di merge per te. Dopo aver apportato e testato una modifica su un branch, legge i commit del branch e l’anteprima del merge e apre una proposta con le sezioni Summary, Testing e How to review. Può anche suggerirti i revisori tra cui scegliere. Poiché Architect agisce per tuo conto, la proposta ti indica come autore.

Architect non può revisionare, approvare, unire o chiudere una proposta. Questi passaggi vengono sempre eseguiti da persone. Consulta Proposte e convalida per il flusso completo.

Passaggi successivi