# コード知識グラフ (understand)

> コードを解析し、ファイル、関係、層、ツアーを含む knowledge-graph.json を .ua/ に生成して可視化に使います。

- カテゴリ: [アーキテクチャ改善](https://www.myskills.tools/ja/categories/architecture-tuning/)
- 提供元: コミュニティ · Egonex-AI
- リポジトリ: https://github.com/Egonex-AI/Understand-Anything/tree/main/understand-anything-plugin/skills/understand (commit 08d16bd)
- SKILL.md: https://github.com/Egonex-AI/Understand-Anything/blob/main/understand-anything-plugin/skills/understand/SKILL.md
- インストールコマンド: `npx skills add Egonex-AI/Understand-Anything --skill understand`
- ライセンス: MIT
- 対応ツール: Claude Code, Codex, Cursor, Copilot, Gemini CLI
- 権限: read-repo ✓, write-files ✓, shell ✓, network ✓
- 状態: スキャン済み
- ルールスキャンですべてのリスクを検出できるわけではありません。インストール前にこのスキルの SKILL.md を読み、権限を確認してください。
- ⚠ 初回はプラグインのディレクトリで pnpm install とビルドを実行します。大きなコードベースでは多数のサブエージェントを使い時間がかかります。

## 基本ルール

エラーを黙って捨てず、すべての失敗を最終レポートに示します。

## 実行フェーズ

1. **事前確認** — プロジェクトルートと .ua/ を決め、必要ならプラグインをビルドし、既存グラフから全体解析か差分更新かを判断します。
2. **スキャンと分割** — .understandignore と --exclude に従ってファイルを走査し、言語とフレームワークを特定して意味単位のバッチに分けます。
3. **ファイル解析** — 最大 5 つのサブエージェントで各バッチを並行解析し、ノードとエッジに統合してグラフを検査します。
4. **レイヤーとツアー** — アーキテクチャのレイヤーを特定し、ガイド付きツアーを作ってからグラフ全体を検証します。
5. **保存と報告** — グラフ、フィンガープリント、meta.json を保存し、中間ファイルを片付けて集計を報告します。検証に通ればダッシュボードを開きます。

## 権限の説明（SKILL.md より）

| 機能 | 必要か | 説明 |
|---|---|---|
| ファイル書き込み | 一部で必要 | プロジェクトの .ua/（旧 .understand-anything/）内にのみグラフ、設定、中間ファイルを書き、ソースは変更しません。 |
| コマンド実行 | 必要 | git、同梱の Node・Python スクリプトを実行し、初回は pnpm install とビルドを行います。 |
| 外部通信 | 一部で必要 | プラグイン未ビルド時に pnpm install で依存を取得するだけで、解析自体は通信しません。 |

## SKILL.md のフロントマター（YAML）

```yaml
---
name: understand
description: Analyze a codebase to produce an interactive knowledge graph for understanding architecture, components, and relationships
argument-hint: ["[path] [--full|--auto-update|--no-auto-update|--review|--language <lang>|--exclude <patterns>]"]
---
```

ホーム: https://www.myskills.tools/ja/ · URL: https://www.myskills.tools/ja/skills/understand/