Element Relationship Analyzer

---
name: element-relationship-analyzer
description: プラグイン要素間の依存関係や呼び出し順序を分析する。プラグイン整合性確認時、依存関係検証時、またはユーザーが要素間依存、呼び出し順序、循環依存、アーキテクチャ検証に言及した際に使用する。
---

# 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（必須）

コマンド: generate-schema
- 使用するエージェント:
  - database-design-agent（必須）
- 使用するスキル:
  - entity-definition-collector（必須）
  - normalization-processor（必須）
  - database-naming-conventions（必須）
  - normalization-rules（必須）

エージェント: database-design-agent
- 依存するスキル: なし
  ※アーキテクチャ規約に従い、エージェントは直接スキルを参照しない

スキル: entity-definition-collector
- 依存するスキル: なし
  ※アーキテクチャ規約に従い、スキルは他のスキルを参照しない

スキル: normalization-processor
- 依存するスキル: なし

スキル: er-diagram-generator
- 依存するスキル: なし

スキル: table-definition-writer
- 依存するスキル: なし

スキル: ddl-script-generator
- 依存するスキル: なし

スキル: database-naming-conventions
- 依存するスキル: なし

スキル: normalization-rules
- 依存するスキル: なし
```

**悪い例:**

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

いろいろ依存している
```

### フェーズ3: 呼び出し順序分析

コマンドにおけるスキルの呼び出し順序を分析する。

**実施内容:**

1. 各コマンドの「実行フロー」セクションを解析する
2. スキルの実行順序を抽出する
3. 並列実行可能なスキルを特定する
4. 順次実行が必要なスキルを特定する
5. 実行順序の妥当性を検証する

**分析基準:**

- スキルの実行順序が明確であるか
- 依存関係に基づいた順序になっているか
- 並列実行可能なスキルが適切に識別されているか
- データの受け渡しが明確であるか

**良い例:**

```markdown
【呼び出し順序分析結果】

コマンド: design-database

実行フロー:
1. database-design-agent が entity-definition-collector を使用してエンティティ定義を収集
   - 入力: ユーザーからの要求、既存システムの情報
   - 出力: エンティティ一覧、属性リスト
   - 並列実行: 不可（最初のステップ）

2. database-design-agent が normalization-processor を使用して正規化を実施
   - 入力: エンティティ定義（ステップ1の出力）
   - 出力: 正規化されたテーブル定義
   - 並列実行: 不可（ステップ1に依存）
   - 使用する規約: normalization-rules

3. database-design-agent が以下のスキルを並列実行:
   - er-diagram-generator: ER図を生成
     - 入力: 正規化されたテーブル定義（ステップ2の出力）
     - 出力: ER図（Mermaid形式）
   - table-definition-writer: テーブル定義書を作成
     - 入力: 正規化されたテーブル定義（ステップ2の出力）
     - 出力: テーブル定義書（Markdown形式）
   - ddl-script-generator: DDLスクリプトを生成
     - 入力: 正規化されたテーブル定義（ステップ2の出力）
     - 出力: DDLスクリプト
   - 並列実行: 可能（全てステップ2の出力を使用、相互依存なし）

妥当性: OK
- 各ステップの入力と出力が明確
- 依存関係に基づいた順序
- 並列実行可能なステップが適切に識別されている

コマンド: generate-schema

実行フロー:
1. database-design-agent が entity-definition-collector を使用してエンティティ定義を収集
2. database-design-agent が normalization-processor を使用して正規化を実施

妥当性: OK
- 最小限のステップのみ実行
- 依存関係が明確
```

**悪い例:**

```markdown
【呼び出し順序分析結果】

順番に実行する
```

### フェーズ4: 循環依存検出

要素間の循環依存を検出し、報告する。

**実施内容:**

1. 依存関係グラフを構築する
2. 循環依存を検出するアルゴリズムを実行する
3. 検出された循環依存を報告する
4. 循環依存の影響を評価する
5. 循環依存の解消方法を提案する

**検出方法:**

- 深さ優先探索（DFS）による循環検出
- トポロジカルソートによる順序確認

**良い例:**

```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 スキル

generate-schema コマンド
  ↓
database-design-agent エージェント
  ↓
entity-definition-collector スキル
normalization-processor スキル
database-naming-conventions スキル
normalization-rules スキル

トポロジカルソート結果:
1. database-naming-conventions（コンベンション、依存なし）
2. normalization-rules（コンベンション、依存なし）
3. entity-definition-collector（ワークフロー、コンベンションに依存可能）
4. normalization-processor（ワークフロー、コンベンションに依存可能）
5. er-diagram-generator（ワークフロー、依存なし）
6. table-definition-writer（ワークフロー、依存なし）
7. ddl-script-generator（ワークフロー、依存なし）
8. database-design-agent（エージェント、スキルを使用）
9. design-database（コマンド、エージェントとスキルを使用）
10. generate-schema（コマンド、エージェントとスキルを使用）

アーキテクチャ規約遵守: OK
- エージェントは他の要素を参照していない
- スキルは他のスキルを参照していない
- コマンドのみがエージェントとスキルを参照している
```

**悪い例（循環依存が存在する場合）:**

```markdown
【循環依存検出結果】

循環依存: 検出されました

循環1:
skill-a → skill-b → skill-c → skill-a

問題: スキルが他のスキルを参照している（アーキテクチャ規約違反）
影響: スキルの独立性が損なわれ、再利用性が低下
解消方法:
- スキル間の参照を削除する
- 共通の処理をコンベンションスキルに分離する
- コマンドで依存関係を管理する

循環2:
command-a → agent-b → command-a

問題: コマンドとエージェントが相互参照している
影響: 無限ループの可能性
解消方法:
- エージェントからコマンドへの参照を削除する
- エージェントはスキルのみを使用するようにする
```

