Base de Conhecimento
gamedev pkg add aigd.knowledgeVisão geral
A Base de Conhecimento do projeto: notas em markdown em .ai-game-dev/knowledge/, versionadas junto com o projeto, indexadas como um grafo e pesquisáveis pelo agente. O agente registra decisões de design e convenções, organiza as notas em espaços, corrige links ao mover e encontra links quebrados; o aplicativo desktop mostra as notas como um grafo 3D.
A Base de Conhecimento do projeto para o agente do AI Game Dev: notas em Markdown em .ai-game-dev/knowledge/, versionadas junto com o projeto e compartilhadas com a equipe pelo git. O pacote indexa as notas e seus links como um grafo, dá ao agente ferramentas para navegar, pesquisar, vincular e organizar as notas, e mostra o grafo em uma janela 3D. Ele é indicado para equipes de jogos que querem decisões de design, convenções e o funcionamento dos seus sistemas registrados onde tanto as pessoas quanto o agente possam encontrá-los.
O que você pode fazer
- Pedir ao agente que registre decisões de design e seus motivos, convenções e pegadinhas nada óbvias enquanto você trabalha, no espaço de tópico certo.
- Perguntar ao agente o que a equipe decidiu sobre um sistema; ele pode pesquisar nas notas para responder.
- Organizar as notas em espaços (pastas com um
README.md) e mover ou renomear notas e pastas sem quebrar links. - Encontrar links quebrados e notas órfãs e ver como tudo se conecta no grafo.
- Navegar pelas notas você mesmo na janela de grafo 3D ou na prévia do painel lateral do aplicativo desktop.
Exemplos de pedidos
- "Anote que escolhemos um passo de física fixo de 60 Hz para o sistema de combate, e por quê."
- "O que a Base de Conhecimento diz sobre o nosso formato de save?"
- "Crie um espaço para o sistema de inventário e mova as notas de itens para lá."
- "Verifique a Base de Conhecimento em busca de links quebrados e corrija-os."
/kb systems(os totais e links quebrados da Base de Conhecimento, com a árvore do espaçosystems)
Como funciona
As notas são arquivos Markdown simples em <project>/.ai-game-dev/knowledge/, então ficam no controle de versão junto com o seu jogo. Um espaço é uma pasta com um README.md: um # Title, seguido de uma descrição de um parágrafo. As notas se vinculam umas às outras com caminhos a partir da raiz da Base de Conhecimento, por exemplo [Combat](/systems/combat.md); links relativos e wikilinks ([[Combat]]) também são indexados.
O agente vê a lista de espaços de nível superior nas suas instruções e desce um espaço de cada vez. Ele lê e escreve notas com as ferramentas de arquivo comuns e usa estas ferramentas para o resto:
| Ferramenta | O que ela faz |
|---|---|
kb_space_get | Abre um espaço: sua descrição, espaços filhos e notas. |
kb_space_create | Cria um espaço: uma pasta com um README.md (título e descrição). |
kb_search | Busca classificada de notas por título, caminho e texto, com trechos. |
kb_links | Links de saída, backlinks e links quebrados de uma nota, ou de todas as notas de uma pasta. |
kb_move | Move ou renomeia uma nota ou pasta e reescreve todos os links que apontam para ela. |
kb_lint | Links quebrados, notas órfãs, problemas de convenção e dicas. |
O agente é instruído a registrar apenas conhecimento importante e duradouro (decisões e seus motivos, convenções, como um sistema funciona, pegadinhas nada óbvias), a pesquisar primeiro e atualizar uma nota existente em vez de duplicá-la, e a basear cada fato no que você disse ou no que o código mostra.
O pacote contribui com:
- o recurso Base de Conhecimento, ativado por padrão;
- o comando
/kb [folder or note](CLI e desktop): notas, pastas, links, links quebrados e órfãs, depois a árvore; - no aplicativo desktop, a janela de grafo 3D (a partir da barra de status, do menu de ferramentas da sessão ou de "Abrir no grafo da Base de Conhecimento" em uma nota ou pasta no explorador de arquivos), uma visão da Base de Conhecimento no painel direito e uma dica que aponta para ela. O grafo é atualizado ao vivo enquanto o agente escreve notas.
Requisitos
- AI Game Dev 0.25.11 ou mais recente. A janela de grafo e o painel lateral fazem parte do aplicativo desktop.
- Uma pasta de projeto;
gitpara compartilhar as notas com a sua equipe.
Licença
Apache-2.0.
Versões
| Versão | Lançamento | Requer o app |
|---|---|---|
| 0.3.22Mais recente | 0.25.11 ou mais recente | |
| 0.3.21 | 0.25.11 ou mais recente | |
| 0.3.20 | 0.25.11 ou mais recente | |
| 0.3.19 | 0.25.11 ou mais recente | |
| 0.3.18 | 0.25.11 ou mais recente | |
| 0.3.17 | 0.25.11 ou mais recente | |
| 0.3.16 | 0.25.11 ou mais recente | |
| 0.3.15 | 0.25.11 ou mais recente | |
| 0.3.7 | 0.22.0 ou mais recente | |
| 0.3.6 | 0.22.0 ou mais recente | |
| 0.3.5 | 0.22.0 ou mais recente | |
| 0.3.4 | 0.22.0 ou mais recente | |
| 0.3.3 | 0.22.0 ou mais recente | |
| 0.3.2 | 0.22.0 ou mais recente | |
| 0.2.1 | 0.20.0 ou mais recente |
Instalar
No app para desktop
Abra a janela Pacotes (o ícone de pacote na barra de status), selecione Explorar, pesquise aigd.knowledge e clique em Adicionar ao projeto.
Ainda sem o app? Baixe o AI Game Dev grátis para Windows, macOS ou Linux.
Pelo terminal
Com a CLI gamedev, na pasta do seu projeto:
gamedev pkg add aigd.knowledgeRequisitos
- AI Game Dev 0.25.11 ou mais recente
gamedev pkg add aigd.knowledge