К основному содержанию
скилл CX Codex

rails-testing — скилл для Claude Code: что делает и как установить

Скилл rails-testing для Claude Code содержит 46 правил для RSpec, FactoryBot и Capybara в Ruby on Rails. Помогает писать надёжные тесты моделей, запросов и фоновых задач Sidekiq.

MIT 309 установок ★ 227 обновлён 2026-08-15

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add pproenca/dot-skills --skill rails-testing -a claude-code
Открыть на GitHub

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

Скилл содержит 46 практических правил в 8 категориях приоритета. Он направляет агента при составлении спек RSpec, фабрик FactoryBot и тестов Capybara. Основной упор сделан на проверяемое поведение. Агент не тестирует стандартные механизмы ActiveRecord.

Для данных скилл рекомендует build и build_stubbed вместо постоянной записи в базу. В системных сценариях Capybara запрещены вызовы sleep — синхронизация идёт через встроенные ожидания. Проверки фоновых задач Sidekiq разделяют постановку в очередь и выполнение метода perform.

В правилах учтены очереди с контролем транзакций в Rails 7.2+. Тесты становятся предсказуемыми. Скилл дополняет rails-dev, ruby-optimise и ruby-refactor.

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

  • Переписать медленные тесты с сохранением в базу на build_stubbed
  • Устранить нестабильные тесты в Capybara без использования sleep
  • Разделить проверку постановки в очередь и вызова Sidekiq-воркера
  • Спроектировать фабрики FactoryBot с трейтами и последовательностями
  • Заменить устаревшие тесты контроллеров на request specs

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

  • Напиши request spec для эндпоинта оформления заказа с проверкой ролей и кодов статуса
  • Проверь спеку модели на лишние тесты ActiveRecord и добавь граничные случаи для валидаций
  • Отрефактори тест воркера Sidekiq с учётом коммита транзакции в Rails 7.2

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

1Через Skills CLI (Vercel)

npx skills add pproenca/dot-skills --skill rails-testing -a claude-code

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

~/.claude/skills/rails-testing/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/rails-testing/

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

Вопросы о rails-testing

Как установить rails-testing в Claude Code?

Запустите команду npx skills add pproenca/dot-skills --skill rails-testing -a claude-code. Файл навыка размещается в ~/.claude/skills/rails-testing/SKILL.md.

Что делает скилл rails-testing?

Он задаёт 46 правил для написания и рефакторинга тестов на RSpec в Ruby on Rails. Скилл направляет агента изолировать данные, проверять внешнее поведение и избегать лишней нагрузки на базу.

Как скилл помогает ускорить выполнение тестов?

Он требует использовать build и build_stubbed вместо постоянных записей через create. Также правила предписывают параллельный запуск на ядрах процессора и стратегию транзакций для очистки данных.

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

SKILL.md · MIT
---
name: rails-testing
description: Ruby on Rails testing best practices for writing effective, maintainable test suites with RSpec. This skill should be used when writing, reviewing, or refactoring Rails tests to ensure proper test design, data management, and coverage patterns. Triggers on tasks involving RSpec specs, model tests, request specs, system tests, factory definitions, Capybara interactions, Sidekiq job tests, or test suite optimization. Complementary to rails-dev, ruby-optimise, and ruby-refactor skills.
---

# Community Ruby on Rails Testing Best Practices

Comprehensive testing guide for Ruby on Rails applications, maintained by Community. Contains 46 rules across 8 categories, prioritized by impact to guide automated test generation, review, and refactoring.

## When to Apply

Reference these guidelines when:
- Writing new RSpec specs for models, requests, system tests, or jobs
- Setting up FactoryBot factories with traits and sequences
- Writing Capybara system tests for user journeys
- Testing background jobs with Sidekiq or Active Job
- Reviewing test code for anti-patterns (mystery guests, flaky tests, slow specs)
- Optimizing test suite performance and CI pipeline speed
- Organizing test files, shared examples, and custom matchers

## Rule Categories by Priority

| Priority | Category | Impact | Prefix |
|----------|----------|--------|--------|
| 1 | Test Design & Structure | CRITICAL | `design-` |
| 2 | Test Data Management | CRITICAL | `data-` |
| 3 | Model Testing | HIGH | `model-` |
| 4 | Request & Controller Testing | HIGH | `request-` |
| 5 | System & Acceptance Testing | MEDIUM-HIGH | `system-` |
| 6 | Async & Background Job Testing | MEDIUM | `async-` |
| 7 | Test Performance & Reliability | MEDIUM | `perf-` |
| 8 | Test Organization & Maintenance | LOW-MEDIUM | `org-` |

## Quick Reference

### 1. Test Design & Structure (CRITICAL)

