315 lines
9.1 KiB
Markdown
315 lines
9.1 KiB
Markdown
## Multi Role
|
|
|
|
複数のロールで同じ対象を並行分析し、統合レポートを生成するコマンド。
|
|
|
|
### 使い方
|
|
|
|
```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 手法・認知バイアス対策も含む
|
|
- ロール固有のトリガーフレーズで自動的に特化モードが有効化
|