# inngest-v3-v4-migration

Помогает обновить TypeScript-код с Inngest SDK v3 до v4 или устранить ошибки смешанного API. Сканирует репозиторий, меняет триггеры, схемы и вызовы функций по шагам.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 589 установок · ★ 29
- Автор: inngest
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/inngest/inngest-skills/tree/HEAD/skills/inngest-v3-v4-migration/SKILL.md
- Обновлён: 2026-09-28
- HTML: https://affpapa.org/nevibecode/skills/inngest-v3-v4-migration

## Что делает

Скилл выполняет миграцию по строгому порядку: сначала запускает поиск по кодовой базе через `rg`, чтобы найти все вызовы клиента, устаревшие `EventSchemas`, конфигурацию `serve` и старый пакет `@inngest/realtime`. Это позволяет классифицировать проект и зафиксировать проблемные места перед правками.

Во время обновления параметры `signingKey` и `baseUrl` переносятся из вызова `serve(...)` прямо в конструктор `new Inngest(...)`. Триггеры перемещаются в массив `triggers` внутри настроек функции, а вместо строковых идентификаторов в `step.invoke` внедряются прямые ссылки на функции или вызовы `referenceFunction`.

В v4 среда по умолчанию работает в Cloud mode, поэтому для локальной разработки обязательно нужен флаг `INNGEST_DEV=1`. Утилита `staticSchema` принимает только `type`, из-за чего интерфейсы TypeScript придётся переписать на алиасы типов.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add inngest/inngest-skills --skill inngest-v3-v4-migration -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/inngest-v3-v4-migration/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/inngest-v3-v4-migration/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add inngest/inngest-skills --skill inngest-v3-v4-migration -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/inngest-v3-v4-migration/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add inngest/inngest-skills --skill inngest-v3-v4-migration -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/inngest-v3-v4-migration/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install inngest/inngest-skills inngest-v3-v4-migration
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/inngest-v3-v4-migration/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add inngest/inngest-skills --skill inngest-v3-v4-migration -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/inngest/inngest-skills --path skills/inngest-v3-v4-migration
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/inngest-v3-v4-migration/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add inngest/inngest-skills --skill inngest-v3-v4-migration -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/inngest/inngest-skills/tree/HEAD/skills/inngest-v3-v4-migration/SKILL.md

## Когда брать
- Перенести триггеры событий и крон-задач в объект опций `createFunction`
- Заменить устаревшие `EventSchemas` на модульные `eventType` и `staticSchema`
- Переписать строковые идентификаторы в `step.invoke` на прямые ссылки или `referenceFunction`
- Удалить отдельный пакет `@inngest/realtime` и перейти на нативный v4 API

## Примеры запросов агенту
- Обнови кодовую базу с Inngest v3 до v4 и исправь вызовы `step.invoke`
- Переведи схемы событий с `EventSchemas` на `eventType` и проверь типы
- Устрани ошибки `signing key required` после перехода на Inngest v4

## Похожие
- [inngest](https://affpapa.org/nevibecode/skills/sickn33-inngest.md) — скилл · 1200 установок
- [workers-best-practices](https://affpapa.org/nevibecode/skills/cloudflare-workers-best-practices.md) — скилл · 126100 установок
- [workflow-automation](https://affpapa.org/nevibecode/skills/sickn33-workflow-automation.md) — скилл · 1500 установок
- [databricks-serverless-migration](https://affpapa.org/nevibecode/skills/databricks-serverless-migration.md) — скилл · 631 установка
- [pixijs-migration-v8](https://affpapa.org/nevibecode/skills/pixijs-migration-v8.md) — скилл · 5300 установок
- [cms-migration](https://affpapa.org/nevibecode/skills/cms-migration.md) — скилл · 1900 установок

Из того же набора: [inngest/inngest-skills](https://affpapa.org/nevibecode/by/inngest/inngest-skills.md) — 14 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md