К основному содержанию
субагент CX Codex

rails-expert · voltagent/awesome-codex-subagents — субагент для Codex: задачи Ruby on Rails

Субагент rails-expert для Codex разбирает изменения в Ruby on Rails — от маршрута и модели до ответа клиенту. Ищет причины ошибок и предлагает небольшие правки без перестройки архитектуры.

MIT ★ 6 505 обновлён 2026-10-05

Установить в Codex · Вручную: положить файлы Все способы и платформы ↓
.codex/agents/rails-expert.toml
Открыть на GitHub

Что делает rails-expert

Субагент прослеживает границу выполнения задачи: точку входа, путь данных и внешние зависимости. Затем ищет причину проблемы и предлагает минимальное согласованное изменение, которое сохраняет поведение остального приложения. Он работает с моделями, контроллерами, заданиями, колбэками, запросами ActiveRecord и контрактами API.

При проверке он проходит запрос от маршрутизации до сохранения данных и ответа, смотрит на побочные эффекты колбэков, транзакции и риск N+1. В результате указывает затронутый модуль или путь, найденную проблему, исправление и то, что проверил сам. Для изменений схемы он также выделяет проверки миграции и развёртывания. Среда развёртывания может требовать отдельной проверки — субагент отделяет её от того, что удалось проверить напрямую.

Какие задачи решает

  • найти причину сбоя в пути запроса от маршрута до ответа
  • согласовать валидацию и авторизацию в обработке запроса
  • проверить побочные эффекты колбэков и границы транзакций
  • оценить идемпотентность фонового задания
  • сохранить контракт JSON при изменении контроллера или сериализатора

Примеры запросов агенту

  • Проверь, почему запрос к этому маршруту сохраняет неверные данные, и предложи минимальную правку в стиле существующего Rails-кода.
  • Посмотри, не создаёт ли этот колбэк повторные побочные эффекты, и проверь границу транзакции.
  • Оцени изменение сериализатора: сохранился ли контракт JSON и какие проверки миграции нужны?

Как установить rails-expert

Вручную: положить файлы

.codex/agents/rails-expert.toml

Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы о rails-expert

Как установить rails-expert в Codex?

Добавьте файл .codex/agents/rails-expert.toml в проект.

Что делает rails-expert?

Он разбирает задачи Ruby on Rails, прослеживает путь выполнения и рекомендует небольшие изменения, сохраняя существующие соглашения проекта.

Что rails-expert проверяет при изменениях Rails?

Он может пройти запрос от маршрута до сохранения и ответа, проверить транзакции, побочные эффекты колбэков и риск N+1. Для изменений схемы он выделяет проверки миграции и развёртывания.

Исходный текст

rails-expert.toml · MIT
# rails-expert

Use when a task needs Ruby on Rails expertise for models, controllers, jobs, callbacks, or convention-driven application changes.

Own Ruby on Rails tasks as production behavior and contract work, not checklist execution.

Prioritize smallest safe changes that preserve established architecture, and make explicit where compatibility or environment assumptions still need verification.

Working mode:
1. Map the exact execution boundary (entry point, state/data path, and external dependencies).
2. Identify root cause or design gap in that boundary before proposing changes.
3. Implement or recommend the smallest coherent fix that preserves existing behavior outside scope.
4. Validate the changed path, one failure mode, and one integration boundary.

Focus on:
- model/controller/service responsibilities with convention alignment
- ActiveRecord query behavior, transactions, and callback side effects
- validation and authorization consistency in request lifecycle
- job/queue behavior and idempotency for async work
- route and serializer/JSON contract stability for clients
- n+1 risks and eager-loading strategy in changed endpoints
- keeping changes idiomatic to existing Rails code style

Quality checks:
- verify one request flow from routing to persistence and response
- confirm callback or concern changes do not create hidden side effects
- check transaction boundaries where multiple writes occur
- ensure API/HTML error handling remains consistent and user-visible
- call out migration/deployment checks needed for schema-affecting changes

Return:
- exact module/path and execution boundary you analyzed or changed
- concrete issue observed (or likely risk) and why it happens
- smallest safe fix/recommendation and tradeoff rationale
- what you validated directly and what still needs environment-level validation
- residual risk, compatibility notes, and targeted follow-up actions

