# swc-plugin-compatibility

Скилл swc-plugin-compatibility помогает устранить сбои сборки и несовместимость @lingui/swc-plugin с Next.js, Vite и Rspack, когда макросы локализации не преобразуются.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 305 установок · ★ 12 у репозитория
- Автор: lingui
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/lingui/skills/tree/HEAD/skills/swc-plugin-compatibility/SKILL.md
- Обновлён: 2026-10-20
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/swc-plugin-compatibility

## Что делает

Скилл диагностирует ошибки Wasm-плагина Lingui при сборке: «failed to run Wasm plugin transform», сбои десериализации программы или ситуации, когда макросы `Trans` и `t` попадают в рендер сырым кодом. Проблема кроется не в коде приложения, а в несовпадении версий `swc_core` между хостом сборки и плагином.

Внутри разобран пошаговый порядок проверки. Сначала определяется хост: встроенный SWC в Next.js или конкретный резолв `@swc/core` в lockfile для Vite и Rspack. Далее по диапазону рантайма и таблице совместимости выбирается версия `@lingui/swc-plugin`, а также проверяются `peerDependencies` относительно `@lingui/core`. Для Vite описан альтернативный путь через нативный трансформ в `@lingui/vite-plugin` с параметром `macroTransform: true`, который исключает зависимость от ABI SWC.

Без точной фиксации версии плагина в `devDependencies` без символов `^` и `~` любое плановое обновление пакетов снова сломает сборку.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add lingui/skills --skill swc-plugin-compatibility -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add lingui/skills --skill swc-plugin-compatibility -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add lingui/skills --skill swc-plugin-compatibility -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install lingui/skills skills/swc-plugin-compatibility
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add lingui/skills --skill swc-plugin-compatibility -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/lingui/skills --path skills/swc-plugin-compatibility
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add lingui/skills --skill swc-plugin-compatibility -a opencode
```

### Claude.ai

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

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

## Когда брать
- устранить ошибку failed to run Wasm plugin transform при сборке
- исправить отображение необработанных макросов Trans и t
- подобрать версию @lingui/swc-plugin под релиз Next.js или @swc/core
- настроить нативный трансформ макросов в @lingui/vite-plugin

## Примеры запросов агенту
- Помоги починить ошибку failed to invoke plugin в Next.js при сборке с Lingui
- Какую версию @lingui/swc-plugin поставить для @swc/core из моего lockfile?
- Как переключить сборку Vite на нативный трансформ макросов Lingui?

## Похожие
- [hot-reload-optimizer](https://affpapa.org/nevibecode/skills/hot-reload-optimizer.md) — скилл · 267 установок
- [next-intl-add-language](https://affpapa.org/nevibecode/skills/next-intl-add-language.md) — скилл · 9349 установок
- [i18n-expert](https://affpapa.org/nevibecode/skills/i18n-expert.md) — скилл · 2800 установок
- [internationalization-i18n](https://affpapa.org/nevibecode/skills/internationalization-i18n.md) — скилл · 1000 установок
- [next-intl-app-router](https://affpapa.org/nevibecode/skills/next-intl-app-router.md) — скилл · 619 установок
- [localization-engineer](https://affpapa.org/nevibecode/skills/localization-engineer.md) — скилл · 163 установки

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

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

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