# Migrate: انقل مشروع Lagune القائم على manifest إلى المهارات والإضافات

> انقل مشروع Lagune القائم على manifest إلى Lagune القائم على المهارات، مع الحفاظ على ميثاق الأمان والمُخرَجات والتتبع وتخصصاتك الخاصة.

Canonical: https://lagune.ai/ar-AE/docs/commands/migrate
اللغة: ar-AE
الأصل: https://lagune.ai/docs/commands/migrate
آخر تحديث: 2026-11-09

🔀 انقل مشروع **Lagune** القائم على manifest إلى **Lagune** القائم على المهارات، مع الحفاظ على كل ما كتبته.

**إشعار إهمال**

يستمر المشروع الذي يحتوي على manifest في العمل كما هو حتى `v1.x`: يسلّم `npx lagune` الأوامر `init` و `pull` و `update` و `add` و `remove` و `list` ولوحة التحكم إلى `lagune@0.15.0`، آخر إصدار قائم على manifest.

## النقل

1. تأكد من أن عملك الحالي محفوظ في commit، ثم شغّل migrate من جذر المشروع:

   ```bash
   npx lagune migrate
   ```

2. أضف إلى commit ما غيّره فقط، ليبقى النقل تغييرًا واحدًا قابلًا للمراجعة.
3. ثبّت الأوامر لوكيلك، كما تعرض [صفحة التثبيت](https://lagune.ai/ar-AE/docs).
4. إن كان في المشروع مُخرَج detect أو plan أو harden بالفعل، فاطلب من [`/lagune-repair`](https://lagune.ai/ar-AE/docs/commands/repair) مواءمة المراجع القديمة فيها وفي تخصصاتك الخاصة:

   ```prompt
   /lagune-repair وائم التخصصات المطبّقة (sub-skills سابقًا) في المُخرَجات تحت `.lagune/memory/` (`detect.md` و `plan.md` و `harden.md`) مع الأسماء التي يسردها الكتالوج الجديد، وأعد كتابة كل استدعاء تجريه تخصصاتي الخاصة في `.lagune/catalog/` إلى الـ hooks القديمة في `.lagune/hooks/` كاستدعاء للأداة `lagune_read` أو `lagune_write`.
   ```

## ما الذي يتغيّر

| قبل                                                                    | بعد                                                                          |
| ---------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
| `.lagune/templates/` و `.lagune/hooks/` و `.lagune/specializations.md` | أُزيلت: تحمل كل مهارة قالبها، ويشغّل المحرك الـ hooks                        |
| نسخ التخصصات المدمجة في `.lagune/skills/`                              | أُزيلت: يقدّم المحرك التخصصات المدمجة                                        |
| تخصصاتك الخاصة في `.lagune/skills/`                                    | نُقلت إلى `.lagune/catalog/`                                                 |
| `.lagune/skills.json`، فهرس تخصصاتك الخاصة                             | دُمج في `.lagune/configs.json`                                               |
| فئات الـ manifest                                                      | سُجّلت في `.lagune/configs.json`                                             |
| أوامر الوكيل القديمة، مثل `/lagune.detect`                             | أُزيلت: [تثبيت **Lagune**](https://lagune.ai/ar-AE/docs) يجلب الأوامر الجديدة، مثل `/lagune-detect` |
| كتلة **Lagune** في `.gitignore`                                        | أُزيلت، مع الملف إن لم يكن يحتوي على شيء آخر                                 |
| `.lagune/proofs/`، الذي كانت تتجاهله تلك الكتلة                        | يُبقيه ملف `.gitignore` الخاص به خارج كل commit                              |
| `.lagune/manifest.json`                                                | حُذف، في النهاية                                                             |

يبقى عملك الأمني كما هو: ميثاق الأمان، والمُخرَج الذي أنتجته كل مرحلة، وخريطة التتبع بالمسارات التي تشير إليها كل ملاحظة.

## الأسئلة الشائعة

### هل يجب أن أُرحّل مشروعي؟

نعم. المشاريع القائمة على manifest مُهملة ولن تستمر في العمل إلا حتى v1.x، لذلك شغّل npx lagune migrate لنقل مشروعك.

### ما الذي يحافظ عليه migrate؟

ميثاق الأمان، وكل مُخرَجات المراحل، وخريطة التتبع، وفئاتك، وتخصصاتك الخاصة. تنتقل التخصصات إلى ‎.lagune/catalog/‎، وينضم فهرسها إلى فئاتك في ‎.lagune/configs.json.

### متى أثبّت الأوامر الجديدة؟

بعد migrate، كما تعرض صفحة التثبيت لوكيلك. والتثبيت أولًا يعمل أيضًا، لأن migrate يحافظ على الأمر الجديد ‎/lagune.

### زميلي أجرى الترحيل بالفعل. ماذا أشغّل؟

اسحب النقل، ثم شغّل npx lagune migrate مرة واحدة. يزيل ما تركه Lagune القائم على manifest في نسختك المحلية، وهو ما لم يحمله نظام التحكم في الإصدارات أبدًا، ويُبقي إثباتاتك خارج كل commit.