7.8 KiB
7.8 KiB
Role Help
どのロールを使うべきか迷った時の選択ガイドとヘルプシステム。
使い方
/role-help # 全般的なロール選択ガイド
/role-help <状況/問題> # 特定状況での推奨ロール
/role-help compare <ロール 1>,<ロール 2> # ロール比較
基本例
# 一般的なガイダンス
/role-help
→ 利用可能なロールと特徴の一覧表示
# 状況別の推奨
/role-help "API のセキュリティが心配"
→ security ロールの推奨と使用方法
# ロール比較
/role-help compare frontend,mobile
→ frontend と mobile の違いと使い分け
状況別ロール選択ガイド
セキュリティ関連
こんな時は security ロール:
✅ ログイン・認証機能の実装
✅ API のセキュリティ脆弱性チェック
✅ データ暗号化・プライバシー保護
✅ セキュリティコンプライアンス確認
✅ 侵入テスト・ペネトレーションテスト
使い方: /role security
🏗️ アーキテクチャ・設計
こんな時は architect ロール:
✅ システム全体の設計評価
✅ マイクロサービス vs モノリス判断
✅ データベース設計・技術選定
✅ スケーラビリティ・拡張性の検討
✅ 技術的負債の評価・改善計画
使い方: /role architect
⚡ パフォーマンス問題
こんな時は performance ロール:
✅ アプリケーションが遅い
✅ データベースクエリの最適化
✅ Web ページの読み込み速度改善
✅ メモリ・CPU 使用量の最適化
✅ スケーリング・負荷対策
使い方: /role performance
🔍 問題の原因調査
こんな時は analyzer ロール:
✅ バグ・エラーの根本原因分析
✅ システム障害の原因究明
✅ 複雑な問題の構造的分析
✅ データ分析・統計的調査
✅ なぜこの問題が起きたかの解明
使い方: /role analyzer
🎨 フロントエンド・UI/UX
こんな時は frontend ロール:
✅ ユーザーインターフェースの改善
✅ アクセシビリティ対応
✅ レスポンシブデザイン
✅ ユーザビリティ・使いやすさ向上
✅ Web フロントエンド技術全般
使い方: /role frontend
📱 モバイルアプリ開発
こんな時は mobile ロール:
✅ iOS ・Android アプリの最適化
✅ モバイル特有の UX 設計
✅ タッチインターフェース最適化
✅ オフライン対応・同期機能
✅ App Store ・Google Play 対応
使い方: /role mobile
👀 コードレビュー・品質
こんな時は reviewer ロール:
✅ コードの品質チェック
✅ 可読性・保守性の評価
✅ コーディング規約の確認
✅ リファクタリング提案
✅ PR ・コミットのレビュー
使い方: /role reviewer
🧪 テスト・品質保証
こんな時は qa ロール:
✅ テスト戦略の立案
✅ テストカバレッジの評価
✅ 自動テストの実装方針
✅ バグ防止・品質向上策
✅ CI/CD でのテスト自動化
使い方: /role qa
複数ロールが必要な場合
🔄 multi-role (並行分析)
こんな時は multi-role:
✅ 複数の専門視点での評価が欲しい
✅ 統合的な改善計画を立てたい
✅ 各分野の評価を比較したい
✅ 矛盾・重複を整理したい
例: /multi-role security,performance
🗣️ role-debate (議論)
こんな時は role-debate:
✅ 専門分野間でトレードオフがある
✅ 技術選定で意見が分かれる
✅ 設計方針を議論で決めたい
✅ 異なる視点の議論を聞きたい
例: /role-debate security,performance
🤖 smart-review (自動提案)
こんな時は smart-review:
✅ どのロールを使うべきか分からない
✅ 現在の状況に最適なアプローチを知りたい
✅ 複数の選択肢から選びたい
✅ 初心者で判断に迷う
例: /smart-review
ロール比較表
セキュリティ系
| ロール | 主な用途 | 得意分野 | 苦手分野 |
|---|---|---|---|
| security | 脆弱性・攻撃対策 | 脅威分析、認証設計 | UX、パフォーマンス |
| analyzer | 根本原因分析 | 論理的分析、証拠収集 | 予防策、将来計画 |
設計系
| ロール | 主な用途 | 得意分野 | 苦手分野 |
|---|---|---|---|
| architect | システム設計 | 長期視点、全体最適 | 詳細実装、短期解決 |
| reviewer | コード品質 | 実装レベル、保守性 | ビジネス要件、UX |
パフォーマンス系
| ロール | 主な用途 | 得意分野 | 苦手分野 |
|---|---|---|---|
| performance | 高速化・最適化 | 測定、ボトルネック | セキュリティ、UX |
| qa | 品質保証 | テスト、自動化 | 設計、アーキテクチャ |
ユーザー体験系
| ロール | 主な用途 | 得意分野 | 苦手分野 |
|---|---|---|---|
| frontend | Web UI/UX | ブラウザ、アクセシビリティ | サーバーサイド、DB |
| mobile | モバイル UX | タッチ、オフライン対応 | サーバーサイド、Web |
迷った時のフローチャート
問題の性質は？
├─ セキュリティ関連 → security
├─ パフォーマンス問題 → performance
├─ バグ・障害調査 → analyzer
├─ UI/UX 改善 → frontend or mobile
├─ 設計・アーキテクチャ → architect
├─ コード品質 → reviewer
├─ テスト関連 → qa
└─ 複合的・複雑 → smart-review で提案
複数の分野にまたがる？
├─ 統合分析したい → multi-role
├─ 議論・トレードオフ → role-debate
└─ 判断に迷う → smart-review
よくある質問
Q: frontend と mobile の違いは？
A:
frontend: Web ブラウザ中心、HTML/CSS/JavaScript
mobile: モバイルアプリ中心、iOS/Android ネイティブ・React Native など
両方関連する場合は multi-role frontend,mobile がおすすめ
Q: security と analyzer の使い分けは？
A:
security: 攻撃・脅威の予防、セキュリティ設計
analyzer: 既に起きた問題の原因分析、調査
セキュリティインシデントの調査なら multi-role security,analyzer
Q: architect と performance の違いは？
A:
architect: システム全体の長期的設計、拡張性
performance: 具体的な速度・効率の改善
大規模システムの性能設計なら multi-role architect,performance
Claude との連携
# 状況説明と組み合わせ
/role-help
「React アプリのページ読み込みが遅くて、ユーザーから苦情が来ている」
# ファイル内容と組み合わせ
cat problem-description.md
/role-help
「この問題に最適なロールを推奨して」
# 特定の選択肢で迷っている場合
/role-help compare security,performance
「JWT トークンの有効期限問題でどちらのロールが適切？」
注意事項
- 複雑な問題ほど複数ロールの組み合わせが効果的です
- 緊急性が高い場合は single role で迅速に対応
- 迷った時は smart-review で自動提案を受けることをおすすめします
- 最終的な判断はユーザーが問題の性質を考慮して決定してください