← Заметки

Проектирование UI и UX с Claude Code и Codex — сценарии, Figma и доступность

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

Это продолжение предыдущей статьи о создании сайтов, теперь с акцентом на UI и UX. 20 ноября 2026 года я проверил открытые навыки Claude Code и Codex и материалы Figma, Vercel и W3C. На их основе пройдём сценарий отмены брони от проектирования до проверки в браузере.

Как подобрать навык под результат

Требуемый результат Навык или подход Что проверить
Пользовательский сценарий и состояния экрана Проектные инструкции frontend-architecture-design Проверьте, описаны ли вход в сценарий, подтверждение, выход, обработка, успех и ошибка. Если есть исследования с реальными пользователями, разделите наблюдения и гипотезы.
Прототип для обсуждения Плагин Product Design для Codex Подготовьте макет, по которому можно проверить переходы между состояниями. Убедитесь, что есть способ сохранить бронь и способ подтвердить отмену.
Визуальное направление и код интерфейса frontend-design для Claude Code Определите визуальный приоритет заголовка, пояснения и кнопок. Проверьте, что смысл и порядок сохраняются с длинным заголовком или на узком экране.
Сборка экранов в Figma figma-generate-design из плагина Figma Переиспользуйте экземпляры кнопок и диалогов из библиотеки и создайте фрейм для каждого состояния. Проверьте, что сохраняются связи с компонентами и переменными.
Библиотека дизайн-системы figma-generate-library из плагина Figma Создайте или обновите переменные и библиотеку Figma на основе компонентов и дизайн-токенов из кода. Сверьте варианты и привязки переменных с именами в исходниках.
Реализация согласованного макета Figma figma-design-to-code из плагина Figma Изучите нужный фрейм и реализуйте его в существующем коде интерфейса. После сравнения экранов отдельно проверьте клавиатурное управление и состояния ошибки.
Тексты интерфейса Проектные инструкции по UX-текстам, например cms-ux-writing Формулируйте результат нажатия глаголом. Подписи «Сохранить бронь» и «Подтвердить отмену» ясно описывают последствия каждого действия.
Проверка интерфейса web-design-guidelines от Vercel и проверка в браузере Найдите в коде возможные проблемы интерфейса и доступности. В браузере проверьте порядок клавиатурной навигации, перемещение фокуса и компоновку на разных размерах экрана.

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

В Claude Code навык Anthropic frontend-design входит в набор example-skills официального каталога. Для работы с навыками Figma в Codex нужны подключённые к плагину инструменты Figma и доступ к файлу. При создании экранов или компонентов в Figma используйте инструкции плагина figma-use вместе с нужным навыком создания. Чтобы изучить макет для реализации, передайте ссылку на нужный фрейм. Чтобы создать новый, предоставьте редактируемый файл и библиотеку для повторного использования. Установка Anthropic · Плагин Figma для Codex

Если у вас есть брендбук, приложите логотип, цвета, шрифты и примеры запрещённого использования. Если выбрать навык Anthropic brand-guidelines для бренда команды только по названию, можно получить цвета и типографику Anthropic. Встроенные материалы рассчитаны на бренд Anthropic. Исходник brand-guidelines

Как передать сценарий отмены в дизайн и разработку

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

Действие пользователя или состояние сервера Что происходит на экране
Пользователь выбирает «Открыть варианты отмены» в деталях брони Открывается диалог, фокус переходит на «Сохранить бронь».
«Сохранить бронь» или Escape Диалог закрывается, бронь сохраняется. Фокус возвращается на кнопку открытия.
Пользователь выбирает «Подтвердить отмену» В рабочем сервисе отправляется запрос и показывается состояние обработки. Повтор того же запроса не приводит к повторной обработке.
Сервер подтверждает успех Состояние меняется на «Бронь отменена», интерфейс сообщает результат.
Сервер сообщает об ошибке Состояние брони сохраняется, интерфейс сообщает причину и доступные дальнейшие действия.

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

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

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

Упражнение — проверяем фокус диалога и оба результата

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

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

Подготовьте Node.js 22 и Chrome. В новой папке выполните npm init -y и npm install --save-dev playwright-core@1.64.1. Сохраните код как dialog-check.mjs и выполните node dialog-check.mjs. Если Chrome установлен не по стандартному пути, задайте CHROME_PATH. В примере подписи интерфейса на корейском. Параметры запуска Playwright

import assert from 'node:assert/strict';
import { chromium } from 'playwright-core';

const browser = await chromium.launch({
  executablePath: process.env.CHROME_PATH
    ?? '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
});

try {
  const page = await browser.newPage({ viewport: { width: 360, height: 700 } });
  page.setDefaultTimeout(2000);
  await page.setContent(`
    <button id="open">취소 옵션 열기</button>
    <p role="status">예약 유지 중</p>
    <dialog aria-labelledby="title" aria-describedby="description">
      <h2 id="title">예약을 취소할까요?</h2>
      <p id="description">확정하면 예약 상태가 취소됨으로 바뀝니다.</p>
      <form method="dialog">
        <button value="keep" autofocus>예약 유지</button>
        <button value="cancel">예약 취소 확정</button>
      </form>
    </dialog>
    <script>
      const trigger = document.querySelector('#open');
      const dialog = document.querySelector('dialog');
      const status = document.querySelector('[role="status"]');

      trigger.addEventListener('click', () => {
        dialog.returnValue = '';
        dialog.showModal();
      });
      dialog.addEventListener('close', () => {
        if (dialog.returnValue === 'cancel') {
          status.textContent = '예약 취소됨';
        }
      });
    </script>
  `);

  const trigger = page.getByRole('button', { name: '취소 옵션 열기' });
  const dialog = page.getByRole('dialog', { name: '예약을 취소할까요?' });
  const status = page.getByRole('status');
  const focused = () => page.evaluate(
    () => document.activeElement?.textContent?.trim(),
  );

  for (const close of ['Escape', '예약 유지']) {
    await trigger.focus();
    await page.keyboard.press('Enter');
    await dialog.waitFor({ state: 'visible' });
    assert.equal(await focused(), '예약 유지', '초기 포커스');
    await page.keyboard.press(close === 'Escape' ? 'Escape' : 'Enter');
    await dialog.waitFor({ state: 'hidden' });
    assert.equal(await status.textContent(), '예약 유지 중');
    assert.equal(await focused(), '취소 옵션 열기', '닫은 뒤 포커스');
    console.log(`PASS ${close}: 예약 유지 및 포커스 복귀`);
  }

  await page.keyboard.press('Enter');
  await dialog.waitFor({ state: 'visible' });
  assert.equal(await focused(), '예약 유지', '초기 포커스');
  await page.keyboard.press('Tab');
  assert.equal(await focused(), '예약 취소 확정', '확정 버튼 포커스');
  await page.keyboard.press('Enter');
  await page.waitForFunction(
    () => document.querySelector('[role="status"]').textContent === '예약 취소됨',
  );
  await dialog.waitFor({ state: 'hidden' });
  assert.equal(await focused(), '취소 옵션 열기', '확정 뒤 포커스');
  console.log('PASS 예약 취소 확정: 상태 변경 및 포커스 복귀');
} finally {
  await browser.close();
}

Так выглядит вывод запуска в Chrome на macOS.

PASS Escape: 예약 유지 및 포커스 복귀
PASS 예약 유지: 예약 유지 및 포커스 복귀
PASS 예약 취소 확정: 상태 변경 및 포커스 복귀

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

Обсуждение

Посмотреть на GitHub ↗