グローバル知識グラフ (GKG) は何をしますか？
概要
GKG は、コードベースの探索と理解を支援するセマンティックコード解析ツールを提供します。プロジェクトをインデックス化し、高速なシンボル検索、参照検索、構造解析を実現します。
クイックスタート
このスキルディレクトリから実行します。パラメータには --raw オプションで JSON を使用します：
bun ./scripts/gkg.ts <command> --raw '<json>'
コアコマンド
list-projects
知識グラフにインデックス化された全プロジェクトを一覧表示します。
bun ./scripts/gkg.ts list-projects
index-project
プロジェクトの知識グラフインデックスを再構築します。
bun ./scripts/gkg.ts index-project \
--raw '{"project_absolute_path":"/path/to/project"}'
search-codebase-definitions
コードベース全体から関数、クラス、メソッド、定数を検索します。
bun ./scripts/gkg.ts search-codebase-definitions \
--raw '{"search_terms":["functionName","ClassName"],"project_absolute_path":"/path/to/project"}'
get-references
コードベース全体でのシンボルの全使用箇所を検索します。
bun ./scripts/gkg.ts get-references \
--raw '{"absolute_file_path":"/path/to/file.ts","definition_name":"myFunction"}'
read-definitions
定義の完全な実装を読み込みます。
bun ./scripts/gkg.ts read-definitions \
--raw '{"definitions":[{"names":["myFunc"],"file_path":"/path/to/file.ts"}]}'
get-definition
特定の行にあるシンボルの定義にジャンプします。
bun ./scripts/gkg.ts get-definition \
--raw '{"absolute_file_path":"/path/to/file.ts","line":"const result = myFunc()","symbol_name":"myFunc"}'
repo-map
リポジトリ構造のコンパクトなAPIスタイルマップを生成します。
bun ./scripts/gkg.ts repo-map \
--raw '{"project_absolute_path":"/path/to/project","relative_paths":["src","lib"]}'
import-usage
プロジェクト全体でのインポート使用状況を分析します。
bun ./scripts/gkg.ts import-usage \
--raw '{"project_absolute_path":"/path/to/project","packages":[{"import_path":"react"}]}'
一般的なワークフロー
リファクタリング影響分析
search-codebase-definitionsを使用してシンボルを検索get-referencesを使用してすべての使用箇所を特定- 変更前に各使用箇所を確認
未コードの理解
repo-mapを使用してプロジェクト構造の概要を取得search-codebase-definitionsを使用して関連関数を検索read-definitionsを使用して実装を読み込み
依存関係のトレース
import-usageを使用してパッケージのインポート箇所を特定get-referencesを使用して関数呼び出しチェーンを追跡
リソース
scripts/
gkg.ts- すべての知識グラフ操作のためのCLIツール
references/
api_reference.md- 各コマンドの詳細なパラメータドキュメント