graph-query

AI Maestro コードグラフクエリ

コードベースの依存関係グラフを照会し、変更を加える前にコンポーネント間の関係、呼び出しチェーン、変更の影響範囲を把握できます。AI Maestro スイートの一部です。

前提条件

ローカルで AI Maestro が実行されており、コードベースのインデックス作成が完了している必要があります。

# Install graph tools
git clone https://github.com/23blocks-OS/ai-maestro-plugins.git
cd ai-maestro-plugins && ./install-graph-tools.sh

基本動作

コードファイルを読んだ後は、依存関係を把握するためにグラフを照会してください:

Read file -> Query graph -> Then proceed

コマンド

クエリ

コマンド	説明
graph-describe.sh <name>	コンポーネントまたは関数を説明する
graph-find-callers.sh <fn>	関数のすべての呼び出し元を検索する
graph-find-callees.sh <fn>	この関数が呼び出しているすべての関数を検索する
graph-find-related.sh <component>	関連するコンポーネントを検索する
graph-find-by-type.sh <type>	指定した種類のすべてのコンポーネントを検索する
graph-find-serializers.sh <model>	モデルのシリアライザーを検索する
graph-find-associations.sh <model>	モデルのアソシエーションを検索する
graph-find-path.sh <from> <to>	関数間の呼び出しパスを検索する

インデックス

コマンド	説明
graph-index-delta.sh [path]	コードグラフをインデックス作成または更新する

コンポーネントの種類

graph-find-by-type.sh で使用します: model, serializer, controller, service, job, concern, component, hook

使用例

# After reading a model file
graph-describe.sh User
graph-find-serializers.sh User
graph-find-associations.sh User

# Before modifying a function
graph-find-callers.sh process_payment
graph-find-callees.sh process_payment

# Find call chain between components
graph-find-path.sh handleRequest sendResponse

# Index your codebase
graph-index-delta.sh /path/to/project

変更前にクエリを実行する理由

グラフを確認せずに変更すると、次のようなリスクがあります:

• 関数のシグネチャを変更した際に、呼び出し元が壊れる
• モデルの変更に伴って更新が必要なシリアライザーを見落とす
• 変更を継承している子クラスを見落とす

AI Maestro の全機能

このスキルは AI Maestro プラットフォームの一部であり、メッセージング、メモリ、ドキュメント、グラフ、計画、エージェント管理のための AI エージェントオーケストレーション用に 6 つのスキルを提供しています。