- [`design-four-phase-test`](references/design-four-phase-test.md) - Use four-phase test structure (setup, exercise, verify, teardown)
- [`design-behavior-over-implementation`](references/design-behavior-over-implementation.md) - Test observable behavior, not internal implementation
- [`design-one-assertion-per-test`](references/design-one-assertion-per-test.md) - One logical expectation per test for precise failure diagnosis
- [`design-descriptive-test-names`](references/design-descriptive-test-names.md) - Write test names that read like specifications
- [`design-avoid-mystery-guest`](references/design-avoid-mystery-guest.md) - Make all test data visible within the test itself
- [`design-avoid-conditional-logic`](references/design-avoid-conditional-logic.md) - No if/else or loops in test code
- [`design-explicit-subject`](references/design-explicit-subject.md) - Name subjects explicitly instead of using implicit subject

### 2. Test Data Management (CRITICAL)

- [`data-factory-traits`](references/data-factory-traits.md) - Use composable factory traits instead of separate factories
- [`data-minimal-attributes`](references/data-minimal-attributes.md) - Specify only attributes relevant to the test
- [`data-build-over-create`](references/data-build-over-create.md) - Prefer build/build_stubbed over create when persistence isn't needed
- [`data-avoid-fixture-coupling`](references/data-avoid-fixture-coupling.md) - Use factories instead of shared fixtures
- [`data-transient-attributes`](references/data-transient-attributes.md) - Use transient attributes for complex factory setup
- [`data-sequence-unique-values`](references/data-sequence-unique-values.md) - Use sequences for uniqueness-constrained fields

### 3. Model Testing (HIGH)

- [`model-test-validations`](references/model-test-validations.md) - Test validations with boundary cases, not just happy path
- [`model-test-associations`](references/model-test-associations.md) - Test associations explicitly including dependent behavior
- [`model-test-scopes`](references/model-test-scopes.md) - Test scopes with matching and non-matching records
- [`model-test-callbacks-sparingly`](references/model-test-callbacks-sparingly.md) - Test callback side effects, not callback existence
- [`model-test-custom-methods`](references/model-test-custom-methods.md) - Test public methods with input/output pairs across scenarios
- [`model-avoid-testing-framework`](references/model-avoid-testing-framework.md) - Don't test ActiveRecord or framework behavior
- [`model-test-enums`](references/model-test-enums.md) - Test enum transitions and generated scopes

### 4. Request & Controller Testing (HIGH)

- [`request-over-controller-specs`](references/request-over-controller-specs.md) - Use request specs over deprecated controller specs
- [`request-test-response-status`](references/request-test-response-status.md) - Assert HTTP status codes explicitly
- [`request-test-authentication`](references/request-test-authentication.md) - Test authentication boundaries for every protected endpoint
- [`request-test-authorization`](references/request-test-authorization.md) - Test authorization for each role
- [`request-test-params-validation`](references/request-test-params-validation.md) - Test parameter validation and edge cases
- [`request-json-response-structure`](references/request-json-response-structure.md) - Assert JSON response structure for API endpoints

### 5. System & Acceptance Testing (MEDIUM-HIGH)

- [`system-page-objects`](references/system-page-objects.md) - Encapsulate page interactions in page objects
- [`system-use-accessible-selectors`](references/system-use-accessible-selectors.md) - Use accessible selectors over CSS/XPath
- [`system-avoid-sleep`](references/system-avoid-sleep.md) - Never use sleep — rely on Capybara's built-in waiting
- [`system-test-critical-paths`](references/system-test-critical-paths.md) - Reserve system tests for critical user journeys
- [`system-database-state`](references/system-database-state.md) - Use truncation strategy for system test database cleanup
- [`system-screenshot-on-failure`](references/system-screenshot-on-failure.md) - Capture screenshots on system test failure

### 6. Async & Background Job Testing (MEDIUM)

- [`async-separate-enqueue-from-perform`](references/async-separate-enqueue-from-perform.md) - Test enqueue and perform separately
- [`async-use-fake-mode-default`](references/async-use-fake-mode-default.md) - Default to Sidekiq fake mode globally
- [`async-test-job-perform`](references/async-test-job-perform.md) - Test job perform method directly
- [`async-test-mailer-delivery`](references/async-test-mailer-delivery.md) - Test mailer delivery with enqueued mail matcher
- [`async-test-after-commit`](references/async-test-after-commit.md) - Account for transaction-aware job enqueuing in Rails 7.2+

### 7. Test Performance & Reliability (MEDIUM)

- [`perf-parallel-tests`](references/perf-parallel-tests.md) - Run tests in parallel across CPU cores
- [`perf-database-strategy`](references/perf-database-strategy.md) - Use transaction strategy for non-system tests
- [`perf-profile-slow-specs`](references/perf-profile-slow-specs.md) - Profile and fix the slowest specs
- [`perf-quarantine-flaky-tests`](references/perf-quarantine-flaky-tests.md) - Quarantine flaky tests instead of retrying
- [`perf-avoid-before-all-mutation`](references/perf-avoid-before-all-mutation.md) - Never mutate state created in before(:all)

