Vai al contenuto

GUIDA PRATICA

Review changes and commit

Changes è l’interpretazione di Panolayer dei diff. Invece di leggere migliaia di righe di un diff, comprendi rapidamente cosa è cambiato e vedi quali file richiedono la tua attenzione, ordinati dal rischio più alto a quello più basso.

Ultimo aggiornamento

Leggi come Markdown

Vedi cosa richiede revisione

Vedi i worktree dei tuoi agent e le loro modifiche non sottoposte a commit in un unico posto. Rivedi le modifiche rischiose, indaga su tutto ciò che richiede una correzione ed esegui il commit del codice dalla pagina Modifiche.

Questa guida usa l’esempio Twitter di Panolayer, twitter-starter. Se hai seguito Correggi il tuo primo bug con Panolayer, usa questi passaggi per rivedere la correzione dell’eliminazione.

Gli screenshot e i brevi video mostrano diverse modifiche nella stessa app Twitter, tra cui modifiche a formattazione, ricerca, esportazione e post salvati. L’elenco dei file, i punteggi di rischio e gli ID dei commit dipenderanno dal lavoro che stai rivedendo. Fai clic su uno screenshot per visualizzarlo a dimensione intera.

Apri Modifiche nella barra laterale. Sul lato destro puoi vedere i diversi worktree e il codice non sottoposto a commit dei tuoi agent. Seleziona un worktree per vedere cosa ha modificato quell’agent, con i file classificati dal rischio più alto a quello più basso.

Passa tra i worktree dei tuoi agent, rivedi le loro modifiche ed esegui il commit del codice da questa pagina. I punteggi di rischio permettono di vedere rapidamente quali file richiedono la tua attenzione e potrebbero necessitare di una correzione.

Puoi anche selezionare un commit esistente in Cronologia per rivedere ciò che è stato registrato. Se hai già unito la correzione dell’eliminazione, la trovi lì; il suo merge ha già registrato la modifica in locale.

Rivedi le modifiche dal rischio più alto a quello più basso

Modifiche assegna un punteggio ai file da rischioso a non rischioso e spiega cosa è cambiato. Inizia dai file a rischio più alto per capire cosa richiede revisione e potenzialmente una correzione prima di eseguire il commit.

Passa tra Spettro del rischio, Barre del rischio e Sovrapposizione per esplorare le stesse modifiche in tre viste visive.

Spettro del rischio

Vedi i file modificati disposti lungo uno spettro orizzontale, dal rischio alto a sinistra al rischio basso a destra.

Spettro del rischio offre una panoramica visiva del rischio di una modifica nell’app Twitter.

Barre del rischio

Confronta i file come barre ordinate per rischio. La vista va da molto rischioso a non rischioso, rendendo facile vedere dove le modifiche richiedono attenzione.

Barre del rischio mostra la stessa modifica Twitter come una serie di barre, ordinate dal rischio più alto a quello più basso.

Sovrapposizione

Vedi dove si sovrappongono modifiche UI, modifiche alla logica e modifiche rischiose. I file raggruppati mostrano come queste parti della modifica si relazionano tra loro.

Sovrapposizione mostra quali file rientrano nei gruppi UI, Logica e Rischioso nell’app Twitter.

Ispeziona una modifica che richiede attenzione

La panoramica dei rischi mostra dove concentrare la revisione. Apri un file quando vuoi capire più nel dettaglio una modifica specifica.

  1. Seleziona un file nel grafo o nell'elenco dei file modificati.
  2. Leggi il percorso, il riepilogo della modifica e la spiegazione del rischio.
  3. Scegli Split per un confronto affiancato, oppure Inline per leggere le modifiche in un'unica vista.
  4. Segui la modifica attraverso la funzione interessata e i suoi chiamanti. Controlla anche i test, la configurazione e i file delle dipendenze correlati.
Questa cattura esamina una modifica alla ricerca in app/api/search/route.ts. Il diff mostra come è cambiata la query SQL.

