Führe den Bob Shell-Befehl /init aus, um AGENTS.md zu generieren – eine Projektkontext-Datei, die Bob in jeder Konversation lädt – und lerne, diesen Kontext aktuell zu halten.

Der Befehl /init durchsucht ein Projekt und generiert eine strukturierte Zusammenfassungsdatei namens AGENTS.md, die Bob als dauerhaften Kontext in jeder Konversation verwendet. Mit /init gibst du Bob Wissen über die Struktur, Konventionen und Codebasis eines Projekts – ohne dass Bob bei jedem neuen Gespräch alle Dateien neu einlesen muss.

Große Sprachmodelle sind zustandslos. Jede neue Konversation beginnt ohne Erinnerung an frühere Interaktionen. Ohne expliziten Projektkontext muss Bob die Codebasis bei jeder neuen Interaktion neu erkunden, was ineffizient ist und bei größeren Projekten unpraktisch wird.

In diesem Tutorial initialisierst du Bob Shell im Stammverzeichnis einer Demo-Anwendung, erkundest den Kontext, den Bob über die Anwendung gewinnt, und lernst, wie Bob Shell AGENTS.md-Dateien lädt.

Voraussetzungen

Für dieses Tutorial benötigst du Folgendes:

Bob Shell

Installiere Bob Shell v2.x oder neuer und melde dich an.

Git

Installiere Git, um das Beispiel-Repository zu klonen.

Falls du es noch nicht hast, klone den Galaxium Travels-Demo-Code. Der Clone-Befehl checkt auch den Branch bob-learning-path-branch aus, der den Code enthält, den du in den Tutorials verwendest.

git clone -b bob-learning-path-branch https://github.com/IBM/galaxium-travels

Obwohl nicht zwingend erforderlich, empfiehlt es sich, Eine interaktive Sitzung starten zu lesen, um dich mit der Oberfläche und den Funktionen von Bob Shell vertraut zu machen.

Bob Shell im Projekt starten

Wechsle in das Stammverzeichnis von Galaxium Travels:

cd galaxium-travels

Starte eine interaktive Sitzung:

bob chat --mode agent

Das Flag --mode agent startet die Sitzung im Agent-Modus, der die Tools hat, die Bob braucht, um Dateien zu lesen und AGENTS.md zu schreiben.

Wenn Bob Shell fragt, ob du dem Ordner vertraust, vertraue ihm, damit Bob im Projekt arbeiten kann. Weitere Informationen findest du unter Vertrauenswürdige Ordner.

AGENTS.md mit /init generieren

Gib den Befehl /init an der Eingabeaufforderung ein:

/init

Bob liest die relevanten Dateien im Projekt.

Wenn Bob darum bittet, ein Tool zu verwenden – z. B. Dateien zu lesen oder AGENTS.md zu schreiben – erscheint der Genehmigungsdialog. Wähle Approve für jede Anfrage.

Bob generiert die Haupt-AGENTS.md-Datei im Stammverzeichnis von Galaxium Travels. Außerdem generiert er moduspezifische Kontextdateien in .bob/rules-agent/AGENTS.md, .bob/rules-ask/AGENTS.md und .bob/rules-plan/AGENTS.md.

AGENTS.md-Dateien erkunden

Die Datei AGENTS.md ist Einarbeitungsdokumentation für Bob. Sie ist eine prägnante, handlungsorientierte Zusammenfassung, die Bob alles bietet, was er braucht, um die Struktur und Konventionen des Projekts zu verstehen.

Bitte Bob, die Datei anzuzeigen:

Show me the contents of @AGENTS.md

Das @-Symbol referenziert eine Datei in deinem Projekt, sodass Bob sie vor der Antwort liest. Du kannst auch ein weiteres Terminal öffnen und die Datei direkt anzeigen:

cat AGENTS.md

Die Datei AGENTS.md enthält typischerweise folgende Bestandteile:

Projektübersicht und Zweck

Verzeichnisstruktur und wichtige Dateispeicherorte

Technologie-Stack und Abhängigkeiten

Architekturmuster und Konventionen

Entwicklungs-Workflows

Um alle von /init erstellten Dateien zu sehen, führe git status im Galaxium Travels-Verzeichnis aus:

git status

Wie Bob Shell AGENTS.md-Dateien lädt

Bob Shell lädt automatisch Kontextdateien wie AGENTS.md am Anfang jeder Aufgabe.

Globaler Kontext: ~/.bob/AGENTS.md gilt für alle Projekte.

Projektkontext: AGENTS.md im Projektstammverzeichnis und übergeordneten Verzeichnissen gilt für das Projekt.

Lokaler Kontext: AGENTS.md in Unterverzeichnissen gilt für dieses Unterverzeichnis, für komponentenspezifische Anweisungen.

Um Bob Anweisungen für einen einzelnen Modus zu geben, füge moduspezifische Regeln in .bob/rules-<mode>/-Verzeichnissen hinzu, z. B. .bob/rules-plan/ für den Plan-Modus.

Die AGENTS.md-Dateien pflegen

Führe /init nach folgenden Änderungen erneut aus:

Hinzufügen neuer Module oder Services

Ändern der Verzeichnisstruktur

Einführen neuer Technologien oder Frameworks

Onboarding neuer Teammitglieder, die Bob verwenden

Du kannst AGENTS.md auch manuell bearbeiten, um Kontext hinzuzufügen, den Bobs automatischer Scan möglicherweise nicht erfasst, z. B. Geschäftsregeln, Deployment-Konventionen oder teaminterne Praktiken. Committe AGENTS.md in die Versionsverwaltung, damit dein Team denselben Kontext teilt.

Nächste Schritte

In diesem Tutorial hast du Folgendes gelernt:

Große Sprachmodelle sind zustandslos. Der /init-Befehl löst dieses Problem, indem er AGENTS.md generiert – eine persistente Kontextdatei, die Bob am Anfang jeder Konversation liest.

Führe /init nach größeren Projektänderungen erneut aus, um den Kontext aktuell zu halten.

Fahre fort mit Effektive Prompts für Bob Shell schreiben, um zu lernen, wie du Prompts schreibst, die zuverlässig die gewünschten Ergebnisse liefern.

Ein Projekt mit /init und AGENTS.md in Bob Shell starten