Do not replace Rails conventions with custom architecture during a scoped fix unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Похожие субагенты

Все субагенты по теме «Бэкенд и API» →

Сначала — rails-expert от других авторов.

rails-expert VoltAgent Community Субагент rails-expert настраивает архитектуру под Rails 7.x или 8.x по данным Gemfile.lock. Помогает с Hotwire, очередями Solid Queue, миграциями и тестами. CX Codex 199установок rails-expert 0xfurai Субагент rails-expert помогает писать и рефакторить код на Ruby on Rails с соблюдением соглашений фреймворка, оптимизацией ActiveRecord и тестами на RSpec. CX Codex ★ 1 029звёзд репо rails-dev pproenca Скилл rails-dev для Claude Code задаёт правила разработки на Ruby on Rails: контроллеры, ActiveRecord и кеширование. Включается при рефакторинге моделей, миграциях и работе с Turbo Frames. CX Codex +1 299установок inertia-rails-typescript inertia-rails Скилл inertia-rails-typescript настраивает строгую типизацию TypeScript в Inertia Rails для React, Vue и Svelte. Помогает исправить ошибки TS2344 и TS2339. CX Codex +1 482установок rails-testing pproenca Скилл rails-testing для Claude Code содержит 46 правил для RSpec, FactoryBot и Capybara в Ruby on Rails. Помогает писать надёжные тесты моделей, запросов и фоновых задач Sidekiq. CX Codex +1 309установок ruby-rails Mindrally Скилл ruby-rails для Ruby on Rails в Claude Code. Задаёт конвенции Rails, подходы к ActiveRecord, Hotwire, фоновым задачам и тестам, чтобы агент писал идиоматичный код, а не boilerplate по своим лекалам. CX Codex +1 907установок inertia-rails-setup inertia-rails Скилл inertia-rails-setup анализирует стек Inertia Rails в проекте, подбирает недостающие библиотеки и генерирует блок конфигурации в CLAUDE.md. Помогает при первом старте или смене инструментов. CX Codex +1 432установок rails-query lewispb Направляет запросы к базе данных приложения через команду rails query локально или через Kamal. Помогает изучать схему и данные без ручного входа в консоль. ★ 26звёзд репо

Из того же набора176

Весь набор →
sql-pro Субагент sql-pro проектирует и проверяет SQL-запросы, отлаживает ошибки с учётом схемы и оценивает безопасность миграций баз данных. CX Codex ★ 6 505звёзд репо spring-boot-engineer Субагент spring-boot-engineer для задач на Spring Boot: конфигурация, слои данных, API, транзакции и безопасность. Анализирует границы выполнения, находит корни проблем и предлагает минимальные безопасные изменения, сохраняя архитектуру. CX Codex ★ 6 505звёзд репо rust-engineer Субагент rust-engineer для Rust-задач с упором на корректность владения, lifetime и async-поведение. Подходит для системного кода, где ошибка в заимствовании или синхронизации стоит дорого. CX Codex ★ 6 505звёзд репо react-specialist Субагент react-specialist для отладки компонентов React, потоков состояния и багов рендера. Находит причину сбоя и вносит минимальные безопасные правки. CX Codex ★ 6 505звёзд репо python-pro Субагент python-pro для задач, где нужно разбираться в поведении Python кода на исполнение, типизацию, тестирование и архитектуру пакетов. Работает с точными границами входа-выхода, а не общими рекомендациями. CX Codex ★ 6 505звёзд репо powershell-7-expert Субагент powershell-7-expert помогает писать надёжные скрипты на PowerShell 7 для Linux, macOS и Windows, настраивать пайплайны и интеграцию с .NET. CX Codex ★ 6 505звёзд репо powershell-5.1-expert Субагент powershell-5.1-expert помогает разбирать и менять скрипты Windows PowerShell 5.1 с учётом .NET Framework, remoting и административных ограничений. CX Codex ★ 6 505звёзд репо php-pro Субагент php-pro для работы с PHP-кодом: помогает разобраться в логике приложения, интегрировать фреймворки, отладить runtime-ошибки и безопасно менять серверный код. Подходит, когда нужна глубокая экспертиза в PHP, а не просто синтаксис. CX Codex ★ 6 505звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой