Multi Role

---
description: "複数のロールで同じ対象を並行分析し統合レポートを生成する。「複数の視点で分析して」「マルチロールで」「並行分析して」「セキュリティとパフォーマンス両方チェック」などで起動。"
allowed-tools:
  - Read
  - Grep
  - Glob
---

# 複数ロールで並行分析し統合レポートを生成

複数のロールで同じ対象を並行分析し、統合レポートを生成するコマンド。

## 使い方

```bash
/multi-role <ロール 1>,<ロール 2> [--agent|-a] [分析対象]
/multi-role <ロール 1>,<ロール 2>,<ロール 3> [--agent|-a] [分析対象]
```

## 利用可能なロール

### 専門分析ロール

- `security` : セキュリティ監査専門家
- `performance` : パフォーマンス最適化専門家
- `analyzer` : 根本原因分析専門家
- `frontend` : フロントエンド・UI/UX 専門家
- `mobile` : モバイル開発専門家
- `backend` : バックエンド開発専門家

### 開発支援ロール

- `reviewer` : コードレビュー専門家
- `architect` : システムアーキテクト
- `qa` : テストエンジニア

## オプション

- `--agent` または `-a` : 各ロールをサブエージェントとして並列実行 (大規模分析時推奨)
  - このオプションを使用すると、各ロールの description に自動委任促進フレーズ ("use PROACTIVELY" など) が含まれている場合、より積極的な自動委任が有効になります

**重要**:

- `--agent` オプションはロール指定の直後に配置してください
- メッセージは `--agent` の後に記述してください
- 正しい例: `/multi-role qa,architect --agent 計画を評価して`
- 間違った例: `/multi-role qa,architect 計画を評価して --agent`

## 基本例

```bash
# セキュリティとパフォーマンスの両面分析 (通常)
/multi-role security,performance
「この API エンドポイントを評価して」

# 大規模システムの並列分析 (サブエージェント)
/multi-role security,performance --agent
「システム全体のセキュリティとパフォーマンスを包括的に分析」

# フロントエンド・モバイル・パフォーマンスの統合分析
/multi-role frontend,mobile,performance
「この画面の最適化案を検討して」

# アーキテクチャ設計の多角的評価 (サブエージェント)
/multi-role architect,security,performance --agent
「マイクロサービス化の設計を評価して」
```

## 分析プロセス

## Phase 1: 並行分析

各ロールが独立して同じ対象を分析

- 専門視点からの評価実行
- ロール固有の基準で判定
- 独立した推奨事項の生成

## Phase 2: 統合分析

結果を構造化して統合

- 各ロールの評価結果整理
- 重複・矛盾点の特定
- 補完関係の明確化

## Phase 3: 統合レポート

最終的な推奨事項の生成

- 優先度付きアクションプラン
- トレードオフの明示
- 実装ロードマップ提示

## 出力フォーマット例

## 2 ロール分析の場合

```text
マルチロール分析: Security + Performance
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

分析対象: API エンドポイント /api/users

Security 分析結果:
認証: JWT 検証が適切に実装
認可: ロールベースアクセス制御が不完全
暗号化: API キーが平文でログ出力

評価スコア: 65/100
重要度: High(機密データアクセスのため)

Performance 分析結果:
レスポンス時間: 平均 180ms(目標 200ms 以内)
データベースクエリ: N+1 問題を検出
キャッシュ: Redis キャッシュ未実装

評価スコア: 70/100
重要度: Medium(現状は許容範囲内)

相互関連分析:
相乗効果の機会:
- Redis キャッシュ実装時に暗号化も同時考慮
- ログ出力の改善でセキュリティ＋パフォーマンス向上

トレードオフポイント:
- 認可チェック強化 ↔ レスポンス時間への影響
- ログ暗号化 ↔ デバッグ効率の低下

統合優先度:
Critical: API キー平文出力の修正
High: N+1 クエリの解決
Medium: Redis キャッシュ + 暗号化の実装
Low: 認可制御の詳細化

実装ロードマップ:
週 1: API キーのマスキング実装
週 2: データベースクエリ最適化
週 3-4: キャッシュレイヤーの設計・実装
月 2: 認可制御の段階的強化
```

## 3 ロール分析の場合

