Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Latest commit

 

History

History
325 lines (235 loc) · 15.2 KB

File metadata and controls

325 lines (235 loc) · 15.2 KB

Understand Anything

あらゆるコードベース、ナレッジベース、ドキュメントを、探索・検索・質問ができるインタラクティブなナレッジグラフに変換します。
Claude Code、Codex、Cursor、Copilot、Gemini CLI など、マルチプラットフォーム対応。

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Türkçe

Star History Rank

クイックスタート License: MIT Claude Code Codex Copilot Copilot CLI Gemini CLI OpenCode ホームページ ライブデモ

Understand Anything — あらゆるコードベースをインタラクティブなナレッジグラフに変換


Tip

コミュニティの皆さんに感謝! Understand-Anythingへのサポートは本当に素晴らしいものです。このツールが複雑なコードを理解する時間を少しでも短縮できたなら、それが私の望みです。🚀

新しいチームに参加したばかり。コードベースは20万行。どこから手をつければいいのか?

Understand Anything は Claude Code プラグインです。マルチエージェントパイプラインでプロジェクトを分析し、すべてのファイル・関数・クラス・依存関係のナレッジグラフを構築して、インタラクティブなダッシュボードで視覚的に探索できるようにします。コードを闇雲に読むのはやめて、全体像を把握しましょう。

寓教於楽のグラフ > 見栄えだけのグラフ。


✨ 機能

Note

すぐに試したいですか? ホームページライブデモをお試しください — パン、ズーム、検索、探索ができる完全インタラクティブなダッシュボードです。

コード構造グラフを探索

コードベースをインタラクティブなナレッジグラフとして表示——すべてのファイル、関数、クラスがクリック・検索・探索可能なノードです。ノードを選択すると、わかりやすい要約、依存関係、ガイド付きツアーが表示されます。

構造グラフ——ファイル、関数、クラスとその関係を探索

ビジネスロジックを理解

ドメインビューに切り替えると、コードが実際のビジネスプロセスにどう対応するかが一目でわかります——ドメイン、フロー、ステップが横方向のグラフとして表示されます。

ドメイングラフ——ビジネスドメイン、フロー、プロセスステップ

ナレッジベースを分析

/understand-knowledgeKarpathy パターンの LLM Wiki に向けると、コミュニティクラスタリング付きのフォースディレクテッドナレッジグラフが生成されます。決定論的パーサーが index.md から wikilinks とカテゴリを抽出し、LLM エージェントが暗黙の関係を発見、エンティティを抽出、主張を浮き彫りにして、wiki をナビゲート可能な相互接続されたアイデアのグラフに変換します。

🧭 ガイドツアー

依存関係順に並べられた、自動生成のアーキテクチャウォークスルー。正しい順序でコードベースを学べます。

🔍 ファジー&セマンティック検索

名前や意味で何でも検索できます。「認証を処理する部分は?」と検索すれば、グラフ全体から関連する結果が得られます。

📊 差分影響分析

コミット前に、変更がシステムのどの部分に影響するかを確認。コードベース全体への波及効果を把握できます。

🎭 ペルソナ適応型UI

ダッシュボードは、ジュニア開発者・PM・パワーユーザーなど、ユーザーに応じて詳細レベルを調整します。

🏗️ レイヤー可視化

API・Service・Data・UI・Utilityなどのアーキテクチャ層ごとに自動グループ化。色分けされた凡例付き。

📚 言語コンセプト

ジェネリクス・クロージャ・デコレータなど12のプログラミングパターンが、出現箇所のコンテキストで説明されます。


🚀 クイックスタート

1. プラグインをインストール

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

2. コードベースを分析

/understand

マルチエージェントパイプラインがプロジェクトをスキャンし、すべてのファイル・関数・クラス・依存関係を抽出して、.understand-anything/knowledge-graph.json にナレッジグラフを保存します。

3. ダッシュボードで探索

/understand-dashboard

インタラクティブなWebダッシュボードが開き、コードベースがグラフとして可視化されます。アーキテクチャ層ごとに色分けされ、検索やクリックが可能です。ノードを選択すると、コード・関連関係・平易な説明が表示されます。

4. さらに学ぶ

# コードベースについて何でも質問
/understand-chat 支払いフローはどう動いているの?

# 現在の変更の影響を分析
/understand-diff

# 特定のファイルや関数を詳しく調べる
/understand-explain src/auth/login.ts

# 新メンバー向けのオンボーディングガイドを生成
/understand-onboard

# ビジネスドメイン知識を抽出(ドメイン、フロー、ステップ)
/understand-domain

