AIKraft/Skills/upstash-workflow

upstash-workflow

Используется для обработки Upstash Workflow и QStash, создания долговечных шагов и асинхронного fan-out. Применяется при настройке триггеров и обработчиков в этих сервисах.

LOLobeHub official Разработка ★ 83k

Что делает навык

Набор стандартных паттернов для реализации асинхронных рабочих процессов (workflows) с использованием Upstash Workflow и QStash в среде LobeHub. Решает задачи долговечных шагов, асинхронного fan-out для больших пакетов и обеспечения идемпотентности при обработке данных. Архитектура строго разделена на три слоя: точку входа, пагинацию и однократное выполнение задачи.

Когда применять

  • Настройка триггеров и обработчиков для автоматической обработки больших объемов данных (например, авто-суммаризация тем или оценка агентов).
  • Реализация механизма dry-run для получения статистики обработки без запуска побочных эффектов.
  • Разделение крупных пакетов на чанки (fan-out) для предотвращения превышения лимитов шагов workflow.
  • Параллельная обработка отдельных элементов с контролем скорости (flowControl) и идемпотентностью.

Как работает

  1. Определить сущность для обработки, бизнес-логику для одного элемента и логику фильтрации (например, через Redis или базу данных).
  2. Создать Workflow-класс со статическими методами trigger* и реализовать Layer 1 (Entry Point): валидация, расчет количества элементов, поддержка dry-run и запуск Layer 2.
  3. Реализовать Layer 2 (Pagination): обработка курсорной пагинации, разделение больших пакетов на чанки (CHUNK_SIZE=20) и рекурсивный запуск Layer 3.
  4. Реализовать Layer 3 (Single Task Execution): обработка ровно одного элемента за вызов с использованием context.run() и настройкой flowControl.
  5. Настроить маршрутизацию в Hono-приложении (apps/server/src/router-hono/workflows/) и подключить её через Next.js route.
  6. Протестировать workflow в режиме dry-run, затем с небольшим пакетом данных перед полным развертыванием.

Примеры запросов агенту

Реализуй workflow для авто-суммаризации тем, используя паттерны LobeHub с поддержкой dry-run и fan-out.
Настрой Layer 3 для обработки одного элемента агента с контролем параллелизма через flowControl.
Создай структуру workflow с тремя слоями: entry point, paginate и execute, для обработки списка пользователей.

Что понадобится

  • Переменные окружения: APP_URL, QSTASH_TOKEN (и опционально QSTASH_URL).
  • Среда LobeHub с использованием Hono для роутинга и Upstash Workflow/QStash.
  • TypeScript для определения типов полезной нагрузки (payload types).

Описание составлено по SKILL.md навыка, сверено 07.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «upstash-workflow» из репозитория: # https://github.com/lobehub/lobehub
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r upstash-workflow/ ~/.claude/skills/upstash-workflow/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.