```text
マルチロール分析: Frontend + Mobile + Performance
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

分析対象: ユーザープロフィール画面

Frontend 分析結果:
ユーザビリティ: 直感的なレイアウト
アクセシビリティ: WCAG 2.1 準拠率 85%
レスポンシブ: タブレット表示に課題

Mobile 分析結果:
タッチターゲット: 44pt 以上確保
片手操作: 重要ボタンが上部に配置
オフライン対応: 未実装

Performance 分析結果:
初期表示: LCP 2.1 秒 (良好)
画像最適化: WebP 未対応
遅延読み込み: 未実装

統合推奨事項:
1. モバイル最適化 (片手操作 + オフライン対応)
2. 画像最適化 (WebP + 遅延読み込み)
3. タブレット UI の改善

優先度: Mobile > Performance > Frontend
実装期間: 3-4 週間
```

## 効果的な組み合わせパターン

## セキュリティ重視

```bash
/multi-role security,architect
「認証システムの設計」

/multi-role security,frontend
「ログイン画面のセキュリティ」

/multi-role security,mobile
「モバイルアプリのデータ保護」
```

## パフォーマンス重視

```bash
/multi-role performance,architect
「スケーラビリティ設計」

/multi-role performance,frontend
「Web ページの高速化」

/multi-role performance,mobile
「アプリの動作最適化」
```

## ユーザー体験重視

```bash
/multi-role frontend,mobile
「クロスプラットフォーム UI」

/multi-role frontend,performance
「UX とパフォーマンスのバランス」

/multi-role mobile,performance
「モバイル UX の最適化」
```

## 包括的分析

```bash
/multi-role architect,security,performance
「システム全体の評価」

/multi-role frontend,mobile,performance
「ユーザー体験の総合評価」

/multi-role security,performance,mobile
「モバイルアプリの総合診断」
```

## Claude との連携

```bash
# ファイル分析と組み合わせ
cat src/components/UserProfile.tsx
/multi-role frontend,mobile
「このコンポーネントを複数の視点で評価して」

# 設計ドキュメントの評価
cat architecture-design.md
/multi-role architect,security,performance
「この設計を複数の専門分野で評価して」

# エラー分析
cat performance-issues.log
/multi-role performance,analyzer
「パフォーマンス問題を多角的に分析して」
```

## multi-role vs role-debate の使い分け

## multi-role を使う場面

- 各専門分野の独立した評価が欲しい
- 統合的な改善計画を立てたい
- 矛盾や重複を整理したい
- 実装優先度を決めたい

## role-debate を使う場面

- 専門分野間でトレードオフがある
- 技術選定で意見が分かれそう
- 設計方針を議論で決めたい
- 異なる視点での議論を聞きたい

## サブエージェント並列実行 (--agent)

`--agent` オプションを使用すると、各ロールが独立したサブエージェントとして並列実行されます。

### 自動委任の促進

ロールファイルの description フィールドに以下のようなフレーズが含まれている場合、`--agent` 使用時により積極的な自動委任が有効化されます：

- "use PROACTIVELY"
- "MUST BE USED"
- その他の強調表現

### 実行フロー

```text
通常実行:
ロール 1 → ロール 2 → ロール 3 → 統合
(順次実行、約 3-5 分)

--agent 実行:
ロール 1 ─┐
ロール 2 ─┼→ 統合
ロール 3 ─┘
(並列実行、約 1-2 分)
```

### 効果的な使用例

```bash
# 大規模システムの総合評価
/multi-role architect,security,performance,qa --agent
「新システムの包括的評価」

# 複数観点での詳細分析
/multi-role frontend,mobile,performance --agent
「全画面の UX 最適化分析」
```

### パフォーマンス比較

| ロール数 | 通常実行 | --agent 実行 | 短縮率 |
| -------- | -------- | ------------ | ------ |
| 2 ロール | 2-3 分   | 1 分         | 50%    |
| 3 ロール | 3-5 分   | 1-2 分       | 60%    |
| 4 ロール | 5-8 分   | 2-3 分       | 65%    |

## 注意事項

- 3 つ以上のロールを同時実行すると出力が長くなります
- 複雑な分析ほど実行時間が長くなる可能性があります
- 相互矛盾する推奨事項が出た場合は、role-debate も検討してください
- 最終的な判断は統合結果を参考にユーザーが行ってください
- **--agent 使用時**: より多くのリソースを使用しますが、大規模分析では効率的です

## ロール設定の詳細

- 各ロールの詳細設定・專門知識・議論特性は `.claude/agents/roles/` ディレクトリ内で定義
- Evidence-First 手法・認知バイアス対策も含む
- ロール固有のトリガーフレーズで自動的に特化モードが有効化