Clarify

/impeccable clarify

Good fit

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

Когда использовать

/impeccable clarify — для текстов интерфейса, которые заставляют людей останавливаться и думать. Запутанные подписи, двусмысленные тексты кнопок, сообщения об ошибках, обвиняющие пользователя, подсказки, повторяющие подпись, пустые состояния, которые ничего полезного не говорят. Используйте, когда проблема не в макете и не в цвете, а в словах.

Хорошие триггеры: «пользователи не понимают это поле», «сообщение об ошибке не помогает», «не могу написать хороший текст кнопки», «эта подсказка бесполезна».

Как это работает

Навык переписывает текст на поверхностях, где живут большинство проблем UX-копирайтинга:

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

Навык использует данные об аудитории и психическом состоянии из PRODUCT.md для настройки голоса. Техническая аудитория получает точный язык. Потребительская аудитория получает простую речь. Спешащие пользователи получают короткий текст. Тревожные пользователи (платёж, удаление) получают поддержку.

Попробуйте

/impeccable clarify the billing form

До и после, типично:

• Подпись «Billing address» → «Адрес на вашей карте»
• Плейсхолдер «Enter your VAT ID» → «VAT ID (необязательно, для бизнеса)»
• Ошибка «Invalid input» → «Номер карты состоит из 15 цифр. Вы ввели 14.»
• Кнопка «Submit» → «Списать $29 и оформить подписку»
• Пустое состояние «No transactions yet» → «Ваш первый платёж появится здесь после первого заказа.»

Подводные камни

• Написание более умного, а не более ясного. Clarify не для улучшения голоса. Если текст уже ясный, не обращайтесь к этому навыку. Используйте /impeccable delight, когда нужен характер.
• Пропуск вопроса об аудитории. Clarize должен знать, кто читает. Если PRODUCT.md не указывает технический уровень аудитории, переработки будут стандартными.
• Запуск clarify на маркетинговых текстах. Clarify — для функционального UX-текста: подписи, ошибки, инструкции. Маркетинговый текст требует другого набора приёмов и человеческого автора.

Related commands

• Adapt
• Polish
• Onboard