svalmak.ruСергей Макаров

Как поручить ИИ доработку работающего сайта и сохранить контроль над изменениями

На мониторе открыты две версии одной веб-страницы. В правой выделена изменённая кнопка.
Иллюстрация предпросмотра. Сравнение двух версий страницы помогает заметить точечное изменение.

В конце новой статьи есть приглашение обсудить задачу. Сразу под ним шаблон предлагает обсудить её ещё раз. Если проверять только текст, повтор легко пропустить. На собранной странице он сразу заметен.

Поручите ИИ конкретную правку и попросите показать её в отдельном предпросмотре. Сохраните исходную версию, чтобы увидеть, какие файлы и строки изменились. Перед выкладкой проверьте, что на сайте всё ещё та версия, на которой собрали правку. Если за это время кто-то обновил затронутые файлы, сначала разберите отличия и повторите проверку на свежей версии.

Что дать ИИ вместе с задачей

Сформулируйте поручение так, чтобы результат можно было проверить по странице и по списку изменений.

Часть задачиЧто записать
РезультатЧто должен увидеть или суметь сделать посетитель
Область правкиКакие страницы, блоки, файлы или настройки можно менять
Контрольные сценарииКакие адреса, пункты меню и события аналитики нужно проверить после правки
Условия выпускаГде открыть предпросмотр, кто его принимает и когда остановить выкладку

Поручение для блога может выглядеть так. «Добавь новую статью в локальную сборку. Обнови список статей, карту сайта и блок из трёх карточек на главной. Покажи страницу в окне шириной 390 пикселей и приложи список изменённых файлов. Если потребуется изменить другую часть сайта, укажи это отдельно».

Сравните изменённые файлы с исходной версией. На главной откройте карточку из секции свежих материалов. На странице статьи проверьте ссылки и загрузку иллюстраций. Если задача затрагивает несколько систем, пригодится инструкция по подготовке ТЗ на автоматизацию.

Как заметили лишнее приглашение на svalmak.ru

При подготовке статьи о мебельном конфигураторе на собранной странице увидели два приглашения обсудить задачу. Первое было в тексте, второе появлялось сразу под ним из шаблона. В локальном предпросмотре этой страницы из нижнего блока убрали один абзац и оставили ссылку «Все статьи».

После правки предпросмотр открыли в браузере на четырёх ширинах от 320 до 1440 пикселей. Проверили, помещается ли таблица и загружаются ли иллюстрации. Затем зафиксировали контрольную сумму принятого HTML. После выпуска контрольная сумма HTML по публичному адресу совпала с ней.

В предпросмотре заметили повтор, а сравнение HTML показало, какой абзац убрали. Отдельно, при подготовке этого материала, на локальной копии вернули удалённый абзац и получили исходную контрольную сумму. Так проверили восстановление одного файла на копии.

Сверка правки шаблона: убрать повтор, проверить предпросмотр и сравнить опубликованный HTML.
Как исправили повторное приглашение перед выпуском предыдущей статьи.

Что проверить перед выпуском и после него

Перед выкладкой сравните текущую версию затронутых файлов с той, на которой готовили предпросмотр. У статического сайта для этого подходят контрольные суммы файлов. В CMS проверьте версию записи, шаблона или настройки, которую меняете. При расхождении остановите выпуск, выясните, что изменилось, и подготовьте новый предпросмотр.

До выпуска сохраните копии заменяемых файлов и запишите, какие новые файлы нужно убрать при откате. Если после выкладки понадобится вернуть прежнюю версию, сначала сравните затронутые файлы с только что выпущенной версией. При совпадении восстановите файлы по этому списку. Если файлы уже изменились, разберите эти правки перед восстановлением. Для изменений в базе данных нужен отдельный порядок. О том, как его проверить, читайте в статье о резервной копии сайта.

После выкладки откройте публичный адрес. У статьи проверьте заголовок и текст, изображения, ссылки и canonical — адрес, который страница указывает как основной. Затем проверьте, появилась ли статья в блоге, на главной и в карте сайта, если эти места входили в задачу. Для формы или корзины пройдите тот сценарий, ради которого внесли правку. Если пришлось восстановить копию, повторите проверку на публичном адресе.

Два макета страницы лежат рядом, один проверяют линейкой и карандашом
Иллюстрация предпросмотра. Сверьте новую страницу с исходной и проверьте, что изменились только нужные элементы.

Как отделить подготовку от разрешения на выпуск

ИИ можно поручить собрать правку, перечислить изменённые файлы и выполнить заданные проверки. Разрешение на выпуск привяжите к конкретной принятой сборке. Если выпуск автоматический, его условия должны проверяться и в момент выкладки.

Начните с одного блока. Зафиксируйте исходный вид страницы, запишите ожидаемое изменение и попросите показать его в предпросмотре. Затем проверьте, можно ли по вашему описанию однозначно решить, что результат готов к выпуску.

Если нужна помощь с доработкой сайта, можно обсудить задачу по автоматизации или развитию сайта.