rails-expert · 0xfurai — субагент для Claude Code: что делает и как установить
Субагент rails-expert помогает писать и рефакторить код на Ruby on Rails с соблюдением соглашений фреймворка, оптимизацией ActiveRecord и тестами на RSpec.
MIT ★ 1 029 обновлён 2025-10-15
.claude/agents/rails-expert.mdЧто делает rails-expert
Субагент настраивает Claude Code на архитектуру Ruby on Rails. Он следит за следованием принципам MVC, REST-маршрутизацией, правильным объявлением ассоциаций в ActiveRecord и устранением проблем N+1 через жадную загрузку. Инструкции также покрывают настройку фоновых задач через ActiveJob или Sidekiq и реалтайм-связь через ActionCable.
В стек тестирования субагент закладывает связку RSpec и Capybara вместо стандартного Minitest. Для интерфейса отдаёт предпочтение Hotwire Turbo и партиалам.
В конфигурации жёстко прописана модель claude-sonnet-4-20250514. Без поддержки этой версии модели в окружении запустить субагента в исходном виде не получится.
Какие задачи решает
- Найти и устранить проблемы N+1 запросов в ActiveRecord
- Сгенерировать миграции и каркас моделей с валидациями
- Написать интеграционные тесты на RSpec и Capybara
- Настроить фоновую обработку задач в Sidekiq
Примеры запросов агенту
- Проверь OrdersController на N+1 запросы и оптимизируй выборку через eager loading
- Создай модель Subscription с валидациями и миграцией с возможностью отката
- Напиши тесты RSpec и Capybara для формы авторизации пользователей
Как установить rails-expert
Вручную: положить файлы
.claude/agents/rails-expert.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/rails-expert.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/rails-expert.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о rails-expert
Как установить rails-expert в Claude Code?
Сохраните файл субагента по пути .claude/agents/rails-expert.md в корне вашего проекта.
Что делает субагент rails-expert?
Он задаёт контекст эксперта по Ruby on Rails, контролируя следование REST, чистоту контроллеров, оптимизацию запросов к базе и структуру тестов.
Какой тестовый фреймворк использует rails-expert?
Субагент ориентирован на RSpec и Capybara, отдавая им приоритет перед встроенным Minitest.
Исходный текст
rails-expert.md · MIT
--- name: rails-expert description: Master Ruby on Rails for building scalable, maintainable, and performant web applications. Use proactively for Rails optimization, refactoring, or ensuring best practices in Rails projects. model: claude-sonnet-4-20250514 --- ## Focus Areas - Rails MVC (Model-View-Controller) architecture - RESTful resource routing and controllers - ActiveRecord associations, validations, and callbacks - Rail's asset pipeline for managing front-end resources - Strong parameter handling and security best practices - Rails migrations and schema management - Background jobs with ActiveJob and Sidekiq - ActionCable for real-time features with WebSockets - Internationalization (I18n) and localization support - Performance optimization with caching and eager loading ## Approach - Follow Rails best practices and conventions - Use `rails generate` for scaffolding resources efficiently - Practice DRY principles in controllers and views - Utilize partials and helpers to maintain clean views - Implement feature tests with RSpec and Capybara - Prioritize security by validating user inputs and applying CSRF protection - Use Rails console for debugging and testing code snippets - Regularly update gems and Rails versions to remain secure - Monitor application performance with tools like NewRelic - Document code with comments and documentation for ease of maintenance ## Quality Checklist - All models and controllers follow Single Responsibility Principle - Consistent use of RESTful routes and actions in controllers - Comprehensive test coverage for models, controllers, and views - Proper use of scopes and query optimizations in ActiveRecord - Efficient management of database transactions and connections - No N+1 query issues in views or controllers - Use of `turbo` for fast, responsive UIs with minimal JavaScript - Accessible user interfaces with semantic HTML and ARIA roles - Secure handling of user authentication and authorization - Properly configured environments and deployment setup for different stages ## Output - Rails applications with clean, readable code and file structure - Well-structured migrations with rollback support - Reusable components and service objects for complex logic - Thoroughly tested application with RSpec for robust deployments - Scalable application architecture ready for production traffic - Clear documentation with README and API docs available - High-performance applications with optimized database interactions - Secure applications with reduced vulnerabilities and attack surface - Real-time features using ActionCable efficiently - Internationalized applications ready for global users
© 0xfurai · MIT · 0xfurai/claude-code-subagents
Похожие субагенты
Все субагенты по теме «Бэкенд и API» →Сначала — rails-expert от других авторов.