Защита код-ревью от ИИ-многословия: как прятать сгенерированные описания PR за тегами detailsЗаметка · дайджест за 10 ноября
Чистый интерфейс Pull Request с лаконичной карточкой изменений и аккуратной складной секцией details для скрытия отчётов ИИ
Заметка2 раздела≈ 4 мин

Защита код-ревью от ИИ-многословия: как прятать сгенерированные описания PR за тегами details

«Это не обязательно нейрослоп, но читается ровно как нейрослоп!» — так Саймон Уиллисон, соавтор Django и создатель Datasette, в свежей заметке описал побочный эффект кодинг-агентов. Почти все правки в его проектах открывают Claude Code и Codex, оформляя их в пулл-реквесты (pull request, или PR — заявка на вливание кода в общую ветку). Модели пишут к ним образцово точные пояснения, но первая же реакция живого человека одна: «Я не буду всё это читать».

Уиллисон ловит себя на этом раздражении даже тогда, когда сам пару минут назад запустил агента: читать машинное эссе дольше, чем ставить задачу, и командная проверка буксует. Как сохранить подробный журнал нейросети для истории, но вернуть в разработку уважение к чужому вниманию?

Ловушка идеального отчёта: почему точность превращается в белый шум

Дело не в галлюцинациях — агенты чересчур исполнительны. В заявке № 3042 для Datasette агент переделал загрузку скрипта edit-tools.js (~220 КБ): раньше файл скачивался на каждой странице у всех посетителей подряд, а теперь подгружается только для редакторов при наведении мыши или клике на ссылку правки. Задача прозрачная, но к готовому коду модель приложила отчёт на 150 строк с предысторией, развилками и логом проверок, от которого у ревьюера мгновенно стекленеют глаза.

Когда в тексте одинаково важно всё подряд, читатель теряет главное.

Это как вызвать сантехника к капающему крану и спросить, в чём была поломка. Вместо короткого «Лопнула прокладка на горячей воде, заменил — сухо» мастер кладёт на стол пухлый акт: марка латуни, давление в стояке и хронометраж каждого поворота ключа. Ни слова лжи, но на втором листе ты теряешь нить и пропускаешь важную деталь — что резьба вентиля еле держится. У меня при виде многоэкранных ИИ-описаний на GitHub включается тот же защитный рефлекс.

На код-ревью — проверке кода перед публикацией — коллеге нужна не стенограмма робота, а живой редакторский фильтр.

Двухслойный шаблон details и правило для агента

Чтобы вернуть этот фильтр и сохранить журнал аудита, Уиллисон разделил описание PR на два этажа. Наверху остаётся пара предложений от автора (иногда со скриншотом или выводом --help), которые сразу вводят в курс дела; часто эту точную фразу достаточно просто вытащить из черновика самой модели.

А весь подробный доклад агента уходит под спойлер HTML-тегов <details> и <summary>.

Согласно документации GitHub, разметка GitHub Flavored Markdown поддерживает их штатно (как и GitLab с Bitbucket). Саймон ставит в <summary> имя модели и уровень усилий — вроде Claude Opus 5.5 Medium, а чтобы не путать порядок тегов, советует проговорить вслух «details-summary»: два слога плюс три звучат складнее, чем «summary-details». Важная тонкость: сразу после </summary> обязана стоять пустая строка, иначе списки и код внутри сломаются в сырую кашу. Упакуем нашу заявку со скриптом edit-tools.js в такой шаблон:

Скрипт `edit-tools.js` (~220 КБ) раньше скачивался на каждой странице у всех посетителей. Теперь он подгружается через лёгкий загрузчик только для редакторов при наведении мыши или клике на правку.

<details>
<summary>Детали работы агента (Claude Opus 5.5 Medium)</summary>

**Что изменилось в коде:**
- Вынесен загрузчик для отложенной инициализации инструментов правки.
- Проверены сценарии доступа для читателей и редакторов.
</details>

На странице GitHub длинная простыня схлопывается в аккуратную плашку под двумя ясными предложениями. Коллега за пару секунд считывает суть оптимизации и открывает вкладку с кодом, а при поиске редкого бага через полгода вся история проверок раскроется в один клик. Чтобы не набирать скобки вручную (тем более с телефона, где у GitHub нет кнопки спойлера), пропиши это правило одной строкой в CLAUDE.md — только не перегружай конфиг бюрократией, о чём мы говорили в разборе про аудит системных промптов в Claude Code.

Свёрнутое описание бережёт глаза ревьюера, но не позволяет одобрять код вслепую: вычитывать правки и тесты нужно лично (как выстроить эту дисциплину, разобрано в статье про контроль качества и код-ревью при работе с ИИ-ассистентами).

А если оглянуться на твой сегодняшний день — в каких ещё рабочих отчётах, письмах или чатах людям вокруг не хватает твоих двух живых предложений поверх длинного текста от нейросети?

Хочу подробный разборГолоса помогают выбрать, что разобрать подробно. За этот материал 0 голосов.
Источники · 2