# Karpathy パターンの LLM Wiki ナレッジベースを分析
/understand-knowledge ~/path/to/wiki

🌐 マルチプラットフォームインストール

Understand-Anythingは複数のAIコーディングプラットフォームで動作します。

Claude Code(ネイティブ)

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

Codex

Codexに以下を伝えてください:

Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.codex/INSTALL.md

OpenCode

OpenCodeに以下を伝えてください:

Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.opencode/INSTALL.md

OpenClaw

OpenClawに以下を伝えてください:

Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.openclaw/INSTALL.md

Cursor

Cursorはこのリポジトリをクローンすると .cursor-plugin/plugin.json 経由でプラグインを自動検出します。手動インストールは不要です — クローンしてCursorで開くだけです。

VS Code + GitHub Copilot

GitHub Copilot拡張機能(v1.108+)をインストールしたVS Codeは、.copilot-plugin/plugin.json 経由でプラグインを自動検出します。クローンしてVS Codeで開くだけで、手動インストールは不要です。

全プロジェクトで使用するパーソナルスキルとして設定する場合は、GitHub Copilotに以下を伝えてください:

Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.vscode/INSTALL.md

Copilot CLI

copilot plugin install Lum1104/Understand-Anything:understand-anything-plugin

Antigravity

Antigravityに以下を伝えてください:

Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.antigravity/INSTALL.md

Gemini CLI

Gemini CLIに以下を伝えてください:

Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.gemini/INSTALL.md

Pi Agent

Pi Agentに以下を伝えてください:

Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.pi/INSTALL.md

プラットフォーム互換性

プラットフォーム ステータス インストール方法
Claude Code ✅ ネイティブ プラグインマーケットプレイス
Codex ✅ サポート AI駆動インストール
OpenCode ✅ サポート AI駆動インストール
OpenClaw ✅ サポート AI駆動インストール
Cursor ✅ サポート 自動検出
VS Code + GitHub Copilot ✅ サポート 自動検出
Copilot CLI ✅ サポート プラグインインストール
Antigravity ✅ サポート AI駆動インストール
Gemini CLI ✅ サポート AI駆動インストール
Pi Agent ✅ サポート AI駆動インストール

📦 チームでグラフを共有する

グラフは単なる JSON ファイルです——一度コミットすれば、チームメンバーはパイプラインを実行せずに済みます。オンボーディング、PR レビュー、docs-as-code ワークフローに最適です。

例: GoogleCloudPlatform/microservices-demo(fork) —— コミット済みのグラフを含む Go / Java / Python / Node のリファレンスプロジェクト。

コミット対象: .understand-anything/ 内のすべてのファイル。ただし intermediate/diff-overlay.json は除きます(これらはローカルの一時ファイルです)。

.understand-anything/intermediate/
.understand-anything/diff-overlay.json

最新状態を保つ: /understand --auto-update を有効にすると、post-commit フックがグラフを増分的に更新し、各コミットに対応するグラフが揃います。またはリリース前に /understand を手動で再実行します。

大きなグラフ(10 MB 以上): git-lfs で管理します。

git lfs install
git lfs track ".understand-anything/*.json"
git add .gitattributes .understand-anything/

🔧 内部の仕組み

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

/understand コマンドは5つの専門エージェントをオーケストレーションし、/understand-domain は6つ目を追加します:

エージェント 役割
project-scanner ファイルの検出、言語やフレームワークの検出
file-analyzer 関数・クラス・インポートの抽出、グラフノードとエッジの生成
architecture-analyzer アーキテクチャ層の特定
tour-builder ガイド学習ツアーの生成
graph-reviewer グラフの完全性と参照整合性の検証
domain-analyzer ビジネスドメイン、フロー、処理ステップの抽出(/understand-domain で使用)
article-analyzer wiki 記事からエンティティ、主張、暗黙の関係を抽出(/understand-knowledge で使用)

ファイルアナライザーは並列実行されます(最大3つ同時)。インクリメンタル更新に対応しており、前回の実行から変更されたファイルのみを再分析します。


🤝 コントリビュート

コントリビュートを歓迎します!始め方は以下の通りです:

  1. リポジトリをフォーク
  2. フィーチャーブランチを作成(git checkout -b feature/my-feature
  3. テストを実行(pnpm --filter @understand-anything/core test
  4. 変更をコミットしてプルリクエストを作成

大きな変更については、まずIssueを作成してアプローチを議論してください。


コードを闇雲に読むのはやめよう。すべてを理解しよう。

Star History

Star History Chart

MIT License © Lum1104