Base de conocimiento
gamedev pkg add aigd.knowledgeResumen
La base de conocimiento del proyecto: notas Markdown en .ai-game-dev/knowledge/, versionadas con el proyecto, indexadas como grafo y buscables por el agente. El agente registra decisiones de diseño y convenciones, organiza las notas en espacios, reescribe los enlaces al mover y encuentra enlaces rotos; la app de escritorio muestra las notas como un grafo 3D.
La base de conocimiento del proyecto para el agente de AI Game Dev: notas Markdown en .ai-game-dev/knowledge/, versionadas con el proyecto y compartidas con el equipo mediante git. El paquete indexa las notas y sus enlaces como un grafo, da al agente herramientas para explorarlas, buscarlas, enlazarlas y organizarlas, y muestra el grafo en una ventana 3D. Encaja con equipos de juego que quieren que las decisiones de diseño, las convenciones y el funcionamiento de sus sistemas queden escritos donde tanto las personas como el agente puedan encontrarlos.
Qué puedes hacer
- Hacer que el agente registre las decisiones de diseño y sus motivos, las convenciones y los detalles poco obvios que pueden dar problemas mientras trabajas, en el espacio temático correcto.
- Preguntar al agente qué decidió el equipo sobre un sistema; puede buscar en las notas para responder.
- Organizar las notas en espacios (carpetas con un
README.md), y mover o renombrar notas y carpetas sin romper los enlaces. - Encontrar enlaces rotos y notas huérfanas, y ver cómo se conecta todo en el grafo.
- Explorar tú mismo las notas en la ventana de grafo 3D o en la vista previa del panel lateral de la app de escritorio.
Ejemplos de solicitudes
- "Apunta que elegimos un paso de física fijo de 60 Hz para el sistema de combate, y por qué."
- "¿Qué dice la base de conocimiento sobre nuestro formato de guardado?"
- "Crea un espacio para el sistema de inventario y mueve ahí las notas de objetos."
- "Revisa la base de conocimiento en busca de enlaces rotos y corrígelos."
/kb systems(los totales de la base de conocimiento y los enlaces rotos, con el árbol del espaciosystems)
Cómo funciona
Las notas son archivos Markdown sin más bajo <project>/.ai-game-dev/knowledge/, así que viven en el control de versiones junto a tu juego. Un espacio es una carpeta con un README.md: un # Title y después una descripción de un párrafo. Las notas se enlazan entre sí con rutas desde la raíz de la base de conocimiento, por ejemplo [Combat](/systems/combat.md); también se indexan los enlaces relativos y los wikilinks ([[Combat]]).
El agente ve la lista de espacios de nivel superior en sus instrucciones y va bajando de un espacio a otro. Lee y escribe notas con sus herramientas de archivos habituales y usa estas herramientas para lo demás:
| Herramienta | Qué hace |
|---|---|
kb_space_get | Abrir un espacio: su descripción, los espacios hijos y las notas. |
kb_space_create | Crear un espacio: una carpeta con un README.md (título y descripción). |
kb_search | Búsqueda clasificada de notas por título, ruta y texto, con fragmentos. |
kb_links | Enlaces salientes, enlaces entrantes y enlaces rotos de una nota, o de todas las notas de una carpeta. |
kb_move | Mover o renombrar una nota o carpeta y reescribir todos los enlaces que apuntan a ella. |
kb_lint | Enlaces rotos, notas huérfanas, problemas de convenciones y sugerencias. |
Al agente se le indica que registre solo conocimiento importante y duradero (decisiones y sus motivos, convenciones, cómo funciona un sistema, detalles poco obvios), que busque primero y actualice una nota existente en lugar de duplicarla, y que base cada dato en lo que dijiste o en lo que muestra el código.
El paquete aporta:
- la capacidad Base de conocimiento, activada de forma predeterminada;
- el comando
/kb [folder or note](CLI y escritorio): notas, carpetas, enlaces, enlaces rotos y huérfanos, y después el árbol; - en la app de escritorio, la ventana de grafo 3D (desde la barra de estado, el menú de herramientas de la sesión o "Abrir en el grafo de la base de conocimiento" en una nota o carpeta del explorador de archivos), una vista de la base de conocimiento en el panel derecho y un consejo que apunta a ella. El grafo se actualiza en vivo mientras el agente escribe notas.
Requisitos
- AI Game Dev 0.25.11 o posterior. La ventana de grafo y el panel lateral forman parte de la app de escritorio.
- Una carpeta de proyecto;
gitpara compartir las notas con tu equipo.
Licencia
Apache-2.0.
Versiones
| Versión | Publicada | Requiere la aplicación |
|---|---|---|
| 0.3.22Última | 0.25.11 o posterior | |
| 0.3.21 | 0.25.11 o posterior | |
| 0.3.20 | 0.25.11 o posterior | |
| 0.3.19 | 0.25.11 o posterior | |
| 0.3.18 | 0.25.11 o posterior | |
| 0.3.17 | 0.25.11 o posterior | |
| 0.3.16 | 0.25.11 o posterior | |
| 0.3.15 | 0.25.11 o posterior | |
| 0.3.7 | 0.22.0 o posterior | |
| 0.3.6 | 0.22.0 o posterior | |
| 0.3.5 | 0.22.0 o posterior | |
| 0.3.4 | 0.22.0 o posterior | |
| 0.3.3 | 0.22.0 o posterior | |
| 0.3.2 | 0.22.0 o posterior | |
| 0.2.1 | 0.20.0 o posterior |
Instalar
En la app de escritorio
Abre la ventana Paquetes (el icono de paquete en la barra de estado), selecciona Explorar, busca aigd.knowledge y haz clic en Añadir al proyecto.
¿Aún no tienes la app? Descarga AI Game Dev gratis para Windows, macOS o Linux.
Desde el terminal
Con la CLI gamedev, en la carpeta de tu proyecto:
gamedev pkg add aigd.knowledgeRequisitos
- AI Game Dev 0.25.11 o posterior
gamedev pkg add aigd.knowledge