Przejdź do treści

PORADNIK

Review changes and commit

Zmiany to autorskie podejście Panolayer do diffów. Zamiast czytać tysiące linii diffa, szybko zrozum, co się zmieniło, i zobacz, które pliki wymagają uwagi — uszeregowane od najwyższego do najniższego ryzyka.

Ostatnia aktualizacja

Pobierz jako Markdown

Zobacz, co wymaga przeglądu

Zobacz worktree swoich agentów i ich niezacommitowane zmiany w jednym miejscu. Przejrzyj ryzykowne zmiany, zbadaj wszystko, co wymaga poprawy, i zacommituj kod ze strony Zmiany.

Ten przewodnik korzysta z przykładu Twittera od Panolayer, twitter-starter. Jeśli wykonałeś Napraw swój pierwszy błąd z Panolayer, użyj tych kroków, aby przejrzeć poprawkę usuwania.

Zrzuty ekranu i krótkie filmy pokazują kilka zmian w tej samej aplikacji Twitter, w tym zmiany formatowania, wyszukiwania, eksportu i zapisanych postów. Twoja lista plików, oceny ryzyka i identyfikatory commitów będą zależeć od przeglądanej pracy. Kliknij zrzut ekranu, aby zobaczyć go w pełnym rozmiarze.

Otwórz Zmiany na pasku bocznym. Po prawej stronie widzisz poszczególne worktree i niezacommitowany kod od swoich agentów. Wybierz worktree, aby zobaczyć, co zmienił dany agent — pliki są uszeregowane od najwyższego do najniższego ryzyka.

Przełączaj się między worktree swoich agentów, przeglądaj ich zmiany i commituj kod z tej strony. Oceny ryzyka pozwalają szybko zobaczyć, które pliki wymagają uwagi i mogą wymagać poprawki.

Możesz też wybrać istniejący commit w Historii, aby przejrzeć, co zostało zapisane. Jeśli poprawka usuwania została już scalona, znajdziesz ją tam; jej scalenie zostało już zapisane lokalnie.

Przeglądaj zmiany od najwyższego do najniższego ryzyka

Changes ocenia pliki od ryzykownych do niegroźnych i wyjaśnia, co się zmieniło. Zacznij od plików o najwyższym ryzyku, aby zrozumieć, co wymaga przeglądu i ewentualnej poprawy przed commitem.

Przełączaj się między Spektrum ryzyka, Słupkami ryzyka i Nakładaniem się, aby poznać te same zmiany w trzech widokach wizualnych.

Spektrum ryzyka

Zobacz zmienione pliki rozmieszczone na poziomym spektrum — od wysokiego ryzyka po lewej do niskiego po prawej.

Spektrum ryzyka daje wizualny przegląd ryzyka w obrębie zmiany w aplikacji Twitter.

Słupki ryzyka

Porównaj pliki jako słupki uporządkowane według ryzyka. Widok biegnie od bardzo ryzykownych do niegroźnych, co ułatwia dostrzeżenie, gdzie zmiany wymagają uwagi.

Słupki ryzyka pokazują tę samą zmianę w Twitterze jako serię słupków, uszeregowaną od najwyższego do najniższego ryzyka.

Nakładanie się

Zobacz, gdzie nakładają się zmiany w UI, zmiany w logice i ryzykowne zmiany. Pogrupowane pliki pokazują, jak te części zmiany odnoszą się do siebie.

Nakładanie się pokazuje, które pliki należą do grup UI, Logic i Risky w aplikacji Twitter.

Sprawdź zmianę, która wymaga uwagi

Przegląd ryzyka pokazuje, na czym skupić przegląd. Otwórz plik, gdy chcesz dokładniej zrozumieć konkretną zmianę.

  1. Wybierz plik na grafie lub na liście zmienionych plików.
  2. Przeczytaj jego ścieżkę, podsumowanie zmiany i wyjaśnienie ryzyka.
  3. Wybierz Split, aby porównać zmiany obok siebie, lub Inline, aby czytać je w jednym widoku.
  4. Prześledź zmianę w odpowiedniej funkcji i jej wywołaniach. Sprawdź też powiązane testy, konfigurację i pliki zależności.
Ten zrzut przedstawia przegląd zmiany wyszukiwania w app/api/search/route.ts. Diff pokazuje, jak zmieniło się zapytanie SQL.

W ramach poprawki usuwania otwórz components/Post.tsx i sprawdź handleDelete(). Sprawdź, jak zmiana odnosi się do zgłoszonego warunku canDelete oraz czy potwierdzenie użytkownika, żądanie usunięcia i obsługa pomyślnej odpowiedzi nadal mają razem sens.

Przeczytaj analizę i pytaj o zastrzeżenia

Szczegółowa analiza od Panolayer Agent jest zawsze dostępna w widoku Changes. Otwórz panel Panolayer Agent – Deep Analysis, aby przeczytać jej ocenę, zastrzeżenia i odwołania do źródeł. Przejdź od zastrzeżenia do odpowiedniego pliku, aby zrozumieć, co wymaga uwagi.

Obejrzyj: analiza zmiany eksportu z Twittera

Istniejący klip analizy pokazuje zmianę eksportu w aplikacji Twitter, a zastrzeżenia są powiązane z plikami, których dotyczy zmiana.

Użyj Chat, aby kontynuować przegląd z Panolayer Agent. Zadaj pytanie związane z zachowaniem, które sprawdzasz, na przykład:

„Jak ta zmiana naprawia problem z usuwaniem i które testy obejmują oczekiwane zachowanie?”

Wykorzystaj odpowiedź, aby poruszać się po zmianie i zbadać wszelkie niejasności.

Czytaj weryfikację razem z przeglądem

Widok Changes może pokazywać wyniki weryfikacji dla objętych funkcji. Czytaj nieudane reguły oraz kontrole, które są jeszcze w toku lub niedostępne, a następnie podążaj za ich wyjaśnieniami w kodzie.

Przegląd ryzyka pomaga wybrać, gdzie spojrzeć. Analiza szczegółowa wskazuje obszary do zbadania. Weryfikacja raportuje kontrole względem oczekiwań dotyczących zachowania kodu. Czytaj je razem z diffem i odpowiednimi testami.

W przykładzie z usuwaniem potwierdź, że wybrany błąd został naprawiony, i przejrzyj nowe błędy osobno od problemów istniejących wcześniej. Zobacz Jak rozumieć wynik weryfikacji, aby poznać pola podsumowania i statusy.

Uruchom aplikację, gdy zmiana wymaga sprawdzenia w czasie działania. W przypadku tej poprawki spróbuj usunąć post i sprawdź, czy potwierdzenie i anulowanie działają zgodnie z oczekiwaniami.

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.