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

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

Скилл ruby-refactor со сводом из 45 правил рефакторинга Ruby-кода. Помогает агенту упрощать условия, снижать зацепление классов и внедрять синтаксис Ruby 3.x.

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

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

Что делает ruby-refactor

Скилл задаёт 45 правил рефакторинга, разбитых по приоритету на 8 категорий. На вершине списка находятся декомпозиция методов и упрощение ветвлений: замена вложенных условий на guard clauses, выделение классов и переход от case/when к полиморфизму.

Для архитектуры скилл предлагает ослабление связей через внедрение зависимостей и закон Деметры. Он заменяет вызовы each с ручным накоплением на методы Enumerable, требует парный respond_to_missing? к method_missing и использует Data.define для неизменяемых структур данных.

Правила 7-й категории ориентированы строго на синтаксис Ruby 3.x с конструкциями case/in и однострочными методами. Если проект застрял на старых версиях Ruby, эти правки придётся отсекать вручную.

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

  • разбить громоздкие методы и классы с нарушением SRP
  • заменить вложенные ветвления на guard clauses и сопоставление с образцом
  • устранить сильную связанность классов через внедрение зависимостей
  • переписать устаревшие циклы на идиоматичные методы Enumerable
  • внедрить неизменяемые объекты данных через Data.define

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

  • Проверь класс OrderProcessor и отрефактори его по правилам struct-extract-method и cond-guard-clauses.
  • Перепиши этот модуль под синтаксис Ruby 3.x, используя сопоставление с образцом case/in.
  • Найди нарушение закона Деметры в моделях и предложи варианты через делегирование.

Как установить ruby-refactor

1Через Skills CLI (Vercel)

npx skills add pproenca/dot-skills --skill ruby-refactor -a claude-code

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

~/.claude/skills/ruby-refactor/SKILL.md

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

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

Вопросы о ruby-refactor

Как установить ruby-refactor в Claude Code?

Выполните команду npx skills add pproenca/dot-skills --skill ruby-refactor -a claude-code. Файл скилла запишется в ~/.claude/skills/ruby-refactor/SKILL.md.

Что делает скилл ruby-refactor?

Он передаёт ИИ-агенту базу из 45 практик рефакторинга в 8 категориях с чётким приоритетом. Агент ориентируется на них при проверке кода, разбиении длинных методов и устранении запахов кода.

Какие категории правил считаются самыми важными в ruby-refactor?

Высший приоритет со статусом CRITICAL отдан двум категориям: декомпозиции структуры (struct-) и упрощению условий (cond-). Снижение связанности (couple-) и идиомы языка (idiom-) идут следом со статусом HIGH.

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

SKILL.md · MIT
---
name: ruby-refactor
description: Ruby refactoring guidelines from community best practices. This skill should be used when refactoring, reviewing, or restructuring Ruby code to improve design, readability, and maintainability. Triggers on tasks involving code smells, method extraction, conditional simplification, coupling reduction, design patterns, or Ruby idiom adoption.
---

# Community Ruby Refactoring Best Practices

Comprehensive refactoring guide for Ruby applications, maintained by the community. Contains 45 rules across 8 categories, prioritized by impact to guide automated refactoring and code generation.

## When to Apply

Reference these guidelines when:
- Refactoring Ruby code to reduce complexity and improve design
- Extracting methods, classes, or value objects from large units
- Simplifying complex conditionals and deep nesting
- Reducing coupling between classes and modules
- Adopting idiomatic Ruby patterns and modern Ruby 3.x features

## Rule Categories by Priority

| Priority | Category | Impact | Prefix |
|----------|----------|--------|--------|
| 1 | Structure & Decomposition | CRITICAL | `struct-` |
| 2 | Conditional Simplification | CRITICAL | `cond-` |
| 3 | Coupling & Dependencies | HIGH | `couple-` |
| 4 | Ruby Idioms | HIGH | `idiom-` |
| 5 | Data & Value Objects | MEDIUM-HIGH | `data-` |
| 6 | Design Patterns | MEDIUM | `pattern-` |
| 7 | Modern Ruby 3.x | MEDIUM | `modern-` |
| 8 | Naming & Readability | LOW-MEDIUM | `name-` |

