mcpField
G
gitnexus-exploring

gitnexus-exploring

github.com/arenukvern開発39447 回インストール2 週間前に更新
リポジトリ

gitnexus-exploring について

GitNexus でインデックス済みコードベースを調査するスキルです。グラフ検索、シンボルのコンテキスト、実行トレースを使って構造や動作を把握し、未知のコードや機能の流れを調べる開発者を支援します。

主な機能

  1. 01インデックス済みリポジトリの検出
  2. 02コードベースの概要と鮮度の確認
  3. 03関連する実行フローの検索
  4. 04シンボルの呼び出し元と呼び出し先の調査
  5. 05手順別の実行トレースの参照

活用シーン

  1. 01未知のプロジェクト構造の把握
  2. 02認証や決済フローの追跡
  3. 03データベース関連ロジックの特定
  4. 04シンボルの呼び出し元と依存関係の調査

MCP 対応

`gitnexus://repo/{name}/context` などの GitNexus MCP リソースやプロセストレースを使い、`query` と `context` ツールでコードと実行フローを調査します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/arenukvern/mcp_flutter --skill gitnexus-exploring

インストール後、Claude Code で/gitnexus-exploringを入力して読み込まれたか確認します。

詳細

GitNexus を使ったコードベースの調査

使用する場面

  • 「認証はどのように機能しますか？」
  • 「プロジェクトの構成はどうなっていますか？」
  • 「主要なコンポーネントを見せてください」
  • 「データベースのロジックはどこにありますか？」
  • 初めて見るコードを理解するとき

ワークフロー

1. READ gitnexus://repos                          → Discover indexed repos
2. READ gitnexus://repo/{name}/context             → Codebase overview, check staleness
3. query({search_query: "<what you want to understand>"})  → Find related execution flows
4. context({name: "<symbol>"})            → Deep dive on specific symbol
5. READ gitnexus://repo/{name}/process/{name}      → Trace full execution flow

手順 2 で「インデックスが古くなっています」と表示された場合は、ターミナルで node .gitnexus/run.cjs analyze を実行してください。

チェックリスト

- [ ] READ gitnexus://repo/{name}/context
- [ ] query for the concept you want to understand
- [ ] Review returned processes (execution flows)
- [ ] context on key symbols for callers/callees
- [ ] READ process resource for full execution traces
- [ ] Read source files for implementation details

リソース

リソース内容
gitnexus://repo/{name}/context統計情報、古さに関する警告（約 150 トークン）
gitnexus://repo/{name}/clustersまとまり度スコア付きのすべての機能領域（約 300 トークン）
gitnexus://repo/{name}/cluster/{name}ファイルパス付きの領域メンバー（約 500 トークン）
gitnexus://repo/{name}/process/{name}実行トレースの手順（約 200 トークン）

ツール

query — 概念に関連する実行フローを検索します。

query({search_query: "payment processing"})
→ Processes: CheckoutFlow, RefundFlow, WebhookHandler
→ Symbols grouped by flow with file locations

context — シンボルを 360 度の視点で確認します。

context({name: "validateUser"})
→ Incoming calls: loginHandler, apiMiddleware
→ Outgoing calls: checkToken, getUserById
→ Processes: LoginFlow (step 2/5), TokenRefresh (step 1/3)

例：「決済処理はどのように機能しますか？」

1. READ gitnexus://repo/my-app/context       → 918 symbols, 45 processes
2. query({search_query: "payment processing"})
   → CheckoutFlow: processPayment → validateCard → chargeStripe
   → RefundFlow: initiateRefund → calculateRefund → processRefund
3. context({name: "processPayment"})
   → Incoming: checkoutHandler, webhookHandler
   → Outgoing: validateCard, chargeStripe, saveTransaction
4. Read src/payments/processor.ts for implementation details

コメント

Markdown 対応