新しいチームに加入し、20万行のコードに直面した時、どこから読み始めるべきか？多くの人の答えは、入社初日に無目的に探索を始めて、3ヶ月後にようやくシステムがどう動作するかが曖昧にわかることです。

Understand Anything は、一つのコマンドでこの問題を解決します：/understand。これにより、複数のAgentのパイプラインがあなたのプロジェクト全体をスキャンし、インタラクティブな知識グラフを構築します——各ファイル、関数、クラスはクリック可能なノードとなり、依存関係が一目でわかります。

GitHub 23kスタア、MITライセンス、Claude Code、Codex、Cursor、Copilotなどの14つのエンコーディングAgentプラットフォームをサポート。

この記事では何をカバーしています

• 核心機能
• どのようにインストールおよび使用するか
• 技術アーキテクチャ（tree-sitter + LLM 混合ソリューション）
• 対応プラットフォーム
• 適用シーン

核心機能

1. 構造化コード図譜

コードリポジトリをインタラクティブな知識図譜に変換します。各ファイル、関数、クラスはノードであり、依存関係は辺です。どのノードをクリックしてもコード、関係性、英語での説明を確認できます。ズーム、検索、ナビゲーションをサポートしています。

2. ビジネス領域ビュー

domainビューに切り替えると、コードが実際のビジネスプロセスにどのようにマッピングされるかを確認できます——領域、プロセス、ステップは水平図譜で表示されます。単に「このファイルがあのファイルを呼び出している」というだけでなく、「このプロセスが注文支払いのセグメントに対応する」というものです。

3. 知識ベース分析

はコードだけでなく、KarpathyモデルのLLMウィキ知識ベースを分析することもできます。ウィキリンクとカテゴリを解析し、LLMは隠れた関係を発見し、ウィキをナビゲーション可能な知識グラフに変えます。

4. ガイドツアー（Guided Tours）

依存関係の順序で並べられたアーキテクチャガイドを自動生成します。ガイドのようにコードベースを理解する——まずインフラストラクチャを見て、次に核心的なロジックを見て、最後にビジネスレイヤーを見ます。

5. 変更影響分析

コミット前に、あなたの変更がシステムのどの部分に影響するかを見ます。直接の依存関係だけでなく、連鎖的な影響も含まれます。

6. 语义検索

曖昧検索 + 语义検索。『認証を処理する部分はどれですか？』と検索すると、グラフを越えて関連する結果が返されます。

7. アーキテクチャレベルの可視化

API / サービス / データ / UI / ユーティリティに分けて自動的に色分け。

8. 複数言語出力

中国語の知識グラフを生成するサポート：

/understand --language zh

en、zh、zh-TW、ja、ko、ruをサポート。

インストールと使用

Claude Code（ネイティブプラグイン）

/plugin marketplace add Lum1104/Understand-Anything
/plugin install understand-anything

一行でインストール（Codex / Cursor / Copilot / Gemini CLI / OpenCode / 他）

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.sh | bash

# 指定平台
curl -fsSL ... | bash -s codex

# Windows PowerShell
iwr -useb https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.ps1 | iex

サポートされるplatform値：codex、gemini、opencode、openclaw、cursor、vscode、copilot、pi、hermes、cline、kimi、antigravity、vibe。

は核心コマンドで、

増分更新

既存のファイルの変更のみ再分析し、毎回全量スキャンしない：

/understand  # 增量更新
/understand src/frontend  # 限定子目录（monorepo 场景）

自動更新

post-commit hookを有効にして、コミットごとにグラフを自動更新：

/understand --auto-update

チーム共有

グラフはJSONファイル（.understand-anything/knowledge-graph.json）であり、Gitにプッシュ後にチームメンバーが直接使用でき、分析手順をスキップ：

# 提交图谱
git add .understand-anything/

# 大图谱（10MB+）用 Git LFS
git lfs track ".understand-anything/*.json"

技術アーキテクチャ

tree-sitter + LLM混合方案

はこのプロジェクトで最も洗練された設計です。静的解析とLLMはそれぞれ得意なことをやります：

tree-sitter（確定層）
- ソースコードを具体的な構文木として解析
- 構造化事実を抽出：import、export、関数/クラス定義、呼び出しポイント、継承関係
- プリ解析してimportMapにし、ファイル解析器に渡し、重複した導出を避ける
- 同じ入力 → 同じ出力、毎回の実行が一貫
- ファイルの変更を検出する指紋検知をサポートし、増分更新を実現

LLM（意味層）
- 解析された構造と原始ソースコードを読み取る
- パーサーが提供できないものを生成：英語の要約、タグ、アーキテクチャの階層化、ビジネス領域のマッピング、ガイド、プログラミングの概念の説明

この分工により、グラフは構造的レベルで再現可能になり（同じコードが同じエッジを生成する）、同時に意味的レベルで意図を捉えることができる（ファイルが何のために使われるかを知るだけでなく、importしているものを知る）。

マルチエージェントパイプライン

/understand コマンドの编排 6つの専用エージェント：

ファイル分析器は並列実行（最大5つ同時、各バッチ20-30個のファイル）、増分更新をサポートします。

サポートされるtree-sitter言語

C、C++、C#、Go、Java、JavaScript/TypeScript、PHP、Python、Ruby、Rust。

サポートされるプラットフォーム

技術スタック

• TypeScript — 全スタック実装
• pnpmモノレポ — パッケージ管理
• tree-sitter — 12種類の言語の確実な解析
• Vitest — テストフレームワーク
• MITライセンスオープンソース

他のコード理解ツールとの比較

「Understand Anything」の特徴はコードの理解を視覚的な学習プロセスとして変える点、単なる検索やインデックスツールではないことです

適用シナリオ

• 新入社員採用：/understand-onboard 依存関係の順序に従った学習パスの生成
• 大規模プロジェクトの引き継ぎ：20万行のコード、一度のスキャンで全体のアーキテクチャを理解
• コードレビュー：/understand-diff コードを提出前に変更の影響範囲を確認
• ビジネスの理解：/understand-domain コードとビジネスフローへの対応を確認
• 知識管理：/understand-knowledge チームのwikiをナビゲーション可能なグラフに変換
• Monorepoのナビゲーション：/understand src/frontend 限定範囲分析

著者: itech001
出典: 公众号：AI人工知能時代
ウェブサイト: https://www.theaiera.cn/
毎日、最も先進的なAIニュース情報と技術研究を共有します。

本稿はAI人工知能時代で初めて掲載されました。転載する場合は出典を明記してください。