# Migrate：マニフェスト方式の Lagune プロジェクトをスキルとプラグインに移行する

> マニフェスト方式の Lagune プロジェクトを、セキュリティ原則、成果物、追跡、独自の専門知識を保ったまま、スキル方式の Lagune に移行します。

正規 URL: https://lagune.ai/ja-JP/docs/commands/migrate
言語: ja-JP
原文: 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. migrate による変更を単独でコミットし、移行をレビューしやすい 1 つの変更にまとめます。
3. [インストールページ](https://lagune.ai/ja-JP/docs) の手順に従って、使っているエージェント向けにコマンドをインストールします。
4. プロジェクトにすでに detect、plan、harden のいずれかの成果物がある場合は、それらの成果物と独自の専門知識に残っている古い参照を照合して更新するよう、[`/lagune-repair`](https://lagune.ai/ja-JP/docs/commands/repair) に依頼します：

   ```prompt
   /lagune-repair `.lagune/memory/` 配下の成果物（`detect.md`、`plan.md`、`harden.md`）に記載されている適用済みの専門知識（旧称 sub-skills）を、新しいカタログに載っている名前と照合して更新してください。また、`.lagune/catalog/` にある自分の専門知識が `.lagune/hooks/` の古いフックを呼び出している箇所を、すべて `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/ja-JP/docs) すると、新しいコマンド（`/lagune-detect` など）が入る |
| `.gitignore` 内の **Lagune** ブロック                                | 削除（ほかに何も書かれていなければ、ファイルごと削除）                                         |
| `.lagune/proofs/`（そのブロックで除外されていたもの）                | 専用の `.gitignore` でコミットの対象外になる                                                   |
| `.lagune/manifest.json`                                              | 最後に削除                                                                                     |

セキュリティの作業（セキュリティ原則、各フェーズが生成した成果物、各検出事項が指すパスを保持する追跡マップ）は、そのまま残ります。

## よくある質問

### 移行は必須ですか？

はい。マニフェスト方式のプロジェクトは非推奨で、v1.x までしか動作しないため、npx lagune migrate を実行して移行してください。

### migrate では何が保持されますか？

セキュリティ原則、各フェーズの成果物、追跡マップ、カテゴリ、独自の専門知識です。専門知識は .lagune/catalog/ に移動し、そのインデックスはカテゴリとともに .lagune/configs.json にまとめられます。

### 新しいコマンドはいつインストールすればよいですか？

migrate を実行したあと、インストールページで使っているエージェント向けに示されている手順に従ってインストールします。migrate は新しい /lagune を残すため、先にインストールしても問題ありません。

### チームメイトがすでに移行しました。何を実行すればよいですか？

移行の変更をプルしてから、npx lagune migrate を一度実行します。マニフェスト方式の Lagune がローカルのクローンに残したもの（バージョン管理には一度も含まれていなかったもの）を削除し、証明ファイルをコミットの対象外にします。