rails-helper

Rails開発を支援するスキル。モデル、コントローラー、テストの生成、マイグレーションのサポートを提供します。

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026

When & Why to Use This Skill

This Claude skill streamlines Ruby on Rails development by automating the generation of models, controllers, migrations, and RSpec tests. It serves as an intelligent coding assistant that helps developers adhere to Rails best practices, such as N+1 query avoidance and secure parameter handling, while significantly reducing boilerplate work and ensuring architectural consistency across the project.

Use Cases

  • Rapid Prototyping: Quickly generating models, controllers, and API endpoints using scaffolding commands to accelerate the initial development phase.
  • Database Schema Management: Creating and managing complex database migrations, including adding indexes, references, and counter caches with proper syntax.
  • Automated Testing: Generating comprehensive RSpec unit tests for models and request tests for APIs to ensure high code quality and prevent regressions.
  • Architectural Implementation: Implementing advanced design patterns like Service Objects, Serializers, and Pundit Policies to maintain a clean and scalable codebase.
  • Performance and Security Optimization: Identifying and fixing common Rails issues like N+1 queries and implementing Strong Parameters and background jobs for better efficiency.
namerails-helper
descriptionRails開発を支援するスキル。モデル、コントローラー、テストの生成、マイグレーションのサポートを提供します。

Rails Helper Skill

Nature-Spotsプロジェクトにおける Rails 開発を効率化するスキルです。

機能

1. Scaffolding(スキャフォールディング)

モデルの生成

# 基本的なモデル生成
rails g model Spot name:string description:text latitude:decimal longitude:decimal

# アソシエーション付きモデル
rails g model Review content:text rating:integer user:references spot:references

コントローラーの生成

# API用コントローラー
rails g controller Api::V1::Spots index show create update destroy

2. マイグレーション管理

カラムの追加

rails g migration AddUserIdToSpots user:references

インデックスの追加

rails g migration AddIndexToSpots
# マイグレーションファイルに以下を追加:
# add_index :spots, :user_id
# add_index :spots, [:latitude, :longitude]

カウンターキャッシュの追加

# マイグレーション
add_column :spots, :reviews_count, :integer, default: 0, null: false
add_column :users, :followers_count, :integer, default: 0, null: false

# モデルに追加
belongs_to :spot, counter_cache: true

3. テスト生成

RSpec Modelテスト

# spec/models/spot_spec.rb
RSpec.describe Spot, type: :model do
  describe 'validations' do
    it { should validate_presence_of(:name) }
    it { should validate_length_of(:name).is_at_most(50) }
  end

  describe 'associations' do
    it { should belong_to(:user) }
    it { should have_many(:reviews).dependent(:destroy) }
  end
end

RSpec Requestテスト

# spec/requests/api/v1/spots_spec.rb
RSpec.describe 'Api::V1::Spots', type: :request do
  let(:user) { create(:user) }
  let(:headers) { { 'Authorization' => "Bearer #{token}" } }

  describe 'GET /api/v1/spots' do
    it 'returns spots list' do
      get '/api/v1/spots', headers: headers
      expect(response).to have_http_status(:success)
    end
  end
end

4. Serializerの生成

# app/serializers/spot_serializer.rb
class SpotSerializer < ApplicationSerializer
  attributes :id, :name, :description, :latitude, :longitude, :created_at

  belongs_to :user
  has_many :reviews

  attribute :reviews_count do
    object.reviews.count
  end
end

5. Policyの生成(認可)

# app/policies/spot_policy.rb
class SpotPolicy < ApplicationPolicy
  def show?
    true  # 全員が閲覧可能
  end

  def create?
    user.present?  # ログインユーザーのみ作成可能
  end

  def update?
    user.present? && record.user_id == user.id  # 作成者のみ更新可能
  end

  def destroy?
    update?  # 更新と同じ権限
  end
end

6. Serviceオブジェクトの生成

# app/services/spot_ranking_service.rb
class SpotRankingService < ApplicationService
  def initialize(period: 30.days)
    @period = period
  end

  def call
    Spot.joins(:reviews)
        .where('reviews.created_at >= ?', @period.ago)
        .group('spots.id')
        .order('AVG(reviews.rating) DESC')
        .limit(10)
  end
end

# 使用例
popular_spots = SpotRankingService.new(period: 7.days).call

よく使うRailsコマンド

データベース

# マイグレーション実行
rails db:migrate

# ロールバック
rails db:rollback

# シード実行
rails db:seed

# データベースリセット(開発環境)
rails db:reset

# テストDB準備
rails db:test:prepare

コンソール

# Railsコンソール起動
rails c

# サンドボックスモード(変更がロールバックされる)
rails c --sandbox

テスト

# 全テスト実行
bundle exec rspec

# 特定のファイル
bundle exec rspec spec/models/spot_spec.rb

# 特定の行
bundle exec rspec spec/models/spot_spec.rb:25

セキュリティチェック

# Brakeman(セキュリティ監査)
bundle exec brakeman

# Bundle Audit(依存関係の脆弱性チェック)
bundle exec bundle-audit

ベストプラクティス

1. N+1クエリの回避

# ❌ N+1クエリ
@spots = Spot.all
@spots.each { |s| puts s.user.name }

# ✅ includes で事前ロード
@spots = Spot.includes(:user).all

2. Strong Parametersの使用

private

def spot_params
  params.require(:spot).permit(:name, :description, :latitude, :longitude)
end

3. トランザクションの使用

ActiveRecord::Base.transaction do
  spot = Spot.create!(spot_params)
  Review.create!(spot: spot, user: current_user, content: params[:review])
end

4. バックグラウンドジョブの活用

# app/jobs/notification_job.rb
class NotificationJob < ApplicationJob
  queue_as :default

  def perform(user_id)
    user = User.find(user_id)
    # 通知処理
  end
end

# 使用
NotificationJob.perform_later(user.id)

プロジェクト固有の規約

API レスポンス形式

# 成功時
render json: SpotSerializer.new(spot).serializable_hash, status: :ok

# エラー時
render json: { error: 'エラーメッセージ' }, status: :unprocessable_entity

認証・認可フロー

  1. JWT トークンを Authorization ヘッダーで受け取る
  2. Authorization concern でトークン検証
  3. current_user を設定
  4. Policy オブジェクトで認可チェック

参考リンク