upstash-workflow
Используется для обработки Upstash Workflow и QStash, создания долговечных шагов и асинхронного fan-out. Применяется при настройке триггеров и обработчиков в этих сервисах.
Что делает навык
Набор стандартных паттернов для реализации асинхронных рабочих процессов (workflows) с использованием Upstash Workflow и QStash в среде LobeHub. Решает задачи долговечных шагов, асинхронного fan-out для больших пакетов и обеспечения идемпотентности при обработке данных. Архитектура строго разделена на три слоя: точку входа, пагинацию и однократное выполнение задачи.
Когда применять
- Настройка триггеров и обработчиков для автоматической обработки больших объемов данных (например, авто-суммаризация тем или оценка агентов).
- Реализация механизма dry-run для получения статистики обработки без запуска побочных эффектов.
- Разделение крупных пакетов на чанки (fan-out) для предотвращения превышения лимитов шагов workflow.
- Параллельная обработка отдельных элементов с контролем скорости (flowControl) и идемпотентностью.
Как работает
- Определить сущность для обработки, бизнес-логику для одного элемента и логику фильтрации (например, через Redis или базу данных).
- Создать Workflow-класс со статическими методами trigger* и реализовать Layer 1 (Entry Point): валидация, расчет количества элементов, поддержка dry-run и запуск Layer 2.
- Реализовать Layer 2 (Pagination): обработка курсорной пагинации, разделение больших пакетов на чанки (CHUNK_SIZE=20) и рекурсивный запуск Layer 3.
- Реализовать Layer 3 (Single Task Execution): обработка ровно одного элемента за вызов с использованием context.run() и настройкой flowControl.
- Настроить маршрутизацию в Hono-приложении (apps/server/src/router-hono/workflows/) и подключить её через Next.js route.
- Протестировать workflow в режиме dry-run, затем с небольшим пакетом данных перед полным развертыванием.
Примеры запросов агенту
Что понадобится
- Переменные окружения: APP_URL, QSTASH_TOKEN (и опционально QSTASH_URL).
- Среда LobeHub с использованием Hono для роутинга и Upstash Workflow/QStash.
- TypeScript для определения типов полезной нагрузки (payload types).
Описание составлено по SKILL.md навыка, сверено 07.10.2026.
Как подключить
SKILL.md к навыкам ассистентаНавык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.