Сценарий «Объясни код» (code_explain) разбирает уже написанный код: что делает фрагмент, какие риски, как связаны модули. Новый код не генерируется — для этого есть отдельный сценарий «Генерация кода».
Как запустить
- Прикрепите файл или вставьте фрагмент в сообщение.
- Откройте чат по ссылке объясни код (
?scenario=code_explain). - Спросите конкретно: «что делает этот хендлер?», «где гонка?», «как это стыкуется с RAG?».
Что ожидать в ответе
- Краткое назначение блока и поток данных.
- Замечания по читаемости, ошибкам и edge cases.
- Ссылки на контекст из вашей библиотеки, если код или runbook уже в индексе.
Сценарий не исполняет код на сервере и не подменяет code review команды — это ускоритель понимания.
Практики применения
- Онбординг в чужой модуль перед правкой.
- Подготовка к code review: список вопросов к автору.
- Разбор legacy-скрипта из вложения без переписывания «с нуля».
Как формулировать запрос, чтобы разбор был точным
Укажите контекст: язык, фреймворк, что уже известно о модуле. Вместо «объясни файл целиком» лучше спросить про функцию, класс или участок с подозрительной логикой. Если в библиотеке есть runbook или архитектурная заметка по этому сервису, Adminica может связать код с вашей документацией и показать источники рядом с выводами.
Чего сценарий не делает
- Не запускает код в песочнице — для исполнения есть отдельные инструменты.
- Не заменяет обязательный review в Git: это помощник для понимания до правки.
- Не переписывает репозиторий «с нуля» — только объясняет уже написанное.
На онбординге полезно прогнать один и тот же фрагмент двумя формулировками («что делает?» и «какие риски?») и сравнить глубину ответа. Так команда быстрее привыкает к RAG-чату с цитатами из своей базы знаний.
Языки и размер вложений
Разбор работает для типичных языков DevOps-стека; для очень больших файлов прикладывайте только нужный фрагмент или укажите диапазон строк. Если в ответе не хватает контекста из библиотеки, добавьте в чат ссылку на архитектурную заметку или регламент — RAG подтянет цитаты рядом с разбором кода.
Итог: «Объясни код» — безопасный разбор существующего кода в чате; генерацию примеров оставляйте сценарию code_generation.