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