ロール選択のガイドとヘルプ

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

使い方

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 で自動提案を受けることをおすすめします
• 最終的な判断はユーザーが問題の性質を考慮して決定してください