GKG - Grafo de Conhecimento Global

Global Knowledge Graph (GKG)

Visão Geral

O GKG fornece ferramentas de análise semântica de código para explorar e entender bases de código. Ele indexa projetos para permitir busca rápida de símbolos, localização de referências e análise estrutural.

Início Rápido

Execute a partir do diretório desta skill. Use --raw com JSON para parâmetros:

bun ./scripts/gkg.ts <comando> --raw '<json>'

Comandos Principais

list-projects

Lista todos os projetos indexados no grafo de conhecimento.

bun ./scripts/gkg.ts list-projects

index-project

Recria o índice do grafo de conhecimento para um projeto.

bun ./scripts/gkg.ts index-project \
  --raw '{"project_absolute_path":"/caminho/para/projeto"}'

search-codebase-definitions

Encontre funções, classes, métodos e constantes na base de código.

bun ./scripts/gkg.ts search-codebase-definitions \
  --raw '{"search_terms":["nomeFuncao","NomeClasse"],"project_absolute_path":"/caminho/para/projeto"}'

get-references

Encontre todos os usos de um símbolo na base de código.

bun ./scripts/gkg.ts get-references \
  --raw '{"absolute_file_path":"/caminho/para/arquivo.ts","definition_name":"minhaFuncao"}'

read-definitions

Leia a implementação completa das definições.

bun ./scripts/gkg.ts read-definitions \
  --raw '{"definitions":[{"names":["minhaFunc"],"file_path":"/caminho/para/arquivo.ts"}]}'

get-definition

Vá para a definição de um símbolo em uma linha específica.

bun ./scripts/gkg.ts get-definition \
  --raw '{"absolute_file_path":"/caminho/para/arquivo.ts","line":"const result = minhaFunc()","symbol_name":"minhaFunc"}'

repo-map

Gere um mapa compacto no estilo de API da estrutura do repositório.

bun ./scripts/gkg.ts repo-map \
  --raw '{"project_absolute_path":"/caminho/para/projeto","relative_paths":["src","lib"]}'

import-usage

Analise usos de importação no projeto.

bun ./scripts/gkg.ts import-usage \
  --raw '{"project_absolute_path":"/caminho/para/projeto","packages":[{"import_path":"react"}]}'

Fluxos de Trabalho Comuns

Análise de Impacto de Refatoração

1. Use search-codebase-definitions para encontrar o símbolo
2. Use get-references para encontrar todos os usos
3. Revise cada local de uso antes de fazer alterações

Entendendo Código Desconhecido

1. Use repo-map para obter uma visão geral da estrutura do projeto
2. Use search-codebase-definitions para encontrar funções relevantes
3. Use read-definitions para ler implementações

Rastreando Dependências

1. Use import-usage para encontrar onde pacotes são importados
2. Use get-references para rastrear cadeias de chamada de funções

Recursos

scripts/

• gkg.ts - Ferramenta CLI para todas as operações do grafo de conhecimento

references/

• api_reference.md - Documentação detalhada de parâmetros para cada comando