Скилл Claude Code для безопасного рефакторинга
Готовый SKILL.md: агент чистит код, а сайт работает как раньше
Какую задачу решает
Рефакторить код без изменения внешнего поведения
Что будет на выходе
Установленный скилл и рефакторинг с сохранённым поведением
- Кому подойдёт
Вайбкодер с разросшимся проектом, который боится, что агент при чистке кода всё сломает
- Тема
- Агенты и Claude Code
- Инструменты
- Claude Code
Проект, собранный с агентом, через пару месяцев превращается в один контроллер на 900 строк и три копии одной и той же функции расчёта цены. Просишь Claude Code «навести порядок» — и он заодно переименовывает поле в базе, меняет формат ответа API и обновляет пару библиотек. Форма заявки молча перестаёт работать, а ты узнаёшь об этом от клиента.
Ниже готовый SKILL.md, который запрещает агенту такие «улучшения». С ним рефакторинг идёт маленькими шагами: сначала тесты фиксируют, как код работает сейчас, потом агент меняет одно место, прогоняет те же тесты и показывает diff. Если что-то поехало, ты откатываешь только одну правку.
Кладёшь SKILL.md в папку проекта, говоришь агенту, что разобрать, и получаешь чистый код с тем же поведением: те же адреса, те же поля в ответах, те же данные в базе. Каждый шаг — отдельный коммит с доказательством, что ничего не сломалось.
Что получишь
- Полный текст скилла
safe-refactorна русском: что агенту можно трогать, что нельзя, в каком порядке работать и что показать в конце. - Команду запуска, которую достаточно дополнить одним предложением о своей задаче.
- Список того, что проверить руками, прежде чем принимать работу.
Скилл не делает код быстрее и не добавляет функций. Его задача одна: код внутри становится понятнее, а снаружи всё работает как раньше. Если хочешь новую функцию, это другая задача, про неё есть отдельный гайд.
Как использовать
- 1Закоммить всё, что есть
Агент начинает с git status. Если там висят твои несохранённые правки, он остановится и спросит.
- 2Положи SKILL.md в проект
Создай папку .claude/skills/safe-refactor/ в корне проекта и сохрани туда файл SKILL.md из блока ниже.
- 3Перезапусти Claude Code
Спроси агента «какие скиллы ты видишь?». В списке должен быть safe-refactor.
- 4Назови одно место
Один файл или одна функция за запуск: «контроллер заявок», «расчёт стоимости в корзине».
- 5Прими по отчёту
Смотри список изменённых файлов, результат тестов и пункт «что не трогал». Не устраивает — откат одной командой.
Если работаешь в Cursor или другом AI-кодере, скопируй текст скилла без шапки между --- и вставь его в начало задачи. Правила те же, просто агент не подхватит их сам.
Рядом по теме: Cursor Rules для рефакторинга: refactor.mdc без поломок, Свой скилл переупаковки: одна статья — пять форматов, Скилл для проверки интерфейсов после вайбкодинга, статья «Как сделать Telegram-бота с ИИ» и 12 модов Claude Code для вайбкодера (490 ₽).
Дальше — для участников
Регистрация бесплатная и занимает минуту. Часть закрытых материалов откроется сразу, без карты.
Что дальше
- Разберись в чужом проекте, ничего не сломав — если перед рефакторингом нужно понять, как вообще устроен код.
- CLAUDE.md, который агент правда читает — куда записать правила проекта, чтобы не повторять их в каждой задаче.
- Хватит повторять одно и то же: сделай скилл — как собрать свой скилл по образцу этого.
Если проект ещё только в голове и хочется сразу собирать его так, чтобы потом не разгребать, загляни в Первый экран за 990 ₽: шесть шагов от идеи до работающего экрана с агентом.
