Safe Action: хуки
Use when executing next-safe-action actions from React client components -- useAction, useOptimisticAction, handling status/callbacks (onSuccess/onError/onSettled), execute vs executeAsync, or optimistic UI updates
AInext-safe-action
official
Дизайн
Что делает навык
Набор React-хуков для безопасного взаимодействия с серверными действиями (actions) next-safe-action. Позволяет управлять состоянием выполнения, обрабатывать ошибки и реализовывать оптимистичные обновления интерфейса.
Когда применять
- Вызов серверных действий из клиентских компонентов React с обработкой статуса выполнения.
- Реализация оптимистичных обновлений UI до получения ответа от сервера.
- Управление локальным состоянием, связанным с выполнением действий (например, флаги загрузки).
- Обработка результатов выполнения действий через колбэки onSuccess, onError, onSettled.
Как работает
- Импортировать необходимые хуки (useAction, useOptimisticAction, useStateAction, useOptimisticStateAction) из пакета next-safe-action/hooks.
- Выбрать подходящий хук в зависимости от задачи: useAction для стандартного выполнения, useOptimisticAction для оптимистичных обновлений.
- Использовать хуки в компоненте для обертки вызова action, получая доступ к статусу и функциям выполнения.
- Настроить обработку состояний через параметры хуков или колбэки (onSuccess, onError, onSettled).
Примеры запросов агенту
Как использовать useAction для вызова серверного действия с обработкой ошибок?
Реализуй оптимистичное обновление списка через useOptimisticAction.
Как получить статус выполнения действия с помощью useStateAction?
Что понадобится
- Среда выполнения с поддержкой React и пакетом next-safe-action
Описание составлено по SKILL.md навыка, сверено 06.10.2026.
Как подключить
1Скачать навык
# возьмите папку навыка «safe-action-hooks» из репозитория:
# https://github.com/next-safe-action/skills
2Положить папку с
SKILL.md к навыкам ассистента# положите папку навыка туда, где ассистент ищет skills:
cp -r safe-action-hooks/ ~/.claude/skills/safe-action-hooks/
Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.