## Quick Reference

### 1. Structure & Decomposition (CRITICAL)

- [`struct-extract-method`](references/struct-extract-method.md) - Extract Long Methods into Focused Units
- [`struct-extract-class`](references/struct-extract-class.md) - Extract Class for Single Responsibility
- [`struct-parameter-object`](references/struct-parameter-object.md) - Introduce Parameter Object for Long Signatures
- [`struct-compose-method`](references/struct-compose-method.md) - Compose Methods at Single Abstraction Level
- [`struct-replace-method-with-object`](references/struct-replace-method-with-object.md) - Replace Complex Method with Method Object
- [`struct-single-responsibility`](references/struct-single-responsibility.md) - One Reason to Change per Class
- [`struct-flatten-deep-nesting`](references/struct-flatten-deep-nesting.md) - Flatten Deep Nesting with Early Extraction

### 2. Conditional Simplification (CRITICAL)

- [`cond-guard-clauses`](references/cond-guard-clauses.md) - Replace Nested Conditionals with Guard Clauses
- [`cond-decompose-conditional`](references/cond-decompose-conditional.md) - Extract Complex Booleans into Named Predicates
- [`cond-replace-with-polymorphism`](references/cond-replace-with-polymorphism.md) - Replace case/when with Polymorphism
- [`cond-null-object`](references/cond-null-object.md) - Replace nil Checks with Null Object
- [`cond-pattern-matching`](references/cond-pattern-matching.md) - Use Pattern Matching for Structural Conditions
- [`cond-consolidate-duplicates`](references/cond-consolidate-duplicates.md) - Consolidate Duplicate Conditional Fragments

### 3. Coupling & Dependencies (HIGH)

- [`couple-law-of-demeter`](references/couple-law-of-demeter.md) - Enforce Law of Demeter with Delegation
- [`couple-feature-envy`](references/couple-feature-envy.md) - Move Method to Resolve Feature Envy
- [`couple-dependency-injection`](references/couple-dependency-injection.md) - Inject Dependencies via Constructor Defaults
- [`couple-composition-over-inheritance`](references/couple-composition-over-inheritance.md) - Replace Mixin with Composed Object
- [`couple-tell-dont-ask`](references/couple-tell-dont-ask.md) - Tell Objects What to Do, Don't Query Their State
- [`couple-avoid-class-methods-domain`](references/couple-avoid-class-methods-domain.md) - Avoid Class Methods in Domain Logic

### 4. Ruby Idioms (HIGH)

- [`idiom-prefer-enumerable`](references/idiom-prefer-enumerable.md) - Use map/select/reject Over each with Accumulator
- [`idiom-keyword-arguments`](references/idiom-keyword-arguments.md) - Use Keyword Arguments for Clarity
- [`idiom-duck-typing`](references/idiom-duck-typing.md) - Use respond_to? Over is_a? for Type Checking
- [`idiom-predicate-methods`](references/idiom-predicate-methods.md) - Name Boolean Methods with ? Suffix
- [`idiom-respond-to-missing`](references/idiom-respond-to-missing.md) - Always Pair method_missing with respond_to_missing?
- [`idiom-block-yield`](references/idiom-block-yield.md) - Use yield Over block.call for Simple Blocks
- [`idiom-implicit-return`](references/idiom-implicit-return.md) - Omit Explicit return for Last Expression

### 5. Data & Value Objects (MEDIUM-HIGH)

- [`data-value-object`](references/data-value-object.md) - Replace Primitive Obsession with Value Objects
- [`data-define-immutable`](references/data-define-immutable.md) - Use Data.define for Immutable Value Objects
- [`data-encapsulate-collection`](references/data-encapsulate-collection.md) - Encapsulate Collections Behind Domain Methods
- [`data-replace-data-clump`](references/data-replace-data-clump.md) - Replace Data Clumps with Grouped Objects
- [`data-separate-query-command`](references/data-separate-query-command.md) - Separate Query Methods from Command Methods

