Исходные сообщения, места появления, фактические причины сбоев и доступные действия пользователя.
Новые сообщения об ошибках и отдельные технические пояснения для разработки или поддержки.
Кому пригодится
UX-редакторам, дизайнерам и разработчикам интерфейсов.
Требования и ограничения
Переписать ошибки интерфейса понятным языком
Error Message Writer помогает заменить неопределённые сообщения об ошибках текстом, после которого пользователь понимает, что произошло и как продолжить работу. Скилл подходит для форм, загрузки файлов, ограничений доступа и сбоев приложения.
Он работает с отдельными ошибками или их списком. Для каждого случая готовит пользовательский текст и отдельно указывает технические сведения, которые нужны разработчикам или поддержке. Полный аудит всех текстов интерфейса выходит за пределы этой задачи.
Что передать агенту
Нужны исходное сообщение, место его появления и описание фактического сбоя. Также следует указать, какие действия доступны пользователю: исправить поле, повторить запрос, выбрать другой файл, сменить учётную запись или обратиться за помощью.
Если текст должен сообщать о сохранённом черновике, состоянии платежа или причине отказа, эти сведения должны быть известны из поведения продукта. Скилл формулирует сообщение по предоставленным фактам; сам текст не подтверждает сохранность данных.
Из каких частей состоит сообщение
- Короткий заголовок называет действие, которое завершилось ошибкой.
- Основной текст объясняет следующий шаг одним или двумя предложениями.
- Причина добавляется, когда помогает устранить проблему.
- Ссылка на помощь или код для поддержки размещается как дополнительная информация.
Как меняются формулировки
Общая ошибка загрузки превращается в указание конкретного ограничения и способа его обойти. Если проблема в размере файла, сообщение называет действующий предел и предлагает уменьшить файл или выбрать другой. Число берут из требований продукта.
При отсутствии доступа пользователь получает понятный маршрут: обратиться к администратору или войти под подходящей учётной записью. При ошибке поля текст объясняет нужный формат и при необходимости показывает пример. Формат должен соответствовать аудитории и правилам конкретной формы.
Как выбрать тон и технические подробности
Обычная проверка поля допускает спокойный дружелюбный тон. Сбой системы требует ясного объяснения доступных действий. Потеря данных, платежи и вопросы безопасности предполагают серьёзную формулировку без шуток.
Обвинения в адрес пользователя убирают. Стек вызовов, внутренние названия исключений и технические коды сохраняют в отдельном слое. Код обращения может остаться в интерфейсе, если поддержка действительно использует его для поиска проблемы.
Что проверить перед внедрением
Каждое сообщение должно соответствовать конкретному состоянию приложения и предлагать доступное действие. Полезно пройти сценарий ошибки и убедиться, что кнопка, ссылка и сохранение введённых данных работают так, как описано. Замена текста сама по себе не меняет обработку сбоя в коде.
Автор и источник
Оригинальное название: error-message-writer
Автор или репозиторий: SkillMedev/skills
Лицензия: MIT
Открыть первоисточник