Per la correzione dell'eliminazione, apri components/Post.tsx e ispeziona handleDelete(). Verifica in che modo la modifica interviene sulla condizione canDelete segnalata e se la conferma dell'utente, la richiesta di eliminazione e la gestione della risposta di successo sono ancora coerenti nel loro insieme.

Leggi l'analisi e chiedi chiarimenti sui punti di attenzione

L'analisi approfondita di Panolayer Agent è sempre disponibile in Changes. Apri il pannello Panolayer Agent – Deep Analysis per leggere la sua valutazione, i punti di attenzione e i riferimenti alle fonti. Segui un punto di attenzione nel file interessato per capire dove intervenire.

Guarda: esamina l'analisi di una modifica all'esportazione di Twitter

La clip di analisi esistente mostra una modifica all'esportazione nell'app Twitter, con i punti di attenzione collegati ai file interessati.

Usa Chat per proseguire la revisione con Panolayer Agent. Fai una domanda legata al comportamento che stai verificando, ad esempio:

«In che modo questa modifica risolve il problema di eliminazione e quali test coprono il comportamento previsto?»

Usa la risposta per orientarti nella modifica e indagare ciò che non è chiaro.

Leggi la verifica insieme alla revisione

Changes può mostrare i risultati della verifica sulle funzioni interessate. Leggi le regole non superate e i controlli ancora in sospeso o non disponibili, poi segui le relative spiegazioni nel codice.

La panoramica dei rischi ti aiuta a scegliere dove guardare. L'analisi approfondita ti fornisce i punti di attenzione da esaminare. La verifica segnala i controlli rispetto alle aspettative sul comportamento del codice. Leggile insieme al diff e ai test pertinenti.

Per l'esempio dell'eliminazione, verifica che l'errore selezionato sia stato corretto ed esamina eventuali nuovi errori separatamente dai problemi preesistenti. Vedi Comprendere un risultato di verifica per i campi di riepilogo e gli stati.

Avvia l'applicazione quando la modifica richiede una verifica a runtime. Per questa correzione, prova a eliminare un post e controlla che la conferma o l'annullamento si comportino come previsto.

Merge the agent’s work when you’re satisfied

When the agent requests a merge, review the verification summary and confirm the target branch. Choose Not now to keep reviewing, or Merge into main to bring the work into the sample’s main branch.

This is the deletion fix’s verification summary. You decide whether the reviewed work reaches your branch.

The Merged into main confirmation shows the commit ID. This workflow records the agent’s change in local Git history; you do not need to commit that same change again.

Commit any uncommitted edits

Use this step for your own edits or other uncommitted work in the current workspace. If the agent’s merge already saved the change and you have no further edits, continue to History.

  1. Check the full changed-file list.
  2. Review the suggested commit message. Use Edit message if it needs to describe the change more clearly.
  3. Choose Commit to save the changes to the local branch. Choose Commit & Push if you also want to send the commit to a configured remote.
The existing toolbar capture shows a search fix awaiting a commit. The same controls apply to uncommitted changes in your active workspace.

A Panolayer commit includes every changed file in the workspace. Use Git directly if you need to stage only part of the change. Read any reported check failures before deciding to commit; a commit can still be created when checks fail.

Confirm the result in History

Open History and find the new commit using its message, author, and commit ID. Select it to inspect the recorded change, then return to Working tree to check for remaining uncommitted edits.

Watch: Confirm a Twitter saved-post change in merge confirmation and History

This existing clip follows a saved-post change in the Twitter app. Use the commit ID from your own merge confirmation to find your change.

For the deletion fix, you should be able to find its recorded change and inspect the files that landed. Check that no unexpected uncommitted edits remain.

Push when you’re ready to share the commit

A merge or commit saves work locally. To send an existing local commit to your Git remote, open Git and choose Push.

Pushing requires a configured remote and permission to write to it. If the sample has no remote, the local commit completes this walkthrough. If a push reports an error, read it and resolve the remote or sign-in problem before trying again.

Use your Git host for pull requests and team review.