# migration

Скилл для перевода легаси-проекта AEM 6.x, AMS или on-prem на AEM as a Cloud Service: сначала разбор проекта, потом починка одного блокера за сессию.

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

## Что делает

Скилл работает в двух режимах. Первый — обзор: просите проверить проект на миграцию, и агент собирает read-only `migration-runbook.md` со всеми паттернами миграции, затронутыми файлами и примерами промптов. Правок в коде он не делает. Второй режим — точечная починка конкретного блокера Cloud Service: планировщик, `ResourceChangeListener`, репликация, `EventListener`, OSGi `EventHandler`, DAM `AssetManager`, линт `data-sly-test` в HTL, диалоги Classic UI / ExtJS / Coral 2 → Coral 3, Custom Design Widgets, зависимости установки Vault-пакетов, замена кеша Guava на Caffeine, разбор использования `java.io.InputStream`, перевод статических шаблонов в редактируемые.

Данные о находках берутся из BPA — CSV или кеша, либо через CAM и MCP. Есть и ручной путь: указать пару файлов, BPA тогда не нужен. Отдельно скилл выносит секреты из конфигов OSGi в Cloud Manager, сканируя `ui.config` и `.cfg.json` на плейсхолдеры `$[secret:]` и `$[env:]`, и конвертирует конфиги Dispatcher из AMS или on-prem в формат AEMaaCS.

Главное ограничение — одна сессия, один паттерн. Попросите «починить всё» — скилл сначала заставит выбрать, планировщик или репликация. Так сделано намеренно: правила и шаги трансформации живут в другом скилле, `code-assessment`, и туда идёт передача после определения паттерна. Поэтому ставьте установку `aem-cloud-service` целиком, чтобы обе ветки были на месте.

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install adobe/skills migration
```

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

### Gemini CLI

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

2. **Командой платформы**
```bash
gemini skills install https://github.com/adobe/skills --path plugins/aem/cloud-service/skills/migration
```

### Windsurf (Devin Desktop)

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

### OpenCode

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

### Claude.ai

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

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

## Когда брать
- оценить весь проект AEM перед переездом в Cloud Service и получить список затронутых файлов
- починить находки планировщика по выгрузке BPA в CSV
- забрать находки из CAM через MCP, выбрав нужный проект из списка
- вынести секреты из конфигов OSGi в переменные Cloud Manager
- перевести статические шаблоны в редактируемые и сгенерировать правила Modernize Tools

## Примеры запросов агенту
- Проверь мой код на миграцию в AEMaaCS
- Почини находки scheduler по `./path/to/bpa.csv`
- Забери находки scheduler из CAM, проект выберу из списка

## Похожие
- [kotlin-tooling-immutable-collections-0-5-x-migration](https://affpapa.org/nevibecode/skills/kotlin-tooling-immutable-collections-0-5-x-migration.md) — скилл · 1000 установок
- [java-migration](https://affpapa.org/nevibecode/skills/java-migration.md) — скилл · 321 установка
- [tigris-s3-migration](https://affpapa.org/nevibecode/skills/tigris-s3-migration.md) — скилл · 3100 установок
- [d1-migration](https://affpapa.org/nevibecode/skills/d1-migration.md) — скилл · 1200 установок
- [deprecation-and-migration](https://affpapa.org/nevibecode/skills/deprecation-and-migration.md) — скилл · 57400 установок
- [migration-readiness](https://affpapa.org/nevibecode/skills/migration-readiness.md) — скилл · 540 установок

## Другие версии с тем же именем
- [migration · juliusbrussee](https://affpapa.org/nevibecode/skills/migration.md) — 103900 установок

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

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

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