Verwende Bob, um einen Branch zu erstellen, Änderungen zu stagen, eine Commit-Message zu generieren, in dein Repository zu pushen und einen Pull Request zu öffnen.

Bob hat integrierte Unterstützung für die Git-Versionskontrolle und ermöglicht es dir, deine Code-Änderungen zu verwalten, ohne die IDE zu verlassen.

In diesem Tutorial verwendest du Bob, um einen Branch zu erstellen, Code-Änderungen zu stagen, eine beschreibende Commit-Message zu generieren, die Änderungen in dein Repository zu pushen und einen Pull Request zu öffnen, den du prüfen und mergen kannst.

Voraussetzungen

IBM Bob IDE

Lade die IBM Bob-Anwendung herunter und installiere sie auf deinem Computer. Bob ist eine eigenständige IDE-Anwendung und keine Erweiterung.

Git

Installiere Git, um das Beispiel-Repository zu klonen.

GitHub

Ein GitHub-Konto und ein Fork des Galaxium Travels Beispiel-Repositorys. Um den Fork zu erstellen, folge GitHubs Dokumentation zum Forken eines Repositorys. Konfiguriere Git mit Zugangsdaten, die in deinen Fork pushen können.

GitHub SSH-Authentifizierung

Generiere einen SSH-Key und füge ihn dem ssh-agent hinzu, damit du über SSH in deinen Fork pushen kannst.

Projekt einrichten

Bereite eine Arbeitskopie des Repositorys vor.

Repository forken

Du arbeitest mit einem Fork des Galaxium Travels-Repositorys.

Gehe zum Galaxium Travels-Repository auf GitHub.
Klicke oben rechts auf der Seite auf die Schaltfläche Fork.
Wähle dein GitHub-Konto als Eigentümer des Forks aus.

Weitere Informationen zum Forken eines Repositorys findest du in GitHubs Dokumentation zum Forken eines Repositorys.

Repository klonen

Klone in einem Terminal das geforkte Galaxium Travels-Repository. Ersetze <your-id> durch deinen GitHub-Benutzernamen im folgenden Befehl:
```
git clone git@github.com:<YOUR_ID>/galaxium-travels.git
```

Wenn du einen Authentifizierungsfehler erhältst, stelle sicher, dass du deinen SSH-Key zum ssh-agent hinzugefügt hast. Weitere Informationen findest du in der GitHub-Dokumentation.

Klicke in Bob auf Datei und dann auf Ordner öffnen.
Navigiere zum galaxium-travels-Verzeichnis, das du gerade geklont hast, und öffne es.

In den Agent-Modus wechseln

Falls das Bob Chat-Interface noch nicht geöffnet ist, öffne es, indem du auf das Bob-Symbol neben der Navigationsleiste klickst oder die Tastenkombination Option + Command + B (Mac) oder Ctrl + Alt + B (Windows) verwendest.

Bob-Chat-Panel in IBM Bob IDE geöffnet

Verwende den Agent-Modus, damit Bob Code schreiben und ändern, Git-Befehle ausführen und dich durch den Workflow führen kann. Bob fragt dennoch vor jeder Operation um Erlaubnis, sofern nicht explizit erlaubt.

Klicke auf das Moduswähler-Dropdown im agentischen Chat und wähle Agent, oder tippe /agent im Chat.

Branch erstellen

Bevor du Änderungen vornimmst, erstelle einen Feature-Branch, damit deine Arbeit von main getrennt bleibt.

Führe den folgenden Prompt aus:

Erstelle einen neuen Branch namens update-header und wechsle zu ihm.

Bob fordert die Erlaubnis an, git checkout -b update-header auszuführen.

Klicke auf Für Task genehmigen, um den Branch zu erstellen und zu ihm zu wechseln.

Eine Code-Änderung vornehmen

Nimm eine kleine Änderung vor, damit Bob etwas zum Committen hat.

Die Header-Komponente öffnen

Öffne im Galaxium Travels-Codebase die Datei booking_system_frontend/src/components/layout/Header.tsx.

Den Header-Text bearbeiten

Bitte Bob, die Änderung von Galaxium Travels zu Galaxium Travel Agency vorzunehmen. Das @-Präfix fügt eine Datei zu Bobs Kontext hinzu, sodass er genau weiß, welche Datei er bearbeiten soll.

