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

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

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

使い方

/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

基本例

# セキュリティとパフォーマンスの両面分析 (通常)
/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 ロール分析の場合

マルチロール分析: 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 ロール分析の場合

マルチロール分析: 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 週間

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

セキュリティ重視

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

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

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

パフォーマンス重視

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

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

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

ユーザー体験重視

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

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

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

包括的分析

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

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

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

Claude との連携

# ファイル分析と組み合わせ
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"
• その他の強調表現

実行フロー

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

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

効果的な使用例

# 大規模システムの総合評価
/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 手法・認知バイアス対策も含む
• ロール固有のトリガーフレーズで自動的に特化モードが有効化