### 6. Design Patterns (MEDIUM)

- [`pattern-strategy`](references/pattern-strategy.md) - Extract Algorithm Variations into Strategy Objects
- [`pattern-factory`](references/pattern-factory.md) - Use Factory Method to Abstract Object Creation
- [`pattern-template-method`](references/pattern-template-method.md) - Define Algorithm Skeleton with Template Method
- [`pattern-decorator`](references/pattern-decorator.md) - Wrap Objects with Decorator for Added Behavior
- [`pattern-null-object-protocol`](references/pattern-null-object-protocol.md) - Implement Null Object with Full Protocol

### 7. Modern Ruby 3.x (MEDIUM)

- [`modern-pattern-matching`](references/modern-pattern-matching.md) - Use case/in for Structural Pattern Matching
- [`modern-deconstruct-keys`](references/modern-deconstruct-keys.md) - Implement deconstruct_keys for Custom Pattern Matching
- [`modern-endless-methods`](references/modern-endless-methods.md) - Use Endless Method Definition for Simple Methods
- [`modern-hash-pattern-guard`](references/modern-hash-pattern-guard.md) - Use Pattern Matching with Guard Clauses
- [`modern-rightward-assignment`](references/modern-rightward-assignment.md) - Use Rightward Assignment for Pipeline Expressions

### 8. Naming & Readability (LOW-MEDIUM)

- [`name-intention-revealing`](references/name-intention-revealing.md) - Use Intention-Revealing Names
- [`name-consistent-vocabulary`](references/name-consistent-vocabulary.md) - Use One Word per Concept Across Codebase
- [`name-avoid-abbreviations`](references/name-avoid-abbreviations.md) - Spell Out Names Except Universal Abbreviations
- [`name-rename-to-remove-comments`](references/name-rename-to-remove-comments.md) - Rename to Eliminate Need for Comments

## 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

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

Все скиллы по теме «Код-ревью и рефакторинг» →
python-refactor-expert Giuseppe Trisciuoglio Субагент python-refactor-expert для Claude Code переписывает Python-код без изменения логики: наводит порядок в архитектуре, выносит настройки и внедряет тайпхинты. Пригодится после реализации новых фич. CX Codex ★ 372звёзд репо typescript-refactor-expert Giuseppe Trisciuoglio Субагент typescript-refactor-expert проводит рефакторинг кода на TypeScript и современном JavaScript без изменения поведения программы. Применяет принципы SOLID и чистой архитектуры после написания фич. CX Codex ★ 372звёзд репо safe-refactor JuliusBrussee Скилл safe-refactor ограничивает рефакторинг сохранением поведения: фиксирует проверки до правок кода, запрещает смешивать перенос структуры с новыми фичами. CX Codex +1 130 700установок refactor smallnest Скилл refactor для Claude Code пошагово перестраивает структуру кода по каталогу Мартина Фаулера без изменения поведения. Помогает устранять запахи кода и разбивать разросшиеся функции. CX Codex +1 538установок ruby-on-rails официальный github Правило ruby-on-rails для GitHub Copilot задаёт стандарты написания кода, архитектурные принципы и рекомендации по работе с базой данных в приложениях на Rails 8. CX Codex +1 ★ 41 430звёзд репо ruby sanjeed5 Задаёт команде единый стиль Ruby: RuboCop, соглашения Rails, работа с N+1 и защита от SQL-инъекций. CX Codex +1 ★ 3 589звёзд репо

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

Весь набор →
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установок rails-testing Скилл rails-testing для Claude Code содержит 46 правил для RSpec, FactoryBot и Capybara в Ruby on Rails. Помогает писать надёжные тесты моделей, запросов и фоновых задач Sidekiq. CX Codex +1 309установок 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установок ios-ui-refactor Скилл ios-ui-refactor для Claude Code проверяет существующие SwiftUI-экраны и предлагает рефакторинг визуальной иерархии, переходов и анимаций. Для работы нужны iOS 26 и Swift 6.2. CX Codex +1 299установок

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

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