Видеоинструкция устарела: составляем правки с ИИ

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

Разберём, как обновить инструкцию «Как дать клиенту доступ только к папке с готовыми макетами». Для примера возьмём вымышленный файловый сервис: названия разделов, таймкоды и изменения в нём придуманы.

Для кого и какой версии снят ролик

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

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

Дата анонса не означает, что изменение уже появилось у зрителя. Google Workspace различает каналы выпуска Rapid Release и Scheduled Release. Atlassian показывает, как изменения распространяются по приложениям организации. В справке функция уже может быть описана, хотя в нужном аккаунте её ещё нет. Записывайте видео в том аккаунте, для пользователей которого готовите инструкцию.

Для установленного приложения сохраните название и номер сборки. Microsoft в истории версий Teams разделяет платформы и типы развёртывания и предупреждает: по этому списку нельзя узнать, какая сборка уже доступна в конкретном аккаунте. Номер в журнале версий ещё не означает, что зритель получил нужный интерфейс.

Что собрать перед сравнением

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

1. Сделайте расшифровку. Проверьте по записи названия кнопок, отрицания, числа и фразы о правах. Исправьте ошибки распознавания, сохранив то, что сказал автор.
2. Для каждого действия запишите старый таймкод, реплику, нажатие в кадре и ожидаемый результат. Не пропустите шаги, которые автор показывает молча.
3. Найдите в официальных заметках о релизах изменения, которые затрагивают эти шаги. Сохраните дату, условия доступности и ссылку на источник в рабочей таблице.
4. Повторите действия на тестовых файлах с теми правами, которые есть у зрителя. Сделайте скриншоты до нажатия, после него и с результатом. Подпишите файлы номерами шагов.
5. Отметьте, что не удалось проверить: нет нужного доступа, обновление ещё не появилось, экран выглядит иначе, справка описывает другую редакцию. Не заполняйте эти пробелы догадками.

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

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

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

Кнопка переехала или функция исчезла

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

В документации Confluence есть пример переноса: основные пункты навигации переместились из верхней панели в боковую, а настройки пространства открываются через меню дополнительных действий рядом с его именем. Настройки не исчезли, изменился путь к ним. Для своей записи всё равно проверьте текущий экран и права пользователя.

Если функцию заменили, придётся разбирать весь способ работы. Google Calendar заменил appointment slots на appointment schedules. В объявлении говорилось, что старые страницы бронирования перестанут работать, а настройки нужно создать заново. Здесь недостаточно сказать «кнопка теперь называется иначе»: меняются действия, результат и ссылки, которыми человек пользуется после просмотра.

Почему у зрителя нет нужной кнопки

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

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

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

Список фрагментов на замену

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

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

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

Что поручить нейросети

Подпишите материалы так, чтобы их легко было найти: «старый шаг 4», «экран C2», «релиз R3». Попросите модель указывать эти метки в каждом выводе. Без скриншотов она может сравнить реплики со справкой, но не проверить, что сейчас на экране. Если сама озвучка недоступна, нельзя считать, что расшифровка передаёт её точно.

Эти материалы можно передать Claude Opus в MashaGPT и попросить список конкретных правок. Добавьте нужные выдержки и изображения, которые можете передать в своём рабочем процессе. Сама по себе ссылка на закрытый ролик не означает, что модель посмотрела его целиком. Просите указывать, на что она опирается и чего пока не знает.

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

Как переписать ошибочный шаг

Возьмём фрагмент 00:42-01:10. Автор открыл карточку проекта и показывает, как пригласить в него клиента. В старой озвучке сказано:

Нажмите «Пригласить», выберите «Участник» и скопируйте ссылку. Отправьте её клиенту, чтобы он посмотрел готовые макеты.

Комментарий редактора. Не сказано, к чему получит доступ клиент: к готовой папке или ко всему проекту. Переименовать кнопку недостаточно. Проверьте, что новый способ открывает только нужную папку и что зритель сможет повторить его со своими правами.

В новой записи сначала покажите выбранную папку, затем её настройки доступа и выбранный режим. Названия кнопок сверьте с текущим экраном. Реплика может звучать так:

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

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

Посмотрите, что сказано и показано до и после заменяемого фрагмента. Перед ним автор мог открыть весь проект, а следом сказать «теперь участник команды увидит все документы». Эта фраза будет противоречить новому объяснению. Проверьте соседние переходы и показ результата, даже если сами экраны там не изменились.

Что поправить вместе с видео

Задания «перезаписать середину» не хватит. Укажите точный фрагмент, что в нём заменить, почему и кто проверит готовую запись. Не забудьте тексты и ссылки, которыми пользуется зритель. Для инструкции о макетах список будет таким:

• Экран: вместо приглашения в проект показать доступ к выбранной папке. Проверить, что видно нужную папку и режим, курсор не закрывает кнопку, а пользователь с правами зрителя может повторить действие.
• Озвучка: сказать, к чему получит доступ клиент, и убрать противоречащие реплики рядом. В записи голос должен объяснять то действие, которое зритель видит на экране.
• Описание: указать версию продукта, дату проверки и нужные права, исправить подготовку и шаги, отметить существенное изменение. Человек должен понять, подходит ли ему этот ролик.
• Ссылка: проверить ссылку, которую копирует автор, и ссылки в старом описании. Получатель должен открывать нужную папку или страницу, а не весь проект или устаревшую инструкцию.
• Субтитры: заменить старые названия и подогнать текст под новую речь. Проверить, что субтитры не предлагают нажать исчезнувшую кнопку и не теряют отрицания или условия.
• Таймкоды и главы: после замены фрагмента проверить время начала каждого шага и исправить отметки в описании. Переход должен вести к нужному действию, а не в середину реплики.

Дата проверки в описании не исправит неверный кадр. И обновлённый ролик не поможет, если ссылка в письме или базе знаний ведёт на старую запись. Проверьте страницу справки, закреплённые материалы, сообщения поддержки и внутренние ссылки. Как заменить уже опубликованное видео, зависит от площадки: сначала выясните, что она позволяет.

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

Повторите действия с правами зрителя

Попросите коллегу выполнить действия по обновлённому ролику без ваших подсказок, используя файлы без секретных данных. Расскажите ему только о той подготовке, которая указана в видео или описании. Запишите, где пришлось угадывать, выбирать неупомянутый файл или искать кнопку. Так вы проверите, работает ли инструкция в этой версии продукта. Для другой версии её придётся проверять отдельно.

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

Начните там, где начинается инструкция, и повторите все шаги. Затем проверьте ссылки, субтитры и таймкоды. Получился ли именно тот результат, который обещает ролик? Если обязательный шаг всё ещё помечен «требует проверки», обновление не закончено. Уверенный ответ модели и скриншот кнопки не доказывают, что действие сработает.

Когда вернуться к инструкции

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

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