Ändere den Namen im Header von `Galaxium Travels` zu `Galaxium Travel Agency`
in @booking_system_frontend/src/components/layout/Header.tsx

Alternativ kannst du die Datei manuell bearbeiten und Galaxium Travels zu Galaxium Travel Agency ändern.

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

Den Git-Workflow ausführen

Verwende Bob, um deine Änderungen zu stagen, zu committen, zu pushen und dann einen Pull Request zu öffnen.

Änderungen stagen

Führe den folgenden Prompt aus, um deine Änderungen zu stagen:

Stage alle Änderungen, die ich für das Header-Komponenten-Update vorgenommen habe.

Bob prüft den Working Tree, identifiziert die geänderten Dateien und fordert die Erlaubnis an, git add auszuführen.

Klicke auf Für Task genehmigen, um Bob die Ausführung des Befehls zu erlauben.

Änderungen committen

Führe den folgenden Prompt aus, um die gestagten Änderungen zu committen:

Committe die gestagten Änderungen mit einer beschreibenden Commit-Message, die zusammenfasst, was hinzugefügt wurde.

Bob prüft den gestagten Diff und generiert eine Commit-Message, die den Zweck und Umfang der Änderungen beschreibt.

Bob zeigt in der IDE einen Berechtigungs-Prompt an, um Execute-Befehle auszuführen.

Klicke auf Ich verstehe die Risiken und dann auf Genehmigen, damit Bob git commit ausführen kann.

Änderungen pushen

Führe den folgenden Prompt aus, um deinen Commit in das Remote-Repository zu pushen:

Pushe meine Änderungen in das Remote-Repository.

Bob identifiziert den aktuellen Branch und das Remote und fordert dann die Erlaubnis an, git push auszuführen.

Klicke auf Für Task genehmigen, um den Commit zu pushen. Bob bestätigt im Chat-Verlauf, dass der Push erfolgreich war.

Einen Pull Request öffnen

Führe den folgenden Prompt aus, um einen Pull Request zu erstellen:

Erstelle einen Pull Request, um meine Änderungen in den main-Branch zu mergen. Schreibe einen klaren Titel und eine Beschreibung basierend darauf, was geändert wurde.

Bob benötigt beim ersten Erstellen eines Pull Requests eine GitHub-Authentifizierung. Bob öffnet ein Browserfenster, in dem du den Zugriff autorisieren kannst. Nach der Autorisierung öffnet Bob den Pull Request. Klicke auf den bereitgestellten Link, um den Pull Request in deinem Browser aufzurufen. Klicke nach der Überprüfung von Titel und Beschreibung auf Pull Request erstellen.

Bob gibt die Pull-Request-URL zurück, damit du ihn direkt über deinen Browser überprüfen, teilen oder mergen kannst.

Damit Bob Pull Requests ohne Bestätigungsfenster erstellt, installiere die GitHub CLI und bitte Bob, diese zum Erstellen von Pull Requests zu verwenden.

Fehlerbehebung

Push abgelehnt oder Authentifizierung fehlgeschlagen: Stelle sicher, dass Git mit Zugangsdaten konfiguriert ist, die in deinen Fork pushen können.

Branch update-header existiert bereits: Bitte Bob, zum vorhandenen Branch zu wechseln, oder wähle einen anderen Branch-Namen.

Pull Request zielt auf IBM/galaxium-travels: Ändere das Basis-Repository auf deinen Fork, bevor du den Pull Request erstellst.

Aufräumen

Nach Abschluss dieses Tutorials kannst du die erstellten Ressourcen entfernen:

Wechsle deinen lokalen Klon zurück zum main-Branch.

Schließe oder merge den Pull Request auf GitHub.

Lösche den Branch update-header aus deinem Fork.

Lösche deinen Fork von Galaxium Travels, wenn du ihn nicht mehr benötigst.

Nächste Schritte

In diesem Tutorial hast du gelernt, wie du Bobs native Git-Integration verwendest, um deine Code-Änderungen zu verwalten, ohne die IDE zu verlassen.

Gehe weiter zu Bobs Verhalten standardisieren, um zu erfahren, wie du dauerhafte Regeln definierst, die Bobs Verhalten in jeder Konversation und jedem Modus steuern.

Einen Commit und Pull Request mit Bob erstellen