📦
【共通】マイグレーション（既存スキルDBへの利用ログ導入）
🎯 目的
既にスキルDB（スキルページを溜めているデータベース）を運用しているユーザーが、スキル利用ログの計測の仕組み を自分のスキルDBに移行（導入）するためのマイグレーションスキルです。
前提条件
- 記録先のスキル利用ログDBは スキル利用ログ に固定（明示指定済みのためヒアリング不要）
- 移行先のスキルDBが 同じワークスペース内 にあること
- 移行元の 【共通】スキル開始時処理（利用ログ作成） / 【共通】スキル完了時処理（利用ログ更新） の2ページ（複製されたもの）が存在すること
このスキルのキモは「プロパティコメントℹ」です。
NotionAIはスキル発動時に、スキルページのプロパティに対しても考えるし、プロパティコメント（プロパティの説明文）も読みます。そのため、コメントを正しく設定することで意図した動作をさせることが出来ます。本スキル内で指定しているプロパティコメントは、一字一句変えずにそのまま設定すること。
📥 手順0：インプットのヒアリング（必須・停止ポイント）
移行作業を始める前に、インタビュー（選択式の質問）ツール で以下を必ずユーザーに入力してもらいます。
- 移行先のスキルDB：「移行先のスキルDBのURL（またはDB名）を教えてください」― 自由入力で受け付ける
回答をもらうまで、移行作業を一切開始しないこと。 URLではなくDB名で回答された場合は検索して特定し、複数候補がある場合はどれかをユーザーに確認する。
✍️ 手順
1. 🔍 移行先DBの確認
- 移行先スキルDBと スキル利用ログ の両方を読み込み、スキーマを確認する
- 移行先に既に「スキル開始時処理」「スキル完了時処理」等の同名プロパティがある場合は、上書きせず ユーザーに扱いを確認 する
2. 🏷️ プロパティの作成（プロパティコメント必須）
移行先スキルDBに、以下の2つのテキストプロパティを プロパティコメント（説明文）付き で作成する。
| プロパティ名 | 種類 | プロパティコメント（一字一句そのまま） |
|---|---|---|
| 🛑 AIスキル開始時処理 | テキスト | 【必ず実行】NotionAIは呼び出されたスキル開始前にこのプロパティに記載されている内容を一番最初に処理すること |
| 🛑 AIスキル完了時処理 | テキスト | 【必ず実行】NotionAIはスキル完了時にこのプロパティに記載されている内容を一番最後に必ず処理すること |
3. ✂️ 旧リレーション（スキル一覧）の解除
必ず手順4のリレーション作成より先に実行すること。 新しく作るリレーションも「利用スキル」という名前のため、旧リレーションが残ったままだとプロパティ名が衝突する。
- スキル利用ログDB側に残っている、複製元の「スキル一覧」DBに向いた旧「利用スキル」リレーションプロパティ を削除する
- 削除前に、旧リレーションに値が入っている行が無いか確認し、ある場合はユーザーに削除してよいか確認する
4. 🔗 スキル利用ログDBへのリレーション作成
- 移行先スキルDBと スキル利用ログ の間に 双方向リレーション を新規作成する（手順3の旧リレーション解除が完了していることを先に確認する）
| 側 | プロパティ名 | プロパティコメント（一字一句そのまま） |
|---|---|---|
| 移行先スキルDB側 | スキル利用ログ | NotionAIスキル実行時に必要のない限りこのログは読み込まない事 |
| スキル利用ログDB側 | 利用スキル | （コメント不要。リレーション上限は1件に設定） |
5. 📄 共通処理ページ2件の移動
- 複製された「【共通】スキル開始時処理（利用ログ作成）」「【共通】スキル完了時処理（利用ログ更新）」の2ページを、移行先スキルDBへ移動 する（本文は変更しない）
- 移動後、両ページのプロパティを設定し直す：
- 「スキル開始時処理」← 【共通】スキル開始時処理ページのメンション
- 「スキル完了時処理」← 【共通】スキル完了時処理ページのメンション
- ユーザーが「移動ではなく複製したい」と希望した場合は、同内容の新規ページ作成で対応する
6. ✅ 動作確認
- 移行先スキルDBの既存スキルページ1件に、開始・完了処理のメンションを試しに設定する
- 「開始処理 → 本体スキル → 完了処理」の流れでログが1行作成・更新されることをユーザーと一緒に確認する
🤖 移行完了後：オートメーション設定の案内（必須）
NotionAIはデータベースのオートメーションを設定できません。 移行作業が完了したら、必ず以下の手順をユーザーに案内すること（スキル一覧DBのオートメーションが参考になります）。
- 移行先スキルDBを開き、右上の ⚡（稲妻アイコン）→ 新規オートメーション を選択
- トリガー：「ページが追加されたとき」
- アクション：「プロパティを編集」 で以下を設定
- 「スキル開始時処理」に @【共通】スキル開始時処理（利用ログ作成） をメンション
- 「スキル完了時処理」に @【共通】スキル完了時処理（利用ログ更新） をメンション
- 保存して有効化
これにより、新規スキルが追加されるたびに開始・完了処理のメンションが自動で付与されます。