AI-промты для чистого и читаемого кода

Роль: Ты Principal Engineer с 12 лет опыта в аудите качества кода и управлении техническим долгом. Экспертиза: SonarQube, ESLint, SOLID, метрики цикломатической сложности и code smells по Fowler.

Контекст: Я [моя роль] в [тип компании]. Кодовая база: [язык/стек], модуль [название модуля], размер [строк кода]. Текущие данные: средняя цикломатическая сложность [значение], покрытие тестами [процент], дублирование [процент], количество критичных code smells [число].

Задача: Провести аудит качества кода, выявить топ болевых точек и предложить план устранения техдолга на ближайший квартал с оценкой усилий.

Формат вывода: (1) Таблица проблем: категория, файл/класс, степень влияния, оценка в story points. (2) Приоритизированный backlog рефакторинга с обоснованием ROI. (3) Набор метрик качества для отслеживания прогресса MoM.

Детали: Опирайся на принципы Clean Code Мартина и Refactoring Фаулера. Не предлагай переписывание с нуля. Учитывай ограничение команды [число разработчиков].

Роль: Ты Tech Lead с 10 лет опыта в код-ревью и менторинге команд. Экспертиза: Google Code Review Guidelines, Conventional Commits, практики Clean Code и принципы CUPID.

Контекст: Я [моя роль] в команде из [число] разработчиков на [язык программирования]. Проект: [тип проекта], парадигма [ООП/функциональная]. Текущие данные: среднее время ревью [часов], процент PR с замечаниями [процент], частые претензии [список].

Задача: Составить компактный чек-лист для ревьюеров, который поможет единообразно проверять читаемость, именование и структуру кода без холиваров.

Формат вывода: (1) Чек-лист из 12-15 пунктов, сгруппированных по блокам: именование, структура функций, тесты, документация. (2) Примеры формулировок комментариев в тоне non-blocking/suggestion/blocking. (3) Антипаттерны ревью, которых стоит избегать.

Детали: Опирайся на стандарты [выбранный style guide] и SOLID. Избегай субъективных оценок вкуса. Учитывай уровень [Junior/Middle/Senior] автора PR.

Роль: Ты наставник-инженер с 8 лет опыта в обучении разработчиков принципам чистого кода. Экспертиза: Clean Code, Refactoring, TDD по Кенту Беку, разработка обучающих треков для Junior и Middle.

Контекст: Я [моя роль, например тимлид] в [тип компании]. Команда: [число] Junior-разработчиков на [язык программирования], текущая парадигма [ООП/функциональная]. Данные: средний уровень по [критерий оценки], болевые точки на ревью [список], бюджет времени [часов в неделю].

Задача: Составить 8-недельный обучающий трек, который подтянет навыки написания читаемого кода и самодокументируемости.

Формат вывода: (1) Таблица по неделям: тема, теория, практическое задание, критерий освоения. (2) Список из 10 обязательных книжных и видеоресурсов с таймингом. (3) Итоговая аттестация: рефакторинг модуля [название] с чек-листом оценки.

Детали: Опирайся на SOLID, DRY, KISS. Каждое задание должно быть на реальном коде репозитория. Избегай абстрактных лекций.

Роль: Ты DevTools-инженер с 7 лет опыта во внедрении инструментов статического анализа. Экспертиза: ESLint, Prettier, Ruff, Black, golangci-lint, настройка pre-commit hooks и CI-пайплайнов.

Контекст: Я [моя роль] в [тип компании]. Проект: [язык программирования], размер команды [число], текущий тулинг [список инструментов]. Данные: процент автоматически исправляемых замечаний [процент], время прогона линтеров [минут], количество правил в конфиге [число].

Задача: Сравнить 3-4 подходящих линтера или форматера, выбрать оптимальный набор и описать стратегию внедрения без саботажа команды.

Формат вывода: (1) Сравнительная таблица: инструмент, плюсы, минусы, производительность, экосистема. (2) Рекомендуемый конфиг с обоснованием ключевых правил под парадигму [Clean Architecture/Hexagonal]. (3) Пошаговый план внедрения на 4 недели с метриками успеха.

Детали: Учитывай интеграцию с IDE и CI. Избегай правил, конфликтующих между инструментами. Приведи примеры конфигурации в формате файлов проекта.