Samouczki

Tworzenie commitu i pull request z Bobem

Użyj Boba, aby utworzyć branch, przygotować zmiany, wygenerować wiadomość commitu, wypchnąć zmiany do repozytorium i otworzyć pull request.

Bob ma wbudowaną obsługę kontroli wersji Git i pozwala zarządzać zmianami w kodzie bez opuszczania IDE.

W tym samouczku używasz Boba, aby utworzyć branch, przygotować zmiany kodu, wygenerować opisową wiadomość commitu, wypchnąć zmiany do repozytorium i otworzyć pull request, który możesz przejrzeć i scalić.

Wymagania wstępne

Konfiguracja projektu

Przygotuj kopię roboczą repozytorium.

Forkowanie repozytorium

Będziesz pracować z forka repozytorium Galaxium Travels.

  1. Przejdź do repozytorium Galaxium Travels na GitHub.
  2. Kliknij przycisk Fork w prawym górnym rogu strony.
  3. Wybierz swoje konto GitHub jako właściciela forka.

Aby dowiedzieć się więcej o forkowaniu repozytorium, zapoznaj się z dokumentacją GitHub dotyczącą forkowania repozytorium.

Klonowanie repozytorium

  1. W terminalu sklonuj sforkowane repozytorium Galaxium Travels. Zastąp <your-id> swoją nazwą użytkownika GitHub w następującym poleceniu:

    git clone git@github.com:<YOUR_ID>/galaxium-travels.git

Jeśli wystąpi błąd uwierzytelniania, upewnij się, że dodałeś klucz SSH do ssh-agent. Więcej informacji znajdziesz w dokumentacji GitHub.

  1. W Bobie kliknij Plik, a następnie Otwórz folder.

  2. Przejdź do katalogu galaxium-travels, który właśnie sklonowałeś, i otwórz go.

Przełączenie na tryb Agent

Jeśli interfejs czatu Boba nie jest jeszcze otwarty, otwórz go, klikając ikonę Boba obok paska nawigacji lub używając skrótu Option + Command + B (Mac) lub Ctrl + Alt + B (Windows).

Panel czatu Boba otwarty w IBM Bob IDE

Użyj trybu Agent, aby Bob mógł pisać i modyfikować kod, uruchamiać polecenia Git i prowadzić cię przez workflow. Bob nadal prosi o pozwolenie przed każdą operacją, chyba że jest to wyraźnie dozwolone.

Kliknij menu rozwijane selektora trybu w czacie agentowym i wybierz Agent lub wpisz /agent w czacie.

Tworzenie brancha

Przed wprowadzeniem zmian utwórz branch feature, aby praca była oddzielona od main.

Uruchom następujący prompt:

Utwórz nowy branch o nazwie update-header i przełącz się na niego.

Bob prosi o pozwolenie na uruchomienie git checkout -b update-header.

Kliknij Zatwierdź dla zadania, aby utworzyć branch i przełączyć się na niego.

Wprowadzenie zmiany w kodzie

Wprowadź małą zmianę, żeby Bob miał co commitować.

Otwarcie komponentu Header

W codebase Galaxium Travels otwórz booking_system_frontend/src/components/layout/Header.tsx.

Edycja tekstu nagłówka

Poproś Boba o zmianę Galaxium Travels na Galaxium Travel Agency. Prefiks @ dodaje plik do kontekstu Boba, żeby wiedział dokładnie, który plik edytować.

Zmień nazwę nagłówka z `Galaxium Travels` na `Galaxium Travel Agency`
w @booking_system_frontend/src/components/layout/Header.tsx

Alternatywnie możesz ręcznie edytować plik i zmienić Galaxium Travels na Galaxium Travel Agency.

<span className="text-2xl font-bold bg-cosmic-gradient bg-clip-text text-transparent">
    Galaxium Travel Agency
</span>

Uruchomienie workflow Git

Użyj Boba do przygotowania, commitowania, wypychania zmian i otwierania pull request.

Przygotowanie zmian

Uruchom następujący prompt, aby przygotować zmiany:

Przygotuj wszystkie zmiany, które zrobiłem dla aktualizacji komponentu header.

Bob sprawdza drzewo robocze, identyfikuje zmodyfikowane pliki i prosi o pozwolenie na uruchomienie git add.

Kliknij Zatwierdź dla zadania, aby pozwolić Bobowi uruchomić polecenie.

Commitowanie zmian

Uruchom następujący prompt, aby commitować przygotowane zmiany:

Commituj przygotowane zmiany z opisową wiadomością commitu, która podsumowuje co zostało dodane.

Bob przegląda przygotowany diff i generuje wiadomość commitu opisującą cel i zakres zmian.

Bob wyświetla w IDE monit o pozwolenie na uruchomienie poleceń Execute.

Kliknij Rozumiem ryzyko, a następnie kliknij Zatwierdź, aby Bob mógł uruchomić git commit.

Wypychanie zmian

Uruchom następujący prompt, aby wypchnąć commit do zdalnego repozytorium:

Wypchnij moje zmiany do zdalnego repozytorium.

Bob identyfikuje bieżący branch i zdalne repozytorium, a następnie prosi o pozwolenie na uruchomienie git push.

Kliknij Zatwierdź dla zadania, aby wypchnąć commit. Bob potwierdza w historii czatu, że wypychanie się powiodło.

Otwieranie pull request

Uruchom następujący prompt, aby utworzyć pull request:

Utwórz pull request, aby scalić moje zmiany z branchem main. Napisz jasny tytuł i opis na podstawie tego, co zostało zmienione.

Bob wymaga uwierzytelnienia GitHub przy pierwszym tworzeniu pull request. Bob otwiera okno przeglądarki, aby autoryzować dostęp. Po autoryzacji Bob otwiera pull request. Kliknij podany link, aby uzyskać dostęp do pull request w przeglądarce. Po sprawdzeniu tytułu i opisu kliknij Utwórz pull request.

Bob zwraca URL pull request, abyś mógł go przejrzeć, udostępnić lub scalić bezpośrednio z przeglądarki.

Aby Bob tworzył pull requesty bez okna potwierdzenia, zainstaluj GitHub CLI i poproś Boba o używanie go do tworzenia pull requestów.

Rozwiązywanie problemów

  • Wypychanie odrzucone lub uwierzytelnianie nie powiodło się: Potwierdź, że Git jest skonfigurowany z poświadczeniami, które mogą wypychać do twojego forka.
  • Branch update-header już istnieje: Poproś Boba o przełączenie się na istniejący branch lub wybierz inną nazwę brancha.
  • Pull request celuje w IBM/galaxium-travels: Zmień bazowe repozytorium na swój fork przed utworzeniem pull request.

Czyszczenie

Po ukończeniu tego samouczka możesz usunąć utworzone zasoby:

  • Przełącz lokalny klon z powrotem na branch main.
  • Zamknij lub scal pull request na GitHub.
  • Usuń branch update-header ze swojego forka.
  • Usuń fork Galaxium Travels, jeśli nie jest już potrzebny.

Następne kroki

W tym samouczku nauczyłeś się używać natywnej integracji Git Boba do zarządzania zmianami kodu bez opuszczania IDE.

Przejdź do Standaryzacja zachowania Boba, aby dowiedzieć się, jak definiować trwałe reguły kontrolujące zachowanie Boba w każdej rozmowie i trybie.

Jak oceniasz ten temat?