element-relationship-analyzer

# Element Relationship Analyzer

## 概要

このSkillは、プラグイン内の要素（エージェント、スキル、コマンド）間の依存関係や呼び出し順序を分析する。プラグインの整合性を確認し、循環依存やアーキテクチャ違反を検出して、適切な依存関係の構築を支援する。

## 責任範囲

このSkillは以下の範囲をカバーする:

- プラグイン要素（エージェント、スキル、コマンド）の収集
- 要素間の依存関係の分析
- 要素の呼び出し順序の分析
- 循環依存の検出と報告
- アーキテクチャ規約違反の検出
- 依存関係の最適化提案

## ワークフロー

### フェーズ1: 要素収集

プラグインディレクトリから全ての要素を収集し、基本情報を抽出する。

**実施内容:**

1. プラグインディレクトリ構造を確認する
2. エージェントファイルを収集する
3. スキルファイルを収集する
4. コマンドファイルを収集する
5. 各要素のフロントマター情報を抽出する

**収集対象:**

- エージェント: `agents/[agent-name].md`
- スキル: `skills/*/SKILL.md`
- コマンド: `commands/[command-name].md`

**抽出情報:**

- name（要素名）
- description（説明）
- tools（エージェントのみ）
- 依存する要素の参照（本文中のエージェント名、スキル名、コマンド名）

**良い例:**

```markdown
【要素収集結果】

プラグイン名: database-design-plugin
プラグインディレクトリ: D:\projects\database-design-plugin

エージェント (1個):
- database-design-agent
  - 説明: データベース設計フェーズ全体に対する責任を持つ
  - tools: "*"

スキル (7個):
ワークフロースキル:
- entity-definition-collector
  - 説明: エンティティ定義を収集する
- normalization-processor
  - 説明: 正規化を実施する
- er-diagram-generator
  - 説明: ER図を生成する
- table-definition-writer
  - 説明: テーブル定義書を作成する
- ddl-script-generator
  - 説明: DDLスクリプトを生成する

コンベンションスキル:
- database-naming-conventions
  - 説明: データベース命名規則を定義
- normalization-rules
  - 説明: 正規化ルールを定義

コマンド (2個):
- design-database
  - 説明: データベース設計全体を実行
- generate-schema
  - 説明: スキーマ定義のみを生成
```

**悪い例:**

```markdown
【要素収集結果】

何かある
```

### フェーズ2: 依存関係分析

各要素が参照する他の要素を分析し、依存関係を明確にする。

**実施内容:**

1. 各要素のドキュメント本文を解析する
2. 他の要素への参照を検出する
3. 依存関係マップを作成する
4. 依存の種類を分類する（必須依存、オプション依存）
5. 依存の方向を確認する（エージェント→スキル、スキル→スキル、コマンド→エージェント/スキル）

**依存関係の検出方法:**

- エージェント: 本文中のスキル名参照
- スキル: 本文中の他のスキル名参照（※プラグインアーキテクチャ規約では推奨されない）
- コマンド: 「使用するエージェント」「使用するスキル」セクションからの参照

**良い例:**

```markdown
【依存関係分析結果】

コマンド: design-database
- 使用するエージェント:
  - database-design-agent（必須）
- 使用するスキル:
  - entity-definition-collector（必須）
  - normalization-processor（必須）
  - er-diagram-generator（必須）
  - table-definition-writer（必須）
  - ddl-script-generator（必須）
  - database-naming-conventions（必須）
  - normalization-rules（必須）

コマンド: