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

Understand-Anything

作者 Lum1104 · Lum1104/Understand-Anything

あらゆるコードベース向けのビジュアルオンボーディング。単なる図解ではなく、システムを教える構造グラフとドメイン知識グラフを生成する。

Understand-Anything はコードベースと知識ベースをインタラクティブなグラフに変換する。2 層のビュー:構造(ファイル・関数・クラス)とドメイン(ビジネスプロセス・データフロー)。意味検索(「認証はどこで処理される?」)・変更影響分析・適応的な詳細レベルを含む。きれいな図ではなく、新チームのオンボーディングとアーキテクチャ理解のために作られている。

なぜ使うのか

主な機能

ライブデモ

実際の動作

準備完了

インストール

作者のリポジトリ · Claude Skills の公式ドキュメント

ユースケース

実用的な使い方: Understand-Anything

20 万行のコードベースに新しいエンジニアをオンボードする

👤 採用者をオンボーディングするテックリード、またはプロジェクトを引き継ぐ個人開発者 ⏱ ~60 min intermediate

使うタイミング: 新しいリポジトリで、1 週間で生産的になりたいとき。

フロー
  1. リポジトリをインデックス化する
    Use understand-anything. Build the structural graph for ./repo and the domain graph from /docs.✓ コピーしました
    → グラフの統計(ノード数・エッジ数・密度)が表示される
  2. コアの接合点を見つける
    Highlight the 5 most-connected modules — likely architectural seams.✓ コピーしました
    → 理由付きのランク付きリストが表示される
  3. 1 つの機能をトレースする
    Walk me through 'create checkout' end-to-end across structural + domain graphs.✓ コピーしました
    → ビジネスと技術の両方の観点でノードに注釈が付けられたパスが表示される

結果: 力任せではなく的を絞った読み方で、週ではなく日単位で生産的になれる。

注意点
  • グラフが密すぎて読めない — ディレクトリまたは機能でフィルタリングする。スキルは適応的な詳細レベルに対応している
組み合わせ: filesystem

PR を開く前に変更の影響を予測する

👤 共有コードに変更を加えようとしている開発者 ⏱ ~25 min intermediate

使うタイミング: 「重要そう」と感じるモジュールをリファクタリングしようとしているとき。

フロー
  1. 変更を定義する
    Use understand-anything. I'll change the signature of calculateTax(price, region) to add a customer_class. What breaks?✓ コピーしました
    → 更新が必要な呼び出し元とテストの一覧が表示される
  2. 影響範囲を可視化する
    Show me the subgraph touched by this change.✓ コピーしました
    → エッジごとの深刻度付きでハイライトされたサブグラフが表示される
  3. PR の計画を立てる
    Propose a PR sequence that minimizes review surface — which files first?✓ コピーしました
    → 理由付きのファイル順序が提示される

結果: 1500 行の巨大 PR ではなく、レビューしやすいサイズの PR が完成する。

注意点
  • グラフがリフレクションや動的ディスパッチによる実行時の呼び出し元を見逃す — 関数名を grep でクロスチェックする。実行時の呼び出し元は別途明記する

Wiki を知識グラフに変換する

👤 膨大な Wiki を持つ研究者・チーム ⏱ ~45 min intermediate

使うタイミング: チームに 200 ページの Wiki があるが、誰も目的の情報を見つけられないとき。

フロー
  1. ページを取り込む
    Use understand-anything. Build a knowledge graph from /wiki/. Extract entities and implicit relationships.✓ コピーしました
    → エンティティ型と関係型を含むグラフが生成される
  2. 行き止まりを見つける
    Which entities are referenced but never defined?✓ コピーしました
    → ページが必要なスタブトピックの一覧が表示される
  3. 再構成を提案する
    Based on cluster structure, propose a 5-section TOC.✓ コピーしました
    → ページが割り当てられたセクション一覧が提示される

結果: 実際にナビゲートできる Wiki になる。

注意点
  • 暗黙の関係がノイズになる(全ページに「API」という語が登場する) — 抽出器のストップリストを調整する。スキルには一般的なノイズ語の設定オプションがある
組み合わせ: filesystem

組み合わせ

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

understand-anything-skill + filesystem

生成したグラフをチームで再利用できるよう永続化する

Save the graph to .claude/graphs/ and check in. Refresh on each main merge.✓ コピーしました
understand-anything-skill + git-mcp-idosal

ローカルにクローンせずリモートの公開リポジトリのグラフを構築する

Use gitmcp for the repo source; pipe into understand-anything to build the graph in memory.✓ コピーしました

ツール

このMCPが提供する機能

ツール入力呼び出すタイミングコスト
build_structural_graph repo_path, languages? 新しいリポジトリの最初のステップ 0
build_domain_graph docs_path 全体像を把握するために構造グラフと組み合わせる 0
semantic_search intent_query 「X はどこで処理される?」という意味での検索 0
impact_analysis node_id, change_kind PR 前の変更影響評価 0
feature_walkthrough feature_name オンボーディング・学習モード 0

コストと制限

運用コスト

APIクォータ
なし — ローカルスキル
呼び出しあたりのトークン
グラフ構築は低コスト。クエリはサブグラフのサイズに応じて 200〜1500 トークン
金額
無料
ヒント
main ごとに 1 回構築してキャッシュする。大きなリファクタリング時にのみ再構築する

セキュリティ

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

最小スコープ: filesystem-read
認証情報の保管: なし
データ送信先: なし

トラブルシューティング

よくあるエラーと対処法

大規模リポジトリでのビルドが遅い

--include と --exclude でスコープを絞る。生成・ベンダーディレクトリをスキップする

言語をまたいだ呼び出しが見つからない

スキルは 1 回のパスで 1 言語のリポジトリに最も適している。多言語の場合は言語ごとにグラフを構築して手動でリンクする

ドメイングラフが空になる

/docs パスに抽出器が認識できるコンテンツがなかった。/README や /design-docs で試してみる

出力が密すぎて読めない

詳細レベルを下げる。またはグラフ全体ではなく機能サブグラフにフィルタリングする

代替案

Understand-Anything 他との比較

代替案代わりに使う場面トレードオフ
graphify-skillより軽量なコードグラフスキルが欲しいときドメイングラフの機能が少ない
Sourcegraphエンタープライズグレードのコード検索と GUI が必要なとき有料。セットアップのオーバーヘッドがある

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

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