SkillFoxx
Telegram

Workflow SDK — скилл

Пять скиллов от Vercel по Workflow SDK: установка, написание долговечных рабочих процессов и переход между версиями.

  • 2 506 ★ репозитория
  • Последний коммит
  • Apache-2.0
Скилл

Расширенный доступ

Почему такой уровень

  • Скилл `workflow-init` ставит пакеты и правит конфигурацию фреймворка, а скиллы переноса переписывают код процессов.
Все причины и проверки

vercel/workflowАвтор:Vercel

Установка

Ручная установка

npm install workflow

Ставит сам SDK вместе с документацией, из которой читает скилл `workflow`.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Скилл `workflow-init` ставит пакеты и правит конфигурацию фреймворка, а скиллы переноса переписывают код процессов.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Workflow SDK делает функции на TypeScript долговечными: сохраняет ход выполнения, повторяет сбойные шаги и дает процессу ждать без расхода вычислений. Папка `skills/` репозитория учит агента работать с этим пакетом. `workflow-init` ставит и настраивает SDK под фреймворк проекта, от Next.js до Nuxt, Astro и SvelteKit. Скилл `workflow` предписывает искать ответы в документации, которая лежит в `node_modules/workflow/docs`, и содержит справку по директивам `"use workflow"` и `"use step"`. `migrating-to-workflow-sdk` переносит процессы из Temporal, Inngest, Trigger.dev и AWS Step Functions. Два скилла с v4 на v5 обновляют приложения и собственные реализации World до новой спецификации.

Для кого. Командам на TypeScript с фоновыми задачами, которые нельзя терять при сбое, и тем, кто переезжает на Workflow SDK с Temporal или Inngest.

Подходит, если

  • В проекте на Next.js или Hono еще нет Workflow SDK, и его надо поставить с правильной настройкой.
  • Процесс должен пережить перезапуск сервера, дождаться вебхука или одобрения и продолжить работу.
  • Пайплайн на Temporal или Inngest переписывается на Workflow SDK, и агенту нужны правила переноса.
  • Зависимость `workflow` поднимается с четвертой версии на пятую, а старые вызовы пропали.

Не подходит, если

  • Нужна одна короткая фоновая функция без повторов и ожидания: хватит очереди или обычного вызова.
  • Оркестрация уже работает на Temporal, и миграция не планируется.
  • Проект пишется не на TypeScript или JavaScript: SDK и скиллы рассчитаны на эти языки.

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

Подключи Workflow SDK к проекту на Next.js и напиши процесс онбординга, который ждет подтверждения почты.

Ограничения

Скиллы работают вместе с пакетом `workflow`: скилл `workflow` ссылается на документацию из `node_modules`, поэтому до установки SDK его место занимает `workflow-init`. В README нет команды установки самих скиллов, их берут из папки `skills/` вручную. Папка содержит и служебный скилл `internal-dev-workbench` для разработчиков самого SDK, обычному проекту он не нужен. Для управляемого хостинга, очередей и наблюдаемости нужен Vercel, для самостоятельного размещения нужен бэкенд Postgres или собственная реализация World.

Как отключить. Удалите скопированные папки скиллов из каталога скиллов агента. Пакет `workflow` и настройки фреймворка в проекте останутся и убираются отдельно.

Частые вопросы

Как установить скиллы Workflow SDK?

Скопируйте нужные папки из `skills/` репозитория в каталог скиллов агента. Сам пакет ставится командой `npm install workflow`, она лежит в разделе быстрого старта README.

Чем workflow-init отличается от workflow?

`workflow-init` нужен, пока пакета `workflow` нет в проекте: он определяет фреймворк и ведет по руководству по установке. Когда SDK уже стоит, подключайте `workflow`, который читает документацию нужной версии.

Как перенести процесс с Temporal на Workflow SDK?

Скилл `migrating-to-workflow-sdk` определяет исходную систему, целевое окружение и такие элементы, как ожидания и повторы. Затем он оформляет оркестрацию в функциях с `"use workflow"`, а побочные эффекты в функциях с `"use step"`.

Как открыть интерфейс наблюдения за процессами?

Запустите приложение командой `npm run dev` и в другом терминале выполните `npx workflow web`. Локально бэкенд работает без настройки.

Где работает Workflow SDK?

Локально на встроенном бэкенде, на Vercel с управляемым хранилищем и очередями, а также на своем сервере с Postgres. Перечень сторонних реализаций World лежит на странице Worlds сайта проекта.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