### 8. Test Organization & Maintenance (LOW-MEDIUM)

- [`org-avoid-deep-nesting`](references/org-avoid-deep-nesting.md) - Limit context nesting to 3 levels
- [`org-shared-examples-sparingly`](references/org-shared-examples-sparingly.md) - Use shared examples only for true behavioral contracts
- [`org-custom-matchers`](references/org-custom-matchers.md) - Extract custom matchers for repeated domain assertions
- [`org-file-structure-mirrors-app`](references/org-file-structure-mirrors-app.md) - Mirror app directory structure in spec directory

## How to Use

Read individual reference files for detailed explanations and code examples:

- [Section definitions](references/_sections.md) - Category structure and impact levels
- [Rule template](assets/templates/_template.md) - Template for adding new rules

## Reference Files

| File | Description |
|------|-------------|
| [references/_sections.md](references/_sections.md) | Category definitions and ordering |
| [assets/templates/_template.md](assets/templates/_template.md) | Template for new rules |
| [metadata.json](metadata.json) | Version and reference information |

© pproenca · MIT · pproenca/dot-skills

Похожие скиллы

Все скиллы по теме «Тесты и QA» →
rails-expert https://github.com/Jeffallan Скилл rails-expert для стека Rails 7+ с Hotwire, Sidekiq и RSpec. Помогает писать контроллеры, настраивать фоновые задачи и устранять проблемы с N+1. CX Codex +1 5 100установок inertia-rails-testing inertia-rails Скилл inertia-rails-testing для тестов Inertia Rails на RSpec и Minitest: проверка компонента, пропсов и flash без ручного разбора JSON. CX Codex +1 479установок capybara-skill TestMu AI Генерирует acceptance-тесты веб-приложений на Capybara и RSpec. Автоматизирует клики, заполнение форм и проверку содержимого страницы. CX Codex +1 210установок ruby-rails Mindrally Скилл ruby-rails для Ruby on Rails в Claude Code. Задаёт конвенции Rails, подходы к ActiveRecord, Hotwire, фоновым задачам и тестам, чтобы агент писал идиоматичный код, а не boilerplate по своим лекалам. CX Codex +1 907установок inertia-rails-typescript inertia-rails Скилл inertia-rails-typescript настраивает строгую типизацию TypeScript в Inertia Rails для React, Vue и Svelte. Помогает исправить ошибки TS2344 и TS2339. CX Codex +1 482установок ruby Mindrally Задаёт стиль кода, возможности Ruby 3.x и правила тестирования на RSpec. Покрывает написание и правку Ruby-проектов. CX Codex +1 776установок

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

Весь набор →
tailwind-refactor Скилл tailwind-refactor для рефакторинга классов Tailwind CSS: миграция с v3 на v4, замена устаревших утилит и чистка кода без изменения внешнего вида. CX Codex +1 321установок pulumi С набором из 46 правил для написания и рефакторинга кода Pulumi. Охватывает управление состоянием, оптимизацию графа ресурсов, дизайн компонентов и CI/CD. CX Codex +1 317установок harness-engineering Скилл harness-engineering для Claude Code, настройки и обновления инфраструктуры репозитория под агентское кодирование. Создаёт AGENTS.md как карту кодовой базы, архитектурные границы и правила в .harness/ для эффективной работы AI-агентов. CX Codex +1 312установок ios-hig Скилл ios-hig с 34 правилами Apple HIG для iOS 26 и Swift 6.2: навигация, жесты, доступность, состояния загрузки и ошибок в SwiftUI. CX Codex +1 310установок ruby-refactor Скилл ruby-refactor со сводом из 45 правил рефакторинга Ruby-кода. Помогает агенту упрощать условия, снижать зацепление классов и внедрять синтаксис Ruby 3.x. CX Codex +1 307установок ios-xcode Скилл ios-xcode для Claude Code помогает настраивать Xcode-проекты и повседневные инструменты для iOS. Он подключается при работе с App-target, SwiftData, тестами, отладкой и распространением приложения. CX Codex +1 307установок think Скилл think для Claude Code переводит ИИ в режим глубокого анализа и ищет эффективные решения, связывая идеи из разных областей. Помогает выработать стратегию, а не инструкцию. CX Codex +1 307установок restful-hateoas Скилл restful-hateoas внедряет в ИИ-агента 47 правил проектирования REST API третьего уровня зрелости Ричардсона для приложений на Ruby on Rails. CX Codex +1 304установок

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

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