gitnexus-guide について
gitnexus-guideは、コードグラフを扱う開発者向けに、GitNexusのツール、リソース、ナレッジグラフのスキーマをまとめたリファレンスです。タスクに応じたスキルを案内し、ツールの説明、リソースパス、クエリ例を掲載しています。
主な機能
- 01タスクに応じたGitNexusスキルの選択
- 02コードフローとシンボル参照の検索
- 03変更の影響範囲の分析
- 04複数ファイルにまたがる名前変更
- 05グラフリソースとCypherスキーマの参照
活用シーン
- 01リポジトリの構造や実行フローの把握
- 02シンボル変更による影響の評価
- 03バグ調査やコードリファクタリングの計画
MCP 対応
GitNexusはコード検索、シンボルコンテキスト、影響分析、名前変更、Cypherクエリ用のMCPツールを提供し、リポジトリのコンテキスト、プロセス、スキーマなどをリソースとして公開します。
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ mindfold-ai/ trellis --skill gitnexus-guideインストール後、Claude Code で/gitnexus-guideを入力して読み込まれたか確認します。
詳細
GitNexus ガイド
GitNexus のすべての MCP ツール、リソース、ナレッジグラフスキーマのクイックリファレンスです。
まずはここから
コードの理解、デバッグ、影響分析、リファクタリングに関するタスクでは、次の手順に従ってください。
gitnexus://repo/{name}/contextを読み取る — コードベースの概要とインデックスの鮮度を確認します- タスクに合った下記のスキルを選び、そのスキルファイルを読み取る
- スキルのワークフローとチェックリストに従う
手順 1 でインデックスが古いという警告が表示された場合は、まずターミナルで
node .gitnexus/run.cjs analyzeを実行してください。
スキル
| タスク | 読むスキル |
|---|---|
| アーキテクチャを理解する/「X はどのように動作しますか?」 | gitnexus-exploring |
| 影響範囲/「X を変更すると何が壊れますか?」 | gitnexus-impact-analysis |
| バグを追跡する/「X が失敗するのはなぜですか?」 | gitnexus-debugging |
| 名前変更/抽出/分割/リファクタリング | gitnexus-refactoring |
| ツール、リソース、スキーマのリファレンス | gitnexus-guide(このファイル) |
| インデックス、ステータス、クリーン、Wiki の CLI コマンド | gitnexus-cli |
ツールのリファレンス
| ツール | 得られる情報 |
|---|---|
query | プロセスごとにグループ化されたコードインテリジェンス — 概念に関連する実行フロー |
context | シンボルの全方位ビュー — 分類された参照情報と、参加しているプロセス |
impact | シンボルの影響範囲 — 深度 1/2/3 で何が壊れるかと、その確信度 |
detect_changes | Git 差分の影響 — 現在の変更が影響する対象 |
rename | 確信度タグ付きの編集による、複数ファイルにまたがる協調的な名前変更 |
cypher | 生のグラフクエリ(まず gitnexus://repo/{name}/schema を読み取ってください) |
list_repos | インデックス済みリポジトリを検索 |
リソースのリファレンス
ナビゲーション向けの軽量な読み取り(約 100~500 トークン):
| リソース | 内容 |
|---|---|
gitnexus://repo/{name}/context | 統計情報、古さの確認 |
gitnexus://repo/{name}/clusters | 凝集度スコア付きのすべての機能領域 |
gitnexus://repo/{name}/cluster/{clusterName} | 領域のメンバー |
gitnexus://repo/{name}/processes | すべての実行フロー |
gitnexus://repo/{name}/process/{processName} | 手順ごとのトレース |
gitnexus://repo/{name}/schema | Cypher 用のグラフスキーマ |
グラフスキーマ
ノード: File、Function、Class、Interface、Method、Community、Process エッジ(CodeRelation.type 経由): CALLS、IMPORTS、EXTENDS、IMPLEMENTS、DEFINES、MEMBER_OF、STEP_IN_PROCESS
MATCH (caller)-[:CodeRelation {type: 'CALLS'}]->(f:Function {name: "myFunc"})
RETURN caller.name, caller.filePath
コメント
Markdown 対応