Post #167

Как превратить «болото» из кода в понятные и адекватное? [ Рефакторинг, легаси и ревью через AI ] Да, мы продолжаем нашу рубрику, где повышаем продуктивность за счет внедрения AI. И сегодня мы обсудим, как с его помощью работать быстрее с кодом. Итак. AI превращает работу с чужим/старым кодом из «болота» в достаточно понятный процесс: – объясняет, что делает сложный или запутанный файл; – помогает разбивать огромные функции на небольшие; – предлагает более чистую архитектуру; – облегчает массовый рефакторинг (поиск по репозиторию, замену API, миграции). Claude Code, например, заточен под работу с большими кодовыми базами и может искать и менять вызовы по всему проекту. Типовая схема работы 1️⃣ Понимание легаси «Объясни, что делает этот файл/класс/модуль. Опиши входы/выходы, побочные эффекты и потенциальные проблемы.» «Нарисуй (словами) схему, как этот модуль взаимодействует с остальными частями проекта.» 2️⃣ Поиск проблем «Найди потенциальные точки для рефакторинга в этом коде: дублирования, слишком большие функции, нарушенные принципы SOLID.» «Предложи, как можно улучшить структуру без изменения поведения.» 3️⃣ Сам рефакторинг «Разбей этот метод на несколько маленьких, сохрани поведение.» «Перепиши этот код под [новую версию фреймворка/библиотеки].» «Замени использование библиотеки X на Y во всем проекте, предложи пошаговый план и пример кода.» 4️⃣ Ревью и авто‑ревью «Сделай code review этого диффа: где проблемы, что улучшить по стилю, читаемости, производительности?» «Проверь, нет ли здесь возможных утечек памяти/ресурсов/SQL‑инъекций и т.п.» Мини‑чеклист безопасного рефакторинга с AI 📍 Сначала — понимание Попросить AI объяснить код своими словами и проверить, что вы согласны с описанием. 📍 Потом — тестовые сценарии «Опиши набор тестов, который должен пройти этот код. Какие edge‑cases нужно проверить?» Если тестов нет — создаете хотя бы часть по списку от AI. 📍 Только потом — изменения Просите AI предложить патч, но сами внимательно читаете дифф. 📍 В конце: – прогоняете тесты; – проверяете критические сценарии руками; – смотрите, нет ли изменений в поведении (логах, метриках, интерфейсе). Что ж. На сегодня это все. Сохраняйте к себе мини-инструкцию и ставьте — 🦄, если нужно продолжать эту рубрику