## Role Help

どのロールを使うべきか迷った時の選択ガイドとヘルプシステム。

### 使い方

```bash
/role-help                      # 全般的なロール選択ガイド
/role-help <状況/問題>          # 特定状況での推奨ロール
/role-help compare <ロール 1>,<ロール 2> # ロール比較
```

### 基本例

```bash
# 一般的なガイダンス
/role-help
→ 利用可能なロールと特徴の一覧表示

# 状況別の推奨
/role-help "API のセキュリティが心配"
→ security ロールの推奨と使用方法

# ロール比較
/role-help compare frontend,mobile
→ frontend と mobile の違いと使い分け
```

### 状況別ロール選択ガイド

### セキュリティ関連

```text
こんな時は security ロール:
✅ ログイン・認証機能の実装
✅ API のセキュリティ脆弱性チェック
✅ データ暗号化・プライバシー保護
✅ セキュリティコンプライアンス確認
✅ 侵入テスト・ペネトレーションテスト

使い方: /role security
```

### 🏗️ アーキテクチャ・設計

```text
こんな時は architect ロール:
✅ システム全体の設計評価
✅ マイクロサービス vs モノリス判断
✅ データベース設計・技術選定
✅ スケーラビリティ・拡張性の検討
✅ 技術的負債の評価・改善計画

使い方: /role architect
```

### ⚡ パフォーマンス問題

```text
こんな時は performance ロール:
✅ アプリケーションが遅い
✅ データベースクエリの最適化
✅ Web ページの読み込み速度改善
✅ メモリ・CPU 使用量の最適化
✅ スケーリング・負荷対策

使い方: /role performance
```

### 🔍 問題の原因調査

```text
こんな時は analyzer ロール:
✅ バグ・エラーの根本原因分析
✅ システム障害の原因究明
✅ 複雑な問題の構造的分析
✅ データ分析・統計的調査
✅ なぜこの問題が起きたかの解明

使い方: /role analyzer
```

### 🎨 フロントエンド・UI/UX

```text
こんな時は frontend ロール:
✅ ユーザーインターフェースの改善
✅ アクセシビリティ対応
✅ レスポンシブデザイン
✅ ユーザビリティ・使いやすさ向上
✅ Web フロントエンド技術全般

使い方: /role frontend
```

### 📱 モバイルアプリ開発

```text
こんな時は mobile ロール:
✅ iOS ・Android アプリの最適化
✅ モバイル特有の UX 設計
✅ タッチインターフェース最適化
✅ オフライン対応・同期機能
✅ App Store ・Google Play 対応

使い方: /role mobile
```

### 👀 コードレビュー・品質

```text
こんな時は reviewer ロール:
✅ コードの品質チェック
✅ 可読性・保守性の評価
✅ コーディング規約の確認
✅ リファクタリング提案
✅ PR ・コミットのレビュー

使い方: /role reviewer
```

### 🧪 テスト・品質保証

```text
こんな時は qa ロール:
✅ テスト戦略の立案
✅ テストカバレッジの評価
✅ 自動テストの実装方針
✅ バグ防止・品質向上策
✅ CI/CD でのテスト自動化

使い方: /role qa
```

### 複数ロールが必要な場合

### 🔄 multi-role (並行分析)

```text
こんな時は multi-role:
✅ 複数の専門視点での評価が欲しい
✅ 統合的な改善計画を立てたい
✅ 各分野の評価を比較したい
✅ 矛盾・重複を整理したい

例: /multi-role security,performance
```

### 🗣️ role-debate (議論)

```text
こんな時は role-debate:
✅ 専門分野間でトレードオフがある
✅ 技術選定で意見が分かれる
✅ 設計方針を議論で決めたい
✅ 異なる視点の議論を聞きたい

例: /role-debate security,performance
```

### 🤖 smart-review (自動提案)

```text
こんな時は smart-review:
✅ どのロールを使うべきか分からない
✅ 現在の状況に最適なアプローチを知りたい
✅ 複数の選択肢から選びたい
✅ 初心者で判断に迷う

例: /smart-review
```

### ロール比較表

### セキュリティ系

| ロール   | 主な用途         | 得意分野             | 苦手分野           |
| -------- | ---------------- | -------------------- | ------------------ |
| security | 脆弱性・攻撃対策 | 脅威分析、認証設計   | UX、パフォーマンス |
| analyzer | 根本原因分析     | 論理的分析、証拠収集 | 予防策、将来計画   |

### 設計系

| ロール    | 主な用途     | 得意分野           | 苦手分野           |
| --------- | ------------ | ------------------ | ------------------ |
| architect | システム設計 | 長期視点、全体最適 | 詳細実装、短期解決 |
| reviewer  | コード品質   | 実装レベル、保守性 | ビジネス要件、UX   |

### パフォーマンス系

| ロール      | 主な用途       | 得意分野           | 苦手分野             |
| ----------- | -------------- | ------------------ | -------------------- |
| performance | 高速化・最適化 | 測定、ボトルネック | セキュリティ、UX     |
| qa          | 品質保証       | テスト、自動化     | 設計、アーキテクチャ |

### ユーザー体験系

| ロール   | 主な用途    | 得意分野                   | 苦手分野            |
| -------- | ----------- | -------------------------- | ------------------- |
| frontend | Web UI/UX   | ブラウザ、アクセシビリティ | サーバーサイド、DB  |
| mobile   | モバイル UX | タッチ、オフライン対応     | サーバーサイド、Web |

### 迷った時のフローチャート

```text
問題の性質は？
├─ セキュリティ関連 → security
├─ パフォーマンス問題 → performance
├─ バグ・障害調査 → analyzer
├─ UI/UX 改善 → frontend or mobile
├─ 設計・アーキテクチャ → architect
├─ コード品質 → reviewer
├─ テスト関連 → qa
└─ 複合的・複雑 → smart-review で提案

複数の分野にまたがる？
├─ 統合分析したい → multi-role
├─ 議論・トレードオフ → role-debate
└─ 判断に迷う → smart-review
```

### よくある質問

### Q: frontend と mobile の違いは？

```text
A:
frontend: Web ブラウザ中心、HTML/CSS/JavaScript
mobile: モバイルアプリ中心、iOS/Android ネイティブ・React Native など

両方関連する場合は multi-role frontend,mobile がおすすめ
```

### Q: security と analyzer の使い分けは？

```text
A:
security: 攻撃・脅威の予防、セキュリティ設計
analyzer: 既に起きた問題の原因分析、調査

セキュリティインシデントの調査なら multi-role security,analyzer
```

### Q: architect と performance の違いは？

```text
A:
architect: システム全体の長期的設計、拡張性
performance: 具体的な速度・効率の改善

大規模システムの性能設計なら multi-role architect,performance
```

### Claude との連携

```bash
# 状況説明と組み合わせ
/role-help
「React アプリのページ読み込みが遅くて、ユーザーから苦情が来ている」

# ファイル内容と組み合わせ
cat problem-description.md
/role-help
「この問題に最適なロールを推奨して」

# 特定の選択肢で迷っている場合
/role-help compare security,performance
「JWT トークンの有効期限問題でどちらのロールが適切？」
```

### 注意事項

- 複雑な問題ほど複数ロールの組み合わせが効果的です
- 緊急性が高い場合は single role で迅速に対応
- 迷った時は smart-review で自動提案を受けることをおすすめします
- 最終的な判断はユーザーが問題の性質を考慮して決定してください