code-graph

Code Graph スキル

cgraph のデータベース、インデックス作成、クエリの全ライフサイクルを管理します。ユーザーが cgraph コマンドを手動で実行する必要はありません。

管理ルール

• cgraph コマンドが接続エラーで失敗した場合は、まず cgraph ensure-db を実行します。
• cgraph が見つからない場合は、インストール手順について management.md を参照してください。
• セッション開始時、またはコードに大幅な変更を加えた後にインデックスを作成します：cgraph index . --ignore node_modules --ignore venv --ignore .git --ignore __pycache__
• コードに変更がなければ、連続するクエリの間にインデックスを再作成する必要はありません。
• すべてのコマンド出力は標準出力に JSON で出力されます。ステータスと進捗は標準エラー出力に出力されます。
• --repo を省略した場合、現在のディレクトリ名がデフォルト値になります。

インデックス作成

# Index the current project
cgraph index . --ignore node_modules --ignore venv --ignore .git --ignore __pycache__

# Index a specific folder with a custom name
cgraph index /path/to/project --repo my-project --ignore node_modules

# Clone and index a remote repository
cgraph index-repo https://github.com/org/repo --ignore node_modules

検索

# Search for entities by prefix
cgraph search get_user
cgraph search parse
cgraph search MyClass

結果は、ノードの id、labels（File、Class、Function など）、properties（name、path、src_start、src_end）を含む JSON で返されます。後続のクエリには id を使用します。

関係の調査

# Get all neighbors of a node
cgraph neighbors 42 --repo my-project

# Filter by relationship type
cgraph neighbors 42 --rel CALLS          # what does it call?
cgraph neighbors 42 --rel DEFINES         # what does it define?

# Filter by destination label
cgraph neighbors 42 --label Function      # only function neighbors

# Multiple nodes at once
cgraph neighbors 42 55 --repo my-project

パスの検索

# Trace call-chain paths between two nodes
cgraph paths 42 99 --repo my-project

CALLS エッジをたどり、ある関数から別の関数にどのように到達するかを調べます。

リポジトリ情報

# List all indexed repos
cgraph list

# Show stats for a repo
cgraph info --repo my-project

検索結果の操作

• 検索結果には path、src_start、src_end が含まれます。Read ツールを使用して、該当箇所の実際のソースコードを読み込みます。
• ノードラベル：File、Class、Function、Interface、Struct
• エッジの種類：DEFINES（階層）、CALLS（呼び出しグラフ）、EXTENDS（継承）、IMPLEMENTS（インターフェース）、RETURNS（戻り値の型）、PARAMETERS（パラメーターの型）
• 詳細な JSON 構造と一般的なクエリパターンについては、querying.md を参照してください。