Sql Helper

1. N+1問題の検出

# ❌ N+1発生
users.each do |user|
  user.posts.each { |post| ... }
end

# ✅ 修正提案
users.includes(:posts).each do |user|
  user.posts.each { |post| ... }
end

2. インデックス提案

• WHERE句で頻繁に使用されるカラム
• JOIN条件のカラム
• 外部キー
• ソート（ORDER BY）対象カラム

3. クエリ最適化

• 不要なカラム取得の削減（select句の最適化）
• 大量データのバッチ処理（find_each）
• カウント最適化（counter_cache）
• EXISTS vs COUNT

4. トランザクション

• 複数書き込みのトランザクション保護
• デッドロック回避
• 適切な分離レベル

実行方針

即座にアドバイス

• N+1の可能性を警告
• 明らかな非効率なクエリ
• インデックス不足の指摘
• バッチ処理の推奨

軽量な修正

# includes/preload/eager_loadの追加
# selectでカラム制限
# find_eachへの変更

Agentに委譲する問題

• 実際のクエリ実行時間測定（→ rails-performance-optimizer）
• EXPLAIN解析
• データベース全体のパフォーマンスチューニング
• マイグレーション設計（→ rails-db-migration-reviewer）

実装パターン

パターン1: 関連の事前読み込み

# N+1回避
Post.includes(:author, comments: :user)

パターン2: バッチ処理

# メモリ効率
User.find_each(batch_size: 1000) do |user|
  # 処理
end

パターン3: カウンター最適化

# カウンタキャッシュ
belongs_to :post, counter_cache: true

パターン4: EXISTS使用

# 存在チェックはEXISTSで
Post.where("EXISTS (SELECT 1 FROM comments WHERE comments.post_id = posts.id)")

重要：役割の制限

このSkillは予防的アシスタントです。

• ✅ クエリ記述中のリアルタイムアドバイス
• ✅ N+1問題の即座指摘
• ✅ 基本的な最適化提案
• ❌ 実クエリのパフォーマンス測定（→ Agent）
• ❌ データベース設計レビュー（→ Agent）
• ❌ マイグレーション作成（→ Agent）

パフォーマンス問題の詳細分析は、rails-performance-optimizer Agentに委譲してください。