/ ディレクトリ / プレイグラウンド / Nexus-skills
● コミュニティ Haaaiawd ⚡ 即起動

Nexus-skills

作者 Haaaiawd · Haaaiawd/Nexus-skills

コードベースインテリジェンススキル — 永続的な .nexus-map/ ナレッジベースを構築し、ファイル構造・依存関係・変更影響範囲をクエリできます。

Nexus Skills は Claude Code やその他のエージェントにコードベースの理解力を与えます。一度実行すると、ファイル構造・依存グラフ・呼び出し箇所を含む .nexus-map/ ナレッジベースが生成されます。以降は「この関数を変更したら何が壊れる?」といったクエリに対して、推測ではなく正確な回答が得られます。大規模で不慣れなリポジトリで特に有用です。

なぜ使うのか

主な機能

ライブデモ

実際の動作

nexus-skill.replay ▶ 準備完了
0/0

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "nexus-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Haaaiawd/Nexus-skills",
        "~/.claude/skills/Nexus-skills"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "nexus-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Haaaiawd/Nexus-skills",
        "~/.claude/skills/Nexus-skills"
      ],
      "_inferred": true
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "nexus-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Haaaiawd/Nexus-skills",
        "~/.claude/skills/Nexus-skills"
      ],
      "_inferred": true
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "nexus-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Haaaiawd/Nexus-skills",
        "~/.claude/skills/Nexus-skills"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "nexus-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Haaaiawd/Nexus-skills",
        "~/.claude/skills/Nexus-skills"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json
{
  "context_servers": {
    "nexus-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/Haaaiawd/Nexus-skills",
          "~/.claude/skills/Nexus-skills"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add nexus-skill -- git clone https://github.com/Haaaiawd/Nexus-skills ~/.claude/skills/Nexus-skills

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方: Nexus-skills

不慣れなコードベースに素早くオンボーディングする方法

👤 新しいチームに参加するエンジニア、またはコードベースを引き継ぐチーム ⏱ ~60 min intermediate

使うタイミング: 初めて触るリポジトリの初日。変更を加える前にまず全体像を把握したいとき。

前提条件
  • スキルのインストール — git clone https://github.com/Haaaiawd/Nexus-skills ~/.claude/skills/nexus-skills
フロー
  1. マップを構築する
    Use nexus-skills to scan this repo and build .nexus-map/.✓ コピーしました
    → 進捗の出力とマップファイルの生成
  2. 全体像を把握する
    Using .nexus-map, tell me: entry points, top 10 most-imported modules, and any orphaned files.✓ コピーしました
    → 実際のファイルに基づいたリポジトリ概要
  3. サブシステムを深掘りする
    Show me the payments subsystem — files, dependencies, external calls.✓ コピーしました
    → スコープを絞ったサブシステムビュー

結果: 1時間以内にリポジトリの事実に基づいたメンタルモデルが構築できます。

注意点
  • 大規模マージ後にマップが古くなる — nexus update を再実行する(インクリメンタル更新)

コア関数を変更する前に影響範囲を確認する

👤 広く使われているユーティリティに手を入れようとしているエンジニア ⏱ ~30 min intermediate

使うタイミング: 関数のリネームやシグネチャ変更を行う前に、すべての呼び出し箇所を把握したいとき。

前提条件
  • .nexus-map/ が構築済みであること — リポジトリごとに一度実行すれば、以降はインクリメンタル更新のみ
フロー
  1. 影響範囲をクエリする
    What calls formatCurrency(), and what would break if I change the signature to accept a locale?✓ コピーしました
    → 呼び出し箇所のリストと、各呼び出し元の想定される破損パターン
  2. マイグレーションを生成する
    Produce the minimal diff across all call sites to add the new locale param with a sensible default.✓ コピーしました
    → 複数ファイルにまたがるパッチ

結果: 影響範囲が明確で、差分が準備された状態で変更に臨めます。

デッドコードと未使用エクスポートを検出する

👤 リファクタリング前にコードを整理したいエンジニア ⏱ ~40 min intermediate

使うタイミング: リファクタリングの前に、本当に使われていないコードを把握したいとき。

フロー
  1. マップをクエリする
    Using .nexus-map, list files with no imports from elsewhere, and exports with no external references.✓ コピーしました
    → 信頼度付きのランク付けリスト
  2. 検証する
    For the top 10 candidates, double-check by searching for string-based usage (reflection, dynamic imports).✓ コピーしました
    → 偽陽性の注釈付きフィルタリング済みリスト

結果: 実際にリリース可能なデッドコード削除リストが得られます。

注意点
  • 動的インポートは静的解析ではデッドコードに見える — 削除前に必ず文字列ベースのスキャンを実行する

組み合わせ

他のMCPと組み合わせて10倍の力を

セキュリティ影響クエリ:汚染された入力はどこに流れるか?

Using nexus-map, trace every call path from the /ingest endpoint into the DB layer. Then OWASP review those paths.✓ コピーしました

ツール

このMCPが提供する機能

ツール入力呼び出すタイミングコスト
build_map repo_root リポジトリごとに初回に一度実行 compute (local)
update_map changed_files 大規模マージの後に実行 compute (local)
query_structure question 構造に関する質問に回答するとき Claude tokens
change_impact symbol or file 破壊的変更を行う前 Claude tokens
dead_code - リファクタリング前のクリーンアップ時 Claude tokens

コストと制限

運用コスト

APIクォータ
なし
呼び出しあたりのトークン
マップ構築はローカル処理(高速)。クエリは Claude トークンを消費します
金額
無料
ヒント
一度構築すれば何度でもクエリ可能。リポジトリ構造が大きく変わったときのみ再構築してください。

セキュリティ

権限、シークレット、影響範囲

認証情報の保管: 認証情報は不要です。.nexus-map/ はデフォルトでローカルに保存されます。
データ送信先: マップ構築はローカルで完結します。クエリ時にはマップの一部が Claude に送信されます。

トラブルシューティング

よくあるエラーと対処法

モノレポでマップ構築がクラッシュする

ルートではなくパッケージ単位で実行してください。nexus は scope フラグに対応しています

編集後にクエリが古い結果を返す

変更したファイルに対して nexus update を実行してください。インクリメンタル更新は低コストです

Language not recognized — 言語が認識されない

nexus のドキュメントで対応言語を確認してください。一部のフレームワークでは明示的なパーサーコンフィグが必要です

代替案

Nexus-skills 他との比較

代替案代わりに使う場面トレードオフ
SourceGraph / Cody組織規模でホスト型コードインテリジェンスが必要な場合有料。ローカルではない
tree-sitter + custom queries完全な制御が必要な場合構築時間が大幅に増加する

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る