Global Knowledge Graph (GKG)

Was macht Global Knowledge Graph (GKG)?

Übersicht

GKG bietet semantische Code-Analyse-Tools zur Erkundung und zum Verständnis von Codebasen. Es indiziert Projekte, um eine schnelle Symbolsuche, Referenzfindung und Strukturanalyse zu ermöglichen.

Schnellstart

Führen Sie die Befehle aus dem Skill-Verzeichnis aus. Verwenden Sie --raw mit JSON für Parameter:

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

Kernbefehle

list-projects

Liste aller indizierten Projekte im Wissensgraphen.

bun ./scripts/gkg.ts list-projects

index-project

Wissensgraphen-Index für ein Projekt neu aufbauen.

bun ./scripts/gkg.ts index-project \
  --raw '{"project_absolute_path":"/path/to/project"}'

search-codebase-definitions

Finden von Funktionen, Klassen, Methoden und Konstanten in der gesamten Codebasis.

bun ./scripts/gkg.ts search-codebase-definitions \
  --raw '{"search_terms":["functionName","ClassName"],"project_absolute_path":"/path/to/project"}'

get-references

Alle Verwendungen eines Symbols in der Codebasis finden.

bun ./scripts/gkg.ts get-references \
  --raw '{"absolute_file_path":"/path/to/file.ts","definition_name":"myFunction"}'

read-definitions

Vollständige Implementierung von Definitionen lesen.

bun ./scripts/gkg.ts read-definitions \
  --raw '{"definitions":[{"names":["myFunc"],"file_path":"/path/to/file.ts"}]}'

get-definition

Gehe zur Definition eines Symbols in einer bestimmten Zeile.

bun ./scripts/gkg.ts get-definition \
  --raw '{"absolute_file_path":"/path/to/file.ts","line":"const result = myFunc()","symbol_name":"myFunc"}'

repo-map

Erzeugt eine kompakte API-ähnliche Karte der Repository-Struktur.

bun ./scripts/gkg.ts repo-map \
  --raw '{"project_absolute_path":"/path/to/project","relative_paths":["src","lib"]}'

import-usage

Analyse der Importnutzung im gesamten Projekt.

bun ./scripts/gkg.ts import-usage \
  --raw '{"project_absolute_path":"/path/to/project","packages":[{"import_path":"react"}]}'

Häufige Arbeitsabläufe

Refactoring-Auswirkungsanalyse

1. Verwenden Sie search-codebase-definitions, um das Symbol zu finden
2. Verwenden Sie get-references, um alle Verwendungen zu finden
3. Überprüfen Sie jeden Verwendungsort, bevor Sie Änderungen vornehmen

Unbekannte Codeabschnitte verstehen

1. Verwenden Sie repo-map, um einen Überblick über die Projektstruktur zu erhalten
2. Verwenden Sie search-codebase-definitions, um relevante Funktionen zu finden
3. Verwenden Sie read-definitions, um Implementierungen zu lesen

Abhängigkeiten nachverfolgen

1. Verwenden Sie import-usage, um zu finden, wo Pakete importiert werden
2. Verwenden Sie get-references, um Funktionsaufrufketten zu verfolgen

Ressourcen

scripts/

• gkg.ts - CLI-Tool für alle Wissensgraphen-Operationen

references/

• api_reference.md - Detaillierte Parameterdokumentation für jeden Befehl