Tutorials

Bobs Verhalten standardisieren

Standardisieren Sie Bobs Verhalten in Ihrem Team mithilfe von Regeldateien auf Projektebene, die Bob anweisen, seinen Code zu dokumentieren und sich an seine vorherigen Aktionen zu erinnern.

Bob Regeln sind einfache Textdateien, die Anweisungen definieren, die auf jede Bob-Konversation angewendet werden. Bob speichert Regeln als Dateien in einem bestimmten Ordner innerhalb des Projekts oder auf globaler Benutzerebene und fügt den Inhalt jeder Regeldatei automatisch in jede Konversation über alle Modi hinzu. Die Regelinjektion ermöglicht es Teams und einzelnen Entwicklern, Codierungsstandards, Kommunikationspräferenzen und Workflow-Einschränkungen durchzusetzen, ohne Anweisungen in jeder Eingabeaufforderung zu wiederholen.

Regeln auf Projektebene in galaxium-travels/.bob werden zusammen mit Ihrem Code versionskontrolliert, was bedeutet:

  • Regeln werden automatisch an alle Teammitglieder weitergegeben, die das Repository klonen.
  • Änderungen an Regeln durchlaufen den normalen Code-Review-Prozess.
  • Der Regelverlauf wird in Git verfolgt.

In diesem Tutorial weisen Sie Bob an, prägnant zu sprechen, seinen Code zu dokumentieren und sich an seine vorherigen Aktionen zu erinnern, indem Sie Regeldateien im .bob-Verzeichnis hinzufügen. Da Sie diese Dateien in die Versionskontrolle aufnehmen, wird Bob sie in Ihrem gesamten Team anwenden.

Voraussetzungen

Um dieses Tutorial abzuschließen, benötigen Sie Folgendes:

  • Falls Sie ihn noch nicht haben, klonen Sie den Galaxium Travels Demo-Code. Der Klonbefehl checkt auch den bob-learning-path-branch aus, der den Code enthält, den Sie in den Tutorials verwenden.
git clone -b bob-learning-path-branch https://github.com/IBM/galaxium-travels
  • Bob IDE mit geöffnetem Galaxium Travels Demo-Code
  • Schließen Sie das Tutorial Projekt starten ab, um den .bob-Ordner zu erstellen.
  • Obwohl nicht erforderlich, sollten Sie das Schnellstart-Tutorial durchführen, um sich mit Bobs Benutzeroberfläche und Funktionen vertraut zu machen.
  • Python oder Python 3. Sie können Python von der offiziellen Website herunterladen.

Eine benutzerdefinierte Bob-Regeldatei erstellen

Der Bob /init-Befehl erstellt einen .bob-Ordner mit AGENTS.md-Dateien für jeden Bob-Modus, die das Verhalten von Bob in jedem Modus steuern. Erstellen Sie Ihre eigenen benutzerdefinierten Regeln, indem Sie eine neue Datei zum rules-Ordner hinzufügen. Bob liest den Inhalt der Regeldatei, was bedeutet, dass die von Ihnen hinzugefügten Anweisungen für alle Interaktionen mit Bob gelten.

Den Regelordner erstellen

Wenn im .bob-Verzeichnis noch kein rules-Ordner vorhanden ist, erstellen Sie einen.

Die Regeldatei erstellen

Erstellen Sie eine Datei in galaxium-travels/.bob/rules/ mit dem Namen basic_rules.md.

Die im Projekt erstellte Datei .bob/rules/basic_rules.md

Benutzerdefinierte Bob-Regeln erstellen

Erstellen Sie in der Datei basic_rules.md benutzerdefinierte Regeln, indem Sie den folgenden Text hinzufügen:

Eine Dokumentationsstandardregel hinzufügen

Always include concise JSDoc strings for every public function.

Die Dokumentationsstandardregel stellt sicher, dass Bob konsistente Dokumentation generiert, wenn Bob öffentliche Funktionen schreibt oder ändert, unabhängig von der Aufgabe.

Eine Kommunikationsstilregel hinzufügen

Be very concise in your wording.

Die Kommunikationsstilregel steuert, wie Bob Antworten und Kommentare formuliert, was für Teams nützlich ist, die knappe, direkte Ausgaben gegenüber detaillierten Erklärungen bevorzugen.

Eine interne Monologregel hinzufügen

Write a summary of every interaction into the folder `internal-monologue/`.
Name the file starting with a timestamp, followed by a concise description of the interaction.
Example: 2026-01-15_update-readme.md

Der interne Monolog erzeugt ein dauerhaftes Protokoll von allem, was Bob über alle Konversationen hinweg getan hat.

Die Vorteile des internen Monologs umfassen Folgendes:

  • Prüfpfad: Eine Aufzeichnung darüber, welche Änderungen Bob vorgenommen hat und wann.
  • Sitzungsübergreifende Kontinuität: Bob kann in zukünftigen Konversationen auf den internen Monologordner verweisen, um frühere Arbeiten zu verstehen.
  • Team-Transparenz: In gemeinsam genutzten Repositories zeigt der Monolog, was verschiedene Teammitglieder mit Bob gemacht haben.

Sobald Sie alle Regeln hinzugefügt haben, sieht Ihre basic_rules.md-Datei wie folgt aus:

Die Datei basic_rules.md mit allen drei hinzugefügten benutzerdefinierten Regeln

Die Regeln testen

Öffnen Sie die Agentic-Chat-Seitenleiste, wechseln Sie zum Code-Modus und führen Sie die folgende Eingabeaufforderung aus, damit Bob die README.md bearbeitet. Bob kann Vorschläge machen wie bessere Fehlerbehebung, vollständige Überarbeitung oder Ungenauigkeiten beheben. Sie können den Vorschlag auswählen, der am besten zu Ihrer Vision für die README passt.

Update the readme

Bob aktualisiert die README.md und erstellt einen Ordner namens internal-monologue sowie eine Datei, die Ihnen die Aktualisierungen zeigt, die er an der README vorgenommen hat.

Bob aktualisiert die README.md und erstellt eine interne Monologdatei

Nächste Schritte

In diesem Tutorial haben Sie gelernt, wie Bob-Regeln es Ihnen ermöglichen, dauerhafte Anweisungen zu definieren, die für jede Konversation und jeden Modus gelten. Regeln auf Projektebene werden zusammen mit Ihrem Code versionskontrolliert, sodass Ihr Team automatisch dieselben Standards teilt. Das interne Monologmuster gibt Ihnen einen Prüfpfad der Aktionen von Bob über alle Sitzungen hinweg.

Fahren Sie mit Bob-Funktionen hinzufügen fort, um zu erfahren, wie Sie benutzerdefinierte Modi erstellen, die spezialisierte Personas mit maßgeschneiderten Anweisungen und spezifischem Werkzeugzugriff definieren.

Wie ist dieses Thema?