Навык Temporal Developer учит агента писать воркфлоу, активности и воркеры на восьми SDK и разбирать зависшие запуски

СкиллМинимальный доступ238
Официальный

Официальные скиллы WorkOS: роутер и 40 справочников по AuthKit, SSO, Directory Sync, RBAC, Vault и миграциям с Auth0 и Clerk

СкиллРасширенный доступ46
Официальный

Скилл Elysia v2 учит агента писать, отлаживать и переносить бэкенды на Elysia: валидация, плагины, типизированные клиенты и деплой

СкиллМинимальный доступ71

Два скилла для Payload CMS: коллекции, хуки и доступы плюс перенос контента из WordPress, Strapi и Contentful.

СкиллМинимальный доступ172

17 скиллов учат агента писать приложения на Convex по документации и вести проект через PRD, task.md и журнал изменений

СкиллРасширенный доступ404

Сотни скиллов по провайдерам учат агента принимать вебхуки, проверять подписи и разбирать события; примеры для Express и FastAPI.

СкиллМинимальный доступ101

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйЗвезды репозиторияГлавное отличие
Workflow SDK (эта карточка)нет2 506
Vercel Pluginнет334общий плагин Vercel со скиллами по Next.js, AI SDK и деплою; здесь скиллы только по долговечным процессам
Vercel AI SDKда27 894скилл про чат, стриминг и агентов на AI SDK; Workflow SDK отвечает за переживание сбоев и ожидание

Коротко о README

README открывается быстрым стартом: `npm install workflow`, подключение к фреймворку, запуск процесса через `start()`. Дальше описаны варианты размещения, заметки о сообществе и порядок сообщения об уязвимостях.

Бейдж для README

Исходный SKILL.md

---
name: workflow
description: Creates durable, resumable workflows using Vercel's Workflow SDK. Use when building workflows that need to survive restarts, pause for external events, retry on failure, or coordinate multi-step operations over time. Triggers on mentions of "workflow", "durable functions", "resumable", "workflow sdk", "queue", "event", "push", "subscribe", or step-based orchestration.
metadata:
  author: Vercel Inc.
  version: '1.18'
---

## *Critical*: Always use correct `workflow` documentation

Your knowledge of `workflow` is outdated.

The `workflow` documentation outlined below matches the installed version of the Workflow SDK.
Follow these instructions before starting on any `workflow`-related tasks:

Search the bundled documentation in `node_modules/workflow/docs/`:

1. **Find docs**: `glob "node_modules/workflow/docs/**/*.mdx"`
2. **Search content**: `grep "your query" node_modules/workflow/docs/`

Documentation structure in `node_modules/workflow/docs/`:

- `getting-started/` - Framework setup (next.mdx, express.mdx, hono.mdx, etc.)
- `foundations/` - Core concepts (workflows-and-steps.mdx, hooks.mdx, streaming.mdx, etc.)
- `api-reference/workflow/` - API docs (sleep.mdx, create-hook.mdx, fatal-error.mdx, etc.)
- `api-reference/workflow-api/` - Client API (start.mdx, get-run.mdx, resume-hook.mdx, etc.)
- `api-reference/workflow-runtime/` - Runtime API (get-world.mdx) and `world/` World SDK (storage.mdx, streams.mdx, queue.mdx)
- `api-reference/workflow-observability/` - Hydration and name parsing utilities (hydrate-resource-io.mdx, parse-workflow-name.mdx, etc.)
- `ai/`: AI SDK integration docs
- `errors/` - Error code documentation
- `worlds/` - Per-World behavior and limits (vercel.mdx, local.mdx, postgres.mdx). Other pages link these as `/worlds/<name>`.

Related packages also include bundled docs:

- `@ai-sdk/workflow`: `node_modules/ai/docs/` - WorkflowAgent and AI SDK integration
- `@workflow/ai`: `node_modules/@workflow/ai/docs/` - deprecated DurableAgent APIs for existing applications
- `@workflow/core`: `node_modules/@workflow/core/docs/` - Core runtime (foundations, how-it-works)
- `@workflow/next`: `node_modules/@workflow/next/docs/` - Next.js integration

**When in doubt, update to the latest version of the Workflow SDK.**

### Official resources

- **Website**: https://workflow-sdk.dev
- **GitHub**: https://github.com/vercel/workflow

Сообщить о проблеме