Ein Projekt mit /init und AGENTS.md starten
Geben Sie Bob mit /init persistenten Projektkontext über Konversationen und Modi hinweg, der automatisch AGENTS.md-Dateien generiert.
Der /init-Befehl scannt ein Projekt und generiert eine strukturierte Zusammenfassungsdatei namens AGENTS.md, die Bob als persistenten Kontext in jeder Konversation verwendet. Der /init-Befehl ist die Methode, mit der Sie Bob Wissen über die Struktur, Konventionen und Codebasis eines Projekts vermitteln, ohne dass Bob bei jeder neuen Interaktion jede Datei erneut lesen muss.
Große Sprachmodelle sind zustandslos. Jede neue Konversation beginnt ohne Erinnerung an vorherige Interaktionen. Ohne expliziten Projektkontext muss Bob bei jeder neuen Interaktion die Codebasis neu entdecken, was ineffizient ist und im großen Maßstab unpraktisch wird.
In diesem Tutorial initialisieren Sie Bob im Stammverzeichnis einer Demo-Anwendung, erkunden den Kontext, den Bob über die Anwendung erhält, und lernen die Struktur von Bob für modusspezifischen Kontext kennen.
Voraussetzungen
Um dieses Tutorial abzuschließen, benötigen Sie Folgendes:
- Falls Sie es noch nicht haben, klonen Sie den Galaxium Travels Demo-Code. Der Clone-Befehl checkt auch den
bob-learning-path-branchaus, 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
- Obwohl nicht erforderlich, sollten Sie in Erwägung ziehen, das Quickstart-Tutorial durchzuführen, um sich mit Bobs Benutzeroberfläche und Funktionen vertraut zu machen.
/init ausführen
Um den Projektkontext zu initialisieren, navigieren Sie zur Hallo, ich bin Bob-Chat-Oberfläche in der Bob IDE. Wechseln Sie unten in der Seitenleiste zum Agent-Modus.
Geben Sie den /init-Befehl in der Chat-Oberfläche ein. Wenn Sie die automatische Genehmigung deaktiviert haben, fragt Bob um Erlaubnis, Dateien zu lesen und die AGENTS.md-Dateien zu schreiben.
/init
Bob liest die relevanten Dateien im Projekt. Bob generiert dann die Haupt-AGENTS.md-Datei im Galaxium Travels-Stammverzeichnis. Bob erstellt auch einen .bob-Ordner, der eine AGENTS.md für jeden Modus enthält.
AGENTS.md-Dateien erkunden
Die AGENTS.md-Dateien funktionieren wie Onboarding-Dokumentation für Bob. AGENTS.md ist eine prägnante, umsetzbare Zusammenfassung, die alles bietet, was Bob benötigt, um die Struktur und Konventionen des Projekts zu verstehen.
Sie finden die Haupt-AGENTS.md-Datei am unteren Rand des Bob-Datei-Explorers auf der linken Seite. Öffnen Sie die Datei, um ihren Inhalt zu lesen.
Die AGENTS.md-Datei enthält typischerweise die folgenden Komponenten:
- Projektübersicht und Zweck
- Verzeichnisstruktur und wichtige Dateispeicherorte
- Technologie-Stack und Abhängigkeiten
- Architekturmuster und Konventionen
- Entwicklungsworkflows
Bob wendet die AGENTS.md automatisch auf neue Konversationen an und lernt den Projektkontext.
Modusspezifische AGENTS.md-Dateien
Zusätzlich zur Haupt-AGENTS.md im Galaxium Travels-Stammverzeichnis generiert /init modusspezifische Kontextdateien im .bob-Ordner für jeden integrierten Modus:
| Datei | Modus |
|---|---|
.bob/rules-code/AGENTS-code.md | Agent-Modus |
.bob/rules-plan/AGENTS-plan.md | Plan-Modus |
.bob/rules-ask/AGENTS-ask.md | Ask-Modus |
Der Plan-Modus-Kontext betont Architekturkonventionen, während der Code-Modus-Kontext Dateistruktur und Benennungsmuster hervorhebt.
Die AGENTS.md-Dateien pflegen
Führen Sie /init erneut aus, nachdem Sie die folgenden Projektanpassungen vorgenommen haben:
- Hinzufügen neuer Module oder Services
- Ändern der Verzeichnisstruktur
- Einführung neuer Technologien oder Frameworks
- Onboarding neuer Teammitglieder, die Bob verwenden werden
Sie können die AGENTS.md auch manuell bearbeiten, um Kontext hinzuzufügen, den Bobs automatisierter Scan möglicherweise nicht erfasst, wie z.B. Geschäftsregeln, Deployment-Konventionen oder teamspezifische Praktiken.
Nächste Schritte
In diesem Tutorial haben Sie Folgendes gelernt:
- Große Sprachmodelle sind zustandslos. Das Ausführen des
/init-Befehls löst dieses Problem, indemAGENTS.mdgeneriert wird – eine persistente Kontextdatei, die Bob zu Beginn jeder Konversation liest. - Die modusspezifischen
AGENTS.md-Dateien liefern gezielten Kontext für Agent-, Plan- und Ask-Modus. - Führen Sie
/initnach größeren Projektänderungen erneut aus, um den Kontext aktuell zu halten.