# 051-design-two-steps-methods

Скилл 051-design-two-steps-methods для Claude Code разбивает сложные или рискованные изменения кода на два этапа: рефакторинг без изменения логики, затем внесение нужного поведения.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 170 установок · ★ 465 у репозитория
- Автор: Juan Antonio Breña Moral
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/jabrena/plinth/tree/HEAD/skills/051-design-two-steps-methods/SKILL.md
- Обновлён: 2026-10-21
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/051-design-two-steps-methods

## Что делает

Метод основан на подходе Кента Бека: сначала сделайте изменение лёгким, потом сделайте лёгкое изменение. Скилл проводит через все этапы — от определения целевого поведения через идентификацию препятствий дизайна, к подготовительному рефакторингу, проверке, что поведение не изменилось, и только потом к самому изменению.

Скилл обязывает чётко отделить подготовку от изменения логики. Для каждого этапа нужна валидация: после рефакторинга проверяют, что тесты проходят и поведение сохранилось, после изменения — что новое поведение работает. Если препятствие нельзя отделить полностью, скилл записывает допущения и риски.

Применяется для Java и работает со всеми платформами: Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode. Стоит включать, когда вы говорите агенту «сделай это изменение безопаснее», «отрефакторь перед изменением» или «разделим подготовку и поведение».

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add jabrena/plinth --skill 051-design-two-steps-methods -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/051-design-two-steps-methods/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/051-design-two-steps-methods/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add jabrena/plinth --skill 051-design-two-steps-methods -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/051-design-two-steps-methods/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add jabrena/plinth --skill 051-design-two-steps-methods -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/051-design-two-steps-methods/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install jabrena/plinth skills/051-design-two-steps-methods
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/051-design-two-steps-methods/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add jabrena/plinth --skill 051-design-two-steps-methods -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/jabrena/plinth --path skills/051-design-two-steps-methods
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/051-design-two-steps-methods/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add jabrena/plinth --skill 051-design-two-steps-methods -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/jabrena/plinth/tree/HEAD/skills/051-design-two-steps-methods/SKILL.md

## Когда брать
- разбить рискованное изменение на безопасные этапы
- подготовить дизайн рефакторингом перед логическим изменением
- убедиться, что поведение сохранилось после подготовки
- отделить подготовку от изменения и валидировать каждый шаг
- снизить вероятность багов при сложных изменениях кода

## Примеры запросов агенту
- Разделим это изменение на два этапа по методу Бека
- Сделай это изменение безопаснее, отрефакторь перед тем, как менять поведение
- Подготовь дизайн рефакторингом, потом я внесу нужное изменение

## Похожие
- [design-patterns](https://affpapa.org/nevibecode/skills/decebals-design-patterns.md) — скилл · 389 установок
- [unit-test-utility-methods](https://affpapa.org/nevibecode/skills/unit-test-utility-methods.md) — скилл · 3900 установок
- [java-refactoring-extract-method](https://affpapa.org/nevibecode/skills/java-refactoring-extract-method.md) — скилл · 9284 установки
- [java-refactoring-remove-parameter](https://affpapa.org/nevibecode/skills/java-refactoring-remove-parameter.md) — скилл · 8900 установок
- [clean-code](https://affpapa.org/nevibecode/skills/decebals-clean-code.md) — скилл · 448 установок
- [java-architect](https://affpapa.org/nevibecode/agents/voltagent-java-architect.md) — субагент · ★ 6505 у репозитория

Из того же набора: [jabrena/plinth](https://affpapa.org/nevibecode/by/jabrena/plinth.md) — 123 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
