# Migrate: перенесите проект Lagune на основе манифеста на навыки и плагины

> Перенесите проект Lagune на основе манифеста на Lagune на основе навыков, сохранив принципы безопасности, артефакты, отслеживание и собственные специализации.

Канонический URL: https://lagune.ai/ru-RU/docs/commands/migrate
Язык: ru-RU
Оригинал: https://lagune.ai/docs/commands/migrate
Последнее обновление: 2026-11-03

🔀 Перенесите проект **Lagune** на основе манифеста на **Lagune** на основе навыков, сохранив все, что вы написали.

**Уведомление об устаревании**

Проект с манифестом продолжает работать как есть до `v1.x`: `npx lagune` передает `init`, `pull`, `update`, `add`, `remove`, `list` и дашборд в `lagune@0.15.0`, последнюю версию на основе манифеста.

## Перенос

1. Убедитесь, что текущая работа закоммичена, затем запустите migrate из корня проекта:

   ```bash
   npx lagune migrate
   ```

2. Закоммитьте то, что команда изменила, отдельным коммитом, чтобы перенос остался одним изменением, которое легко проверить.
3. Установите команды для своего агента, как показано на [странице установки](https://lagune.ai/ru-RU/docs).
4. Если в проекте уже есть артефакт detect, plan или harden, попросите [`/lagune-repair`](https://lagune.ai/ru-RU/docs/commands/repair) сверить старые ссылки в них и в ваших собственных специализациях:

   ```prompt
   /lagune-repair Сверь примененные специализации (ранее sub-skills) в артефактах в `.lagune/memory/` (`detect.md`, `plan.md` и `harden.md`) с именами, которые перечисляет новый каталог, и перепиши каждый вызов старых хуков из `.lagune/hooks/` в моих собственных специализациях в `.lagune/catalog/` как вызов инструмента `lagune_read` или `lagune_write`.
   ```

## Что меняется

| До                                                                    | После                                                                             |
| --------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| `.lagune/templates/`, `.lagune/hooks/` и `.lagune/specializations.md` | Удалены: каждый навык несет свой шаблон, а хуки запускает движок                  |
| Копии встроенных специализаций в `.lagune/skills/`                    | Удалены: встроенные специализации отдает движок                                   |
| Ваши собственные специализации в `.lagune/skills/`                    | Перемещены в `.lagune/catalog/`                                                   |
| `.lagune/skills.json`, индекс ваших собственных специализаций         | Объединен с `.lagune/configs.json`                                                |
| Категории из манифеста                                                | Зафиксированы в `.lagune/configs.json`                                            |
| Старые команды агента, такие как `/lagune.detect`                     | Удалены: [установка **Lagune**](https://lagune.ai/ru-RU/docs) приносит новые, такие как `/lagune-detect` |
| Блок **Lagune** в `.gitignore`                                        | Удален, вместе с файлом, если в нем больше ничего не было                         |
| `.lagune/proofs/`, игнорируемая этим блоком                           | Не попадает в коммиты благодаря собственному `.gitignore`                         |
| `.lagune/manifest.json`                                               | Удален, последним                                                                 |

Ваша работа по безопасности остается как есть: принципы безопасности, артефакт, созданный каждой фазой, и карта отслеживания с путями, на которые указывает каждая находка.

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

### Обязательно ли выполнять миграцию?

Да. Проекты на основе манифеста устарели и продолжают работать только до v1.x, поэтому выполните npx lagune migrate, чтобы перенести свой.

### Что сохраняет migrate?

Ваши принципы безопасности, каждый артефакт фаз, карту отслеживания, ваши категории и собственные специализации. Специализации переезжают в .lagune/catalog/, а их индекс присоединяется к вашим категориям в .lagune/configs.json.

### Когда устанавливать новые команды?

После migrate, как показано на странице установки для вашего агента. Можно установить и сначала, поскольку migrate сохраняет новую /lagune.

### Коллега уже выполнил миграцию. Что запускать мне?

Получите изменения с переносом, затем один раз выполните npx lagune migrate. Команда удалит то, что Lagune на основе манифеста оставил в вашем клоне и что никогда не попадало в систему контроля версий, и не пустит ваши доказательства в коммиты.