Code Graph Query Skill

概要

Code Graph Query Skill は AI Maestro の graph-query スキルです。AI Maestro は 23blocks による MIT ライセンスのダッシュボードで、永続メモリ、メッセージング、複数マシン対応で多数のコーディングエージェントを運用します。コードベースをコードグラフとしてインデックス化し（ダッシュボードで対話的に可視化も可能）、このスキルはエージェントにコンポーネントを変更する前にグラフを照会させ、呼び出し元、依存関係、変更の影響範囲を把握させることで、読んでいないコードを壊さないようにします。

守らせるルールは ファイルを読む → グラフを照会 → 作業を進める です。コードファイルを読んだ直後や検索で見つけたとき、変更の前に照会し、結果を分析に含めます。スキルは ai-maestro-plugins で公開され、AI Maestro と Bash へのアクセスが必要です。コマンドは tmux セッションからエージェント ID を自動検出します。

コマンド

スキルの説明によると、1,000 ファイル以上のフルインデックスは約 30〜120 秒、数ファイルの差分インデックスは数秒です。

クイックスタート

curl -fsSL https://raw.githubusercontent.com/23blocks-OS/ai-maestro/main/scripts/remote-install.sh | sh
graph-index-delta.sh /path/to/project
graph-find-callers.sh processPayment

使いどころ

• モデル変更時に依存するシリアライザーや関連をすべて洗い出す。
• 関数シグネチャを変える前に呼び出し元を一覧にする。
• 未知のコードベースの全体像をつかむ。

制限事項

• コンポーネント種別や関連コマンドは Rails 的な概念（model、serializer、belongs_to）に基づくため、技術スタックによって効果が異なります。
• AI Maestro が必要で、単体のコードインテリジェンスサーバーではありません。

よくある質問

フルインデックス専用のコマンドはありますか？

ありません。graph-index-delta.sh が初回はフルインデックス、以降は差分更新を行います。

代替ツール

• Serena：MCP 経由でシンボル単位の検索と参照を提供。
• sentrux：コーディングエージェントにコード構造の指標を返すアーキテクチャセンサー。

関連スキル

他の AI Maestro スキル：Memory Search、Docs Search、Agent Messaging。詳しくは Skills カテゴリ へ。