Przejdź do nawigacji

Propozycje scalania

Poproś o sprawdzenie zmian w gałęzi, zanim trafią do innej gałęzi.

Omówienie

Propozycja scalania rejestruje prośbę o scalenie zmian z jednej gałęzi z inną i pozwala członkowi zespołu sprawdzić różnice, zanim do tego dojdzie. Każdy z dostępem do edycji agenta może otworzyć propozycję, nawet dla gałęzi, do której sam nie może scalać zmian. Scalenie propozycji nadal wymaga dostępu do zapisu w gałęzi docelowej, więc propozycja pozwala wprowadzić zmianę do chronionej gałęzi bez przyznawania każdemu współtwórcy prawa do scalania z nią.

Propozycje scalania dodają opcjonalny etap przeglądu do bezpośredniego scalania gałęzi. Scalaj bezpośrednio, gdy masz dostęp do zapisu w gałęzi docelowej i nie potrzebujesz drugiej opinii. Otwórz propozycję, gdy chcesz, by ktoś najpierw ją sprawdził, lub gdy gałąź docelowa jest chroniona i nie masz do niej dostępu do zapisu.

Dostępność

Propozycje scalania są w fazie alfa. Gdy równocześnie powstaje kilka gałęzi agenta, trudno śledzić, które są gotowe i bezpieczne do scalenia. Propozycje scalania dają zespołowi jedno miejsce do sprawdzania i omawiania zmian w gałęzi, porównywania wskaźników zaliczonych testów między gałęziami oraz przeglądania najnowszych rozmów z gałęzi.

Wersja alfa to pierwszy krok do workflow agentów w stylu CI/CD, podobnego do pull requestów na GitHubie. Planowane dodatki w najbliższych tygodniach to:

  • Wymagane testy, które muszą przejść, zanim propozycja zostanie scalona.
  • Prośby o zatwierdzenie od konkretnych recenzentów.
  • Konfiguracja właścicieli różnych części agenta.

Cykl życia propozycji

Każda propozycja ma jeden z tych statusów:

StatusZnaczenie
OtwarteOczekuje na sprawdzenie lub scalenie.
ScalonaZmiany z gałęzi źródłowej zostały scalone z gałęzią docelową.
ZamkniętaWycofana przez autora, odrzucona przez inną osobę lub zamknięta automatycznie, bo gałąź źródłowa została zarchiwizowana.

Gdy propozycja jest otwarta, recenzenci mogą wydać jeden z tych werdyktów. Najnowszy werdykt recenzenta zastępuje każdy wcześniejszy werdykt tego samego recenzenta:

Stan przegląduZnaczenie
ZatwierdzonoRecenzent jest zadowolony ze zmian.
Poproszono o zmianyRecenzent chce, by coś zostało poprawione przed scaleniem.

Otwieranie propozycji

Otwórz propozycję z gałęzi, której zmiany chcesz poddać przeglądowi:

W karcie Branches agenta otwórz menu opcji gałęzi źródłowej i wybierz **Open merge proposal **.

Opcja Open merge proposal w menu opcji gałęzi

Nadaj propozycji tytuł, opcjonalny opis i wybierz gałąź docelową spośród innych niezarchiwizowanych gałęzi agenta. Otwarcie propozycji nie zmienia żadnej z gałęzi — tylko rejestruje prośbę.

Para gałęzi źródłowej i docelowej może mieć jednocześnie najwyżej jedną otwartą propozycję. Zamknij istniejącą, zanim otworzysz kolejną między tymi samymi dwiema gałęziami.

Sprawdzanie propozycji

Strona propozycji ma te karty:

Opis, historia przeglądów i formularz do wystawienia recenzji.

Karta Overview propozycji scalania

Każdy z dostępem do edycji agenta, poza autorem propozycji, może wystawić recenzję z opcjonalnym komentarzem. Komentarze obsługują Markdown.

Scalanie propozycji

Scalenie propozycji wykonuje takie samo scalanie gałęzi jak scalanie bezpośrednie, w tym rozwiązywanie konfliktów i opcję późniejszego zarchiwizowania gałęzi źródłowej. Zanim propozycja zostanie scalona, musi spełniać te wymagania:

  • Osoba scalająca ma dostęp do zapisu w gałęzi źródłowej i docelowej. W przypadku chronionej gałęzi oznacza to bycie administratorem obszaru roboczego.
  • Żaden z najnowszych werdyktów recenzentów nie brzmi „poproszono o zmiany”. Recenzent, który poprosił o zmiany, musi je zatwierdzić, zanim propozycja będzie mogła zostać scalona.
  • Propozycja ma co najmniej jedno zatwierdzenie od osoby innej niż jej autor. Administratorzy obszaru roboczego mogą scalać bez tego zatwierdzenia.

Scalenie propozycji automatycznie zamyka wszystkie inne otwarte propozycje dla tej samej gałęzi źródłowej, ponieważ jej zmiany zostały już przeniesione.

Zamykanie propozycji

Propozycję można zamknąć bez scalania w dowolnym momencie, gdy jest otwarta. Autor i recenzenci mogą edytować jej tytuł oraz opis, dopóki nie zostanie zamknięta.

  • Gdy autor zamyka własną propozycję, jest ona oznaczana jako wycofana.
  • Gdy zamyka ją ktoś inny, jest oznaczana jako odrzucona.
  • Zarchiwizowanie gałęzi źródłowej automatycznie zamyka każdą otwartą propozycję z niej lub do niej, oznaczoną jako branch_archived.

Propozycje scalania i ElevenAgents Architect

Architect może otwierać propozycje scalania za ciebie. Po wprowadzeniu i przetestowaniu zmiany w gałęzi odczytuje commity gałęzi oraz podgląd scalenia i otwiera propozycję z sekcjami Podsumowanie, Testowanie i Jak sprawdzić. Może też zasugerować recenzentów do wyboru. Ponieważ Architect działa w twoim imieniu, propozycja wskazuje ciebie jako autora.

Architect nie może sprawdzać, zatwierdzać, scalać ani zamykać propozycji. Te kroki zawsze wykonują ludzie. Pełny proces znajdziesz w Propozycjach i walidacji.

Kolejne kroki