Knowledge Base
gamedev pkg add aigd.knowledgeÜbersicht
Die Knowledge Base des Projekts: Markdown-Notizen in .ai-game-dev/knowledge/, mit dem Projekt committet, als Graph indexiert und vom Agenten durchsuchbar. Der Agent hält Designentscheidungen und Konventionen fest, organisiert Notizen in Spaces, korrigiert Links beim Verschieben und findet defekte Links; die Desktop-App zeigt die Notizen als 3D-Graph.
Die Knowledge Base des Projekts für den Agenten von AI Game Dev: Markdown-Notizen in .ai-game-dev/knowledge/, mit dem Projekt committet und über git mit dem Team geteilt. Das Paket indexiert die Notizen und ihre Links als Graph, gibt dem Agenten Werkzeuge zum Durchstöbern, Suchen, Verlinken und Organisieren und zeigt den Graphen in einem 3D-Fenster. Es passt zu Spielteams, die Designentscheidungen, Konventionen und die Funktionsweise ihrer Systeme dort festhalten wollen, wo sowohl Menschen als auch der Agent sie finden.
Was du tun kannst
- Lass den Agenten Designentscheidungen samt Begründung, Konventionen und nicht offensichtliche Stolperfallen während der Arbeit im passenden Themen-Space festhalten.
- Frag den Agenten, was das Team zu einem System entschieden hat; er kann die Notizen durchsuchen, um zu antworten.
- Ordne Notizen in Spaces (Ordner mit einer
README.md) und verschiebe oder benenne Notizen und Ordner um, ohne Links zu brechen. - Finde defekte Links und verwaiste Notizen und sieh im Graph, wie alles zusammenhängt.
- Durchstöbere die Notizen selbst im 3D-Graph-Fenster oder in der Vorschau im Seitenpanel der Desktop-App.
Beispielanfragen
- "Halte fest, dass wir für das Kampfsystem einen festen Physik-Schritt von 60 Hz gewählt haben, und warum."
- "Was sagt die Knowledge Base zu unserem Speicherformat?"
- "Erstelle einen Space für das Inventarsystem und verschiebe die Item-Notizen hinein."
- "Prüfe die Knowledge Base auf defekte Links und repariere sie."
/kb systems(die Summen und defekten Links der Knowledge Base, mit dem Baum des Spacesystems)
So funktioniert es
Die Notizen sind einfache Markdown-Dateien unter <project>/.ai-game-dev/knowledge/ und liegen damit in der Versionsverwaltung neben deinem Spiel. Ein Space ist ein Ordner mit einer README.md: einem # Title, dann eine Beschreibung in einem Absatz. Notizen verlinken sich gegenseitig mit Pfaden ab dem Wurzelverzeichnis der Knowledge Base, zum Beispiel [Combat](/systems/combat.md); auch relative Links und Wikilinks ([[Combat]]) werden indexiert.
Der Agent sieht die Liste der Spaces der obersten Ebene in seinen Instruktionen und arbeitet sich Space für Space nach unten. Notizen liest und schreibt er mit seinen normalen Dateiwerkzeugen; für den Rest nutzt er diese Werkzeuge:
| Werkzeug | Was es macht |
|---|---|
kb_space_get | Einen Space öffnen: seine Beschreibung, untergeordnete Spaces und Notizen. |
kb_space_create | Einen Space erstellen: ein Ordner mit einer README.md (Titel und Beschreibung). |
kb_search | Gewichtete Suche in Notizen nach Titel, Pfad und Text, mit Textausschnitten. |
kb_links | Ausgehende Links, Backlinks und defekte Links einer Notiz oder aller Notizen in einem Ordner. |
kb_move | Eine Notiz oder einen Ordner verschieben oder umbenennen und jeden Link darauf umschreiben. |
kb_lint | Defekte Links, verwaiste Notizen, Konventionsprobleme und Hinweise. |
Dem Agenten wird vorgegeben, nur wichtiges, dauerhaftes Wissen festzuhalten (Entscheidungen samt Begründung, Konventionen, die Funktionsweise eines Systems, nicht offensichtliche Stolperfallen), zuerst zu suchen und eine vorhandene Notiz zu aktualisieren statt sie zu duplizieren, und jede Aussage auf das zu stützen, was du gesagt hast oder was der Code zeigt.
Das Paket bringt mit:
- die Fähigkeit Knowledge Base, standardmäßig aktiv;
- den Befehl
/kb [folder or note](CLI und Desktop): Notizen, Ordner, Links, defekte Links und Waisen, dann der Baum; - in der Desktop-App das 3D-Graph-Fenster (über die Statusleiste, das Werkzeugmenü der Session oder "Im Knowledge-Base-Graph öffnen" bei einer Notiz oder einem Ordner im Datei-Explorer), eine Knowledge-Base-Ansicht im rechten Panel und einen Hinweis, der darauf verweist. Der Graph aktualisiert sich live, während der Agent Notizen schreibt.
Voraussetzungen
- AI Game Dev 0.25.11 oder neuer. Das Graph-Fenster und das Seitenpanel sind Teil der Desktop-App.
- Ein Projektordner;
git, um die Notizen mit deinem Team zu teilen.
Lizenz
Apache-2.0.
Versionen
| Version | Veröffentlicht | Benötigt die App |
|---|---|---|
| 0.3.22Neueste | 0.25.11 oder neuer | |
| 0.3.21 | 0.25.11 oder neuer | |
| 0.3.20 | 0.25.11 oder neuer | |
| 0.3.19 | 0.25.11 oder neuer | |
| 0.3.18 | 0.25.11 oder neuer | |
| 0.3.17 | 0.25.11 oder neuer | |
| 0.3.16 | 0.25.11 oder neuer | |
| 0.3.15 | 0.25.11 oder neuer | |
| 0.3.7 | 0.22.0 oder neuer | |
| 0.3.6 | 0.22.0 oder neuer | |
| 0.3.5 | 0.22.0 oder neuer | |
| 0.3.4 | 0.22.0 oder neuer | |
| 0.3.3 | 0.22.0 oder neuer | |
| 0.3.2 | 0.22.0 oder neuer | |
| 0.2.1 | 0.20.0 oder neuer |
Installieren
In der Desktop-App
Öffne das Fenster Packages (das Paket-Symbol in der Statusleiste), wähle Browse, suche aigd.knowledge und klicke auf Add to Project.
Noch keine App? Lade AI Game Dev kostenlos herunter für Windows, macOS oder Linux.
Im Terminal
Mit der gamedev CLI in deinem Projektordner:
gamedev pkg add aigd.knowledgeVoraussetzungen
- AI Game Dev 0.25.11 oder neuer
gamedev pkg add aigd.knowledge