understandcommit 08d16bdSKILL.md · アーキテクチャ改善
コード知識グラフ
コードを解析し、ファイル、関係、層、ツアーを含む knowledge-graph.json を .ua/ に生成して可視化に使います。
初回はプラグインのディレクトリで pnpm install とビルドを実行します。大きなコードベースでは多数のサブエージェントを使い時間がかかります。
npx skills add Egonex-AI/Understand-Anything --skill understandコマンドを選択しました。手動でコピーしてください。
- 権限
- read-repo
- write-files
- shell
- network
- 対応ツール
- Claude Code, Codex, Cursor, Copilot, Gemini CLI
- GitHub
- 89.5k
- 提供元
- コミュニティ · Egonex-AI
- 状態
- スキャン済み
- ライセンス
- MIT
- カテゴリ
- アーキテクチャ改善
基本ルール
エラーを黙って捨てず、すべての失敗を最終レポートに示します。
実行フェーズ
フェーズ 01事前確認
プロジェクトルートと .ua/ を決め、必要ならプラグインをビルドし、既存グラフから全体解析か差分更新かを判断します。
フェーズ 02スキャンと分割
.understandignore と --exclude に従ってファイルを走査し、言語とフレームワークを特定して意味単位のバッチに分けます。
フェーズ 03ファイル解析
最大 5 つのサブエージェントで各バッチを並行解析し、ノードとエッジに統合してグラフを検査します。
フェーズ 04レイヤーとツアー
アーキテクチャのレイヤーを特定し、ガイド付きツアーを作ってからグラフ全体を検証します。
フェーズ 05保存と報告
グラフ、フィンガープリント、meta.json を保存し、中間ファイルを片付けて集計を報告します。検証に通ればダッシュボードを開きます。
権限の説明(SKILL.md より)
| 機能 | 必要か | 説明 |
|---|---|---|
| ファイル書き込み | 一部で必要 | プロジェクトの .ua/(旧 .understand-anything/)内にのみグラフ、設定、中間ファイルを書き、ソースは変更しません。 |
| コマンド実行 | 必要 | git、同梱の Node・Python スクリプトを実行し、初回は pnpm install とビルドを行います。 |
| 外部通信 | 一部で必要 | プラグイン未ビルド時に pnpm install で依存を取得するだけで、解析自体は通信しません。 |
SKILL.md のフロントマター(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>]"]
---関連スキル
ルールスキャンですべてのリスクを検出できるわけではありません。インストール前にこのスキルの SKILL.md を読み、権限を確認してください。