### フェーズ5: 推奨提示

分析結果をまとめ、改善提案をユーザーに提示する。

**実施内容:**

1. 分析結果をサマリー化する
2. 検出された問題をリストアップする
3. アーキテクチャ規約の遵守状況を報告する
4. 改善提案を作成する
5. 次のステップを案内する

**提示形式:**

```markdown
【要素関係分析レポート】

プラグイン名: database-design-plugin
分析日時: 2025-11-15

【サマリー】

要素数:
- エージェント: 1個
- スキル: 7個（ワークフロー: 5個、コンベンション: 2個）
- コマンド: 2個

依存関係:
- 総依存数: 14個
- 循環依存: 0個
- アーキテクチャ規約違反: 0個

品質評価: 優良
- 循環依存なし
- アーキテクチャ規約遵守
- 依存関係が明確

【詳細分析結果】

依存関係マップ:
- design-database → database-design-agent, 5つのワークフロースキル, 2つのコンベンションスキル
- generate-schema → database-design-agent, 2つのワークフロースキル, 2つのコンベンションスキル

呼び出し順序:
- design-database: 3ステップ（ステップ3は3つのスキルを並列実行）
- generate-schema: 2ステップ（順次実行）

循環依存: なし

アーキテクチャ規約遵守:
- ✓ エージェントは他の要素を参照していない
- ✓ スキルは他のスキルを参照していない
- ✓ コマンドのみがエージェントとスキルを参照している
- ✓ 依存関係の方向が正しい（コマンド→エージェント→スキル）

【改善提案】

改善点: なし

このプラグインは適切に設計されています。

【推奨事項】

1. 定期的に要素関係を分析し、循環依存が発生していないか確認する
2. 新しい要素を追加する際は、アーキテクチャ規約を遵守する
3. コマンドの実行フローを明確に記述する
4. 並列実行可能なスキルを適切に識別する

【次のステップ】

1. プラグイン全体の品質検証（plugin-validator スキルを使用）
2. プラグインのパッケージング（plugin-packager スキルを使用）
```

**良い例:**

分析結果が明確で、問題点、改善提案、推奨事項が示されている。

**悪い例:**

```markdown
【要素関係分析レポート】

分析した
問題なし
```

## アウトプット

このスキルは以下を生成する:

- **依存関係マップ**: 要素間の依存関係を整理したマッピング
- **呼び出し順序図**: コマンドにおけるスキルの呼び出し順序を図示したドキュメント
- **循環依存レポート**: 検出された循環依存とその解消方法
- **要素関係分析レポート**: 分析結果、問題点、改善提案をまとめたレポート

## 想定されるエラーと対処法

### エラー1: 循環依存が検出された

**検出例:**

```markdown
skill-a → skill-b → skill-a
```

**対処法:**

- スキル間の参照を削除する
- 共通の処理をコンベンションスキルに分離する
- コマンドで依存関係を管理する

### エラー2: アーキテクチャ規約違反

**検出例:**

```markdown
エージェントがスキルを直接参照している
スキルが他のスキルを参照している
```

**対処法:**

- エージェントからスキルへの直接参照を削除する
- スキル間の参照を削除する
- コマンドで依存関係を管理する

### エラー3: 呼び出し順序が不明確

**検出例:**

```markdown
実行フロー: スキルを実行する
```

**対処法:**

- 実行フローを明確に記述する
- スキルの実行順序を番号付きで記述する
- 並列実行可能なスキルを明示する

## ベストプラクティス

- 定期的に要素関係を分析する
- 循環依存を早期に検出して解消する
- アーキテクチャ規約を遵守する
- 依存関係を明確に文書化する
- 呼び出し順序を明示する
- 並列実行可能なスキルを適切に識別する

## チェックリスト

### 要素収集完了時

- [ ] プラグインディレクトリ構造が確認されている
- [ ] エージェントファイルが収集されている
- [ ] スキルファイルが収集されている
- [ ] コマンドファイルが収集されている
- [ ] 各要素のフロントマター情報が抽出されている

### 依存関係分析完了時

- [ ] 各要素のドキュメント本文が解析されている
- [ ] 他の要素への参照が検出されている
- [ ] 依存関係マップが作成されている
- [ ] 依存の種類が分類されている
- [ ] 依存の方向が確認されている

### 呼び出し順序分析完了時

- [ ] 各コマンドの「実行フロー」セクションが解析されている
- [ ] スキルの実行順序が抽出されている
- [ ] 並列実行可能なスキルが特定されている
- [ ] 順次実行が必要なスキルが特定されている
- [ ] 実行順序の妥当性が検証されている

### 循環依存検出完了時

- [ ] 依存関係グラフが構築されている
- [ ] 循環依存検出アルゴリズムが実行されている
- [ ] 検出された循環依存が報告されている
- [ ] 循環依存の影響が評価されている
- [ ] 循環依存の解消方法が提案されている

### 推奨提示完了時

- [ ] 分析結果がサマリー化されている
- [ ] 検出された問題がリストアップされている
- [ ] アーキテクチャ規約の遵守状況が報告されている
- [ ] 改善提案が作成されている
- [ ] 次のステップが案内されている
- [ ] ユーザーの承認を得ている

### 最終確認

- [ ] 依存関係マップが作成されている
- [ ] 呼び出し順序図が作成されている
- [ ] 循環依存レポートが作成されている（該当する場合）
- [ ] 要素関係分析レポートが作成されている
- [ ] すべてのアウトプットが明確で理解しやすい
- [ ] ユーザーが次のステップに進める状態になっている