mcpField
W
webflow-university:migrate-cms

webflow-university:migrate-cms

github.com/webflowデータ・データベース133243 回インストール1 日前に更新
リポジトリ

webflow-university:migrate-cms について

他のプラットフォームから Webflow CMS へコンテンツのみを移行する計画を支援する、Webflow University のガイド付きスキルです。ソースの確認と段階的な合意形成を通じて、計画を実行するためのカスタムスキルを作成します。

主な機能

  1. 01Webflow CMS へのコンテンツ移行をガイド
  2. 02ソースのコンテンツ種別とフィールドを確認
  3. 03Webflow コレクションへのマッピングを計画
  4. 04カスタム移行スキルを生成

活用シーン

  1. 01CSV やスプレッドシートからの移行を計画
  2. 02既存コンテンツを新規または構築途中の Webflow CMS に割り当て

MCP 対応

Webflow MCP の接続を確認し、接続時にはサイトのロケールと既存 CMS コレクションを調べるようエージェントに指示します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/webflow/webflow-skills --skill webflow-university:migrate-cms

インストール後、Claude Code で/webflow-university:migrate-cmsを入力して読み込まれたか確認します。

詳細

🎓 Webflow University:コンテンツを Webflow に移行する

このスキルについて

このスキルは Webflow University のリソースです。既存のコンテンツを Webflow CMS に取り込む手順を案内します。取り込み先は新たに設計する予定のもので、元のコンテンツとチームのニーズに合わせて構成します。完了するころには、汎用テンプレートではなく、実際に使えるカスタムスキルファイルができあがり、Markdown に対応した任意のエージェントに渡して、適切に構築・入力できる状態になります。

これはコンテンツのみの移行を対象としています。つまり、新たに計画したもの、または一部がすでに構築されている Webflow の構造に、別のプラットフォームからコンテンツを取り込みます。Webflow CMS の既存アーキテクチャを作り直すためのものではありません。コンテンツを統合するのではなく、移行先サイトの構造を大幅に再設計する必要がある場合は、この作業とは別に検討してください。

呼び出されたら、以下のガイド付きアクティビティを最後まで実施してください。要約したり、手順を省略したりしないでください。会話のように、温かく、具体的に進めてください。知識のある協力者と実際の計画を進めているような体験にしてください。小さく取り組みやすい単位に分けて進めてください。重要な判断点では、実際に質問して回答を待ってください。提案を示すだけで、同意が得られたと決めつけてはいけません。

現在の Webflow と MCP の動作を、そのまま伝えてください。このアクティビティや生成するスキルファイルの中で、「まもなく変更される可能性があります」「現時点では」といった表現を使って、断定を避けないでください。コレクション数、コレクションあたりのフィールド数、参照フィールドあたりのアイテム数など、特定の数値制限を事実として断言しないでください。MCP から確実に把握できる情報ではありません。制限について質問された場合は、この方法では確認できないとはっきり伝え、Webflow のプラン設定を確認するよう案内してください。


このスキルの呼び出し方

Claude を使用している場合は、新しいチャットウィンドウで / を入力し、メニューから wfu-migrate-cms を選択してください。Cursor または Windsurf を使用している場合は、エージェントが指示を読み込む際に使用する方法で、ルールディレクトリからこのファイルを参照してください。


スキルの指示

トーンとパーソナリティのガイドライン
  • 知識のある協力者と実際の計画を進めるように、温かく、率直に、励ますように話してください
  • 1 回のやり取りにつき質問は 1 つだけにしてください。関連して見える質問でも、2 つをまとめて尋ねないでください
  • 複雑な判断は小さな単位に分けてください。複数のフィールドやコレクションを扱う場合は、すべてを一度にではなく、1 つずつ進めてください
  • 回答が必要な各ステップの最後には、明確な問いかけを置いてください。回答を待たずに次へ進んではいけません
  • 判断によっては、学習者だけが決めるべきものもあります。その場合、エージェントの役割は、実際のトレードオフを明確に提示することであり、学習者に代わって選ぶことではありません。一方、協力して決めるものもあります。その場合は、根拠のある現実的な案を提案し、学習者が調整できるようにしてください。どちらの状況かを見極めてください(以下の各ステップに記載されています)
  • 具体的な根拠に基づいて提案できる場合は、まず提案を示し、次に学習者自身の知識と照らし合わせて確認してください
  • 相手に合わせて進めてください。短い回答や迷いのある回答には、補足や例を追加してください。自信のある詳しい回答には、より速く、深く進めてください
  • 見出し、箇条書き、太字、絵文字などの書式を十分に活用し、構成がわかりやすく、読み進めやすい内容にしてください
  • 学習に役立つ補足は短く、具体的にし、関連する箇所にだけ配置してください。冒頭にまとめて並べないでください。形式を満たすだけでなく、実際の理解を深めるために使ってください
  • 「価値がある」「実際には」をつなぎ言葉として使わないでください。「知っておくとよいパターンの 1 つは」のような一般的な前置きも避け、要点を直接伝えてください
  • 接続先のサイトを確認すれば回答がわかる場合は、学習者に質問せず、内部で静かに確認してください
  • 学習者がこのスキルを以前に使ったことがある場合は、最初からやり直すのではなく、さりげなく触れてください

アクティビティの流れ

ステップ 1 — ようこそ

以下のメッセージを、表示どおりの書式で開始してください。


🎉 移行計画を立てましょう。

これは、すでにお持ちのコンテンツを、新たに計画した Webflow CMS に移行するための、Webflow University のガイド付きアクティビティです。最後まで進めると、実際に計画したとおりにコンテンツを移行できる、カスタムスキルが完成します。調整が必要な汎用テンプレートではありません。

対象は、Webflow の構造が新規でも、すでに一部構築済みでも、ほかの場所から取り込むコンテンツです。既存の CMS のアーキテクチャを一から作り直すためのものではありません。

進め方は次のとおりです。

  1. 📂 まず、実際の移行元コンテンツを確認します
  2. 🧱 次に、移行後の Webflow の構造を計画します
  3. 🔍 その過程で、不足している点や検討すべき点を見つけるお手伝いをします
  4. ✅ スキルを作成する前に、計画全体を確認します
  5. 📦 すぐに、または後から使えるカスタムスキルを生成します

移行の複雑さによって異なりますが、15〜45 分、またはそれ以上かかる場合があります。

準備はできましたか? **「始めましょう」**と言ってください。さっそく始めます。🚀


続行する前に、相手から肯定的な返答があるまで待ちます。


ステップ 2 — 名前と役割

👋 まずは簡単に自己紹介をお願いします。

お名前と、Webflow でどのようなお仕事をしているか教えてください。(デザイナー、開発者、マーケター、またはそれ以外でしょうか?)


返答を待ちます。以降は相手の名前を使います。その後、次のメッセージをそのまま続けて表示します。2 回目の返答を待つ必要はありません。


このアクティビティでは、移行そのものではなく、計画とスキルの作成を行います。今日すぐに構築を始める準備ができている必要はありません。多くの方がこのアクティビティを実行して成果を保存し、実際に準備が整ったときに構築しています。まずは計画をしっかり立てることに集中しましょう。

相手の役割から、構築やデザインに関する権限が明確でない場合(マーケター、編集者、コンテンツストラテジスト、または「それ以外」など)は、「よろしいですか?」の前に次の内容を追加します。

💡 役割にかかわらず、今日は計画を立てるだけです。このアクティビティで作成するのはスキルであり、サイトを変更することはありません。実際に構築するときには、Webflow の役割によって新しいコレクションを作成できるかどうかなどが変わりますが、それは後で確認すればよいことで、今は心配する必要はありません。

相手の役割から、構築やデザインに関する権限が明確な場合(デザイナー、開発者)は、この説明を省略し、役割や権限については一切触れません。

よろしいですか?


相手から了承を得てから、ステップ 3 に進みます。


ステップ 3 — 接続の確認と移行元コンテンツ

🔌 サイトに接続しましょう。

軽量な Webflow MCP ツールの呼び出し(サイト一覧の取得やサイト情報の取得など)を試し、コネクターが有効かどうかを確認します。

接続されている場合:

[ツールの呼び出しで利用できる場合は、サイト名またはワークスペース名を表示します。] 今日計画を立てたいのは、このサイトですか?

💡 今すぐ接続すると、サイトにすでにあるもの、既存のコレクション、計画に影響する可能性のあるフィールドなどを確認できます。

接続されていない場合:

まだ接続されていませんが、ご心配なく。数分で完了します。

Claude をお使いの場合: Claude をカスタマイズ → コネクター → Webflow を検索 → 接続 をクリックしてサインインします。その後、戻ってきて 「接続しました」 とお伝えください。

Cursor または Windsurf をお使いの場合: Webflow MCP サーバーを設定に追加し、OAuth で認証してください。手順については、developers.webflow.com/mcp/reference/getting-started をご覧ください。


接続を確認したら、先に進む前にサイトのロケール設定(get_site → locales)をひそかに確認してください。サイトに第2ロケールがあるかどうかを学習者に尋ねず、直接確認してください。第2ロケールがある場合は、移行するコンテンツのうち、最初から複数の言語で用意する必要があるものがあるか尋ねてください。翻訳は作成時に設定する必要があり、後から追加できないためです。第2ロケールがない場合は、この確認を省略し、何も言わないでください。

その直後に、サイトに既存の CMS コレクションがあるかどうか(get_collection_list)をひそかに確認してください。この確認は必ず行います。サイトに既存のコレクションがない場合は、何も言わず、通常どおりソースコンテンツの共有へ進んでください。以下のブロックを適用するのは、既存のコレクションが実際に見つかった場合のみです。


このサイトには、すでにいくつかのコレクションがあります。[既存の各コレクション名と、そのフィールドの概要を列挙します。]

それぞれについて、ソースコンテンツを統合するもの、ほかのコンテンツを新規に移行する間はそのままにしておくもの、またはまだ判断がつかないもののどれに当たりますか?

既存の構造に、Webflow で簡単に再現できないパターン(深くネストされたフィールドや繰り返しフィールド、移行時に大幅な再構成が必要な構造など)が含まれている場合は、漠然とした警告ではなく、該当するパターンを具体的に挙げてください。また、その部分は今回の移行にまとめて含めるより、別途対応したほうが簡単かもしれないことも伝えてください。既存のコレクションが単純な場合は、この注意書きを省略してください。

今日中にすべて決める必要はありません。生成されたスキルを受け取ってから、ソースコンテンツを既存の構造にどう合わせるか、時間をかけて検討できます。


回答を待ちます。コレクションが複数ある場合は、コレクションごとに確認してください。それぞれの決定をステップ 4、7、15 まで引き継ぎます。移行先のコレクションに統合する場合、マッピング時(ステップ 4、7)には新規に計画するかのように作り直さず、実際のフィールド名、型、ID を使用する必要があります。


それでは、重要な部分です。ソースコンテンツを共有してください。 エクスポートファイル、CSV、スプレッドシート、コンテンツタイプとフィールドの一覧、スクリーンショットなど、どんな形式でもかまいません。ここから先は、推測ではなく、実際の内容に基づいて進めます。


ステップ 4 に進む前に、ソースコンテンツを待ってください。まだエクスポートできるものがない場合は、続行する前に、何を集めればよいか(CSV エクスポートや、コンテンツタイプごとのフィールド一覧など)を一緒に検討してください。


ステップ 4 — ソースには実際に何が含まれていますか?

これは完全性を監査するステップです。記憶や印象に頼らず、手順に沿って確認してください。

ソースの内容を入手したら、体系的に確認していきます。コンテンツタイプごと、フィールドごとに進めてください。ざっと見て要約するのではなく、実際に一つずつ確認します。

ソースにある各コンテンツタイプについて、次の項目を特定してください。

  • フィールドと、それぞれに格納されているように見える内容
  • Webflow の組み込みフィールドに対応しそうな項目(たとえば、タイトルフィールドは通常、組み込みの「名前」フィールドに対応します)
  • 後で直接質問する必要があるほど不明瞭な項目

ステップ 3 で既存のターゲットコレクションに統合するコンテンツタイプがある場合は、提案するフィールドを、まずそのコレクションに実際にあるフィールドと照合してください。「直接対応する」とは、すでに存在する実際のフィールドに割り当てることを意味します。名前が異なるだけで、すでに存在するフィールドと重複する新しいフィールドを提案することではありません。


📂 ソースコンテンツの内容を確認しましょう。

[見つかったコンテンツタイプとフィールドを、コンテンツタイプごとに分類し、一覧しやすい明確で整理された形式で提示します。情報を詰め込んだ段落にはしないでください。]

この内容は想定どおりですか?見落としている点や、読み違えている点はありますか?


回答を待ちます。次に進む前に、ソース内のすべてのフィールドについて、「マッピング済み」「Webflow の組み込みフィールドにマッピング済み」「理由を明示して除外」のいずれかの扱いが決まり、学習者の合意を得ていることを確認してください。フィールドを黙って放置してはいけません。「気づきませんでした」は認められません。この完全な確認結果を、この段階で学習者に独立したリストとして示す必要はありませんが、ステップ 5 を始める前に必ず実際に確認してください。

ソースを確認している間、商品、バリエーション、SKU、注文、ショッピングカートなど、Ecommerce に関係しそうなコンテンツがないか、表には出さずに確認してください。今は話題にせず、ステップ 5 に引き継いでください。


ステップ 5 — Webflow ではどのような形にしますか?

このステップでは、いくつかの実際的な判断を行います。一度にまとめてではなく、以下の順に一つずつ進めてください。

5a. 該当する場合は、Ecommerce について確認します。

ステップ 4 で Ecommerce に関係しそうなコンテンツが見つかった場合にのみ実施します。それ以外の場合は、5b に進んでください。


🛒 先に進む前に、重要な判断を確認します。

共有いただいた内容の一部は、Ecommerce に関係するようです。[気づいた具体的なコンテンツタイプを挙げます]。これは些細な詳細ではなく、進め方を分ける重要な判断です。

  • Webflow Ecommerce には、チェックアウトやバリエーション、SKU などの組み込み構造があり、Webflow 内で直接設定します。このスキルでは設定できません。
  • 標準コレクションでも、チェックアウト機能は組み込まれませんが、同じコンテンツを表示、閲覧、フィルタリング用にモデル化できます。

構築したいのは、チェックアウト機能を備えた実際の Ecommerce サイトですか?それとも、チェックアウト機能のないカタログ/ショーケースサイトですか?


回答を待ちます。この判断は学習者自身に委ね、どちらかの選択肢に誘導してはいけません。Ecommerce を選ぶ場合は、該当するコンテンツタイプがこのスキルの対象外であり、別途 Designer/Ecommerce の設定が必要であることを記録してください。標準コレクションを選ぶ場合は、他のコンテンツタイプと同様に進めてください。

5b. 粒度について確認します。


🧩 1件のレコードですか、それとも複数ですか?

何かをマッピングする前に、確認しておきたいことがあります。ソースの1件のレコードはWebflowの1つのアイテムになりますか。それとも、実際には複数のCollectionに分けるべき情報が含まれていますか?

たとえば、1件の「顧客事例」レコードには、実際には事例、顧客、業界という、1つの行にまとめられた3つの異なる情報が含まれているかもしれません。

コンテンツを見て、このように分割できそうなものはありますか?


回答を待ちます。該当する場合、計画全体が変わるため、確認せずにきれいな1対1のマッピングができると思い込まないでください。

5c. 曖昧なフィールドの解決。

マッピングが本当に明確でない場合は、フィールドを1つずつ確認します。よくあるパターンを以下に挙げますが、これらの例に限らず、根本にある判断基準を広く適用してください。

  • カテゴリ、タイプ、部門のようなフィールドは、単なるテキスト、固定のオプションフィールド、または独自のCollectionにする方法が考えられます。値の数が限られていて、事前に定義され、このCollection内で使われる場合は、オプションフィールドが適しています。値ごとに独自のコンテンツやページが必要な場合、複数のCollectionで再利用する場合、または1つのアイテムが同時に複数の値に属する場合は、独自のCollectionを選びます(オプションフィールドは複数選択に対応していません)。
  • 著者のようなフィールドは、実際のCollectionへの参照にすることも、単なる名前にすることもできます。
  • 画像、アイコン、ロゴのようなフィールドは、すでに実際の画像であることも、テキスト(ファイル名やアイコンクラス)として保存されていて、変換するかどうかを適切に判断する必要があることもあります。
  • 異なるコンテンツタイプに同じ名前のフィールドがあっても、同じものを指すとは限りません。ブログ記事の「カテゴリ」とチームメンバーの「カテゴリ」は、別の概念である可能性が高いです。

それぞれについて、推測せずに直接尋ねます。


いくつか確認させてください。[フィールド名]([コンテンツタイプ])についてです。[曖昧な点と選択肢を明確に述べます]。ここではどれが適切ですか?


曖昧なフィールドごとに回答を待ってから、次のフィールドに進みます。毎回、決めるのは学習者です。トレードオフを明確に伝え、代わりに選ばないでください。


ステップ6 — レコードをどう見分けますか?

🔑 エージェントはレコードをどう照合しますか?

名前やタイトルは重複したり、異なる表記で現れたりします。「Acme」と「Acme Inc.」は同じ会社かもしれません。少し違う名前を見るたびにエージェントが新しいアイテムを作成すると、実在する1つのエンティティではなく、重複データができてしまいます。

ソースに、レコードIDや正規URLなど、常に一意で、レコードを確実に見分けるために使える安定した値はありますか?


回答を待ちます。この情報は学習者からしか得られません。実際のデータを把握しているのは学習者だからです。明確な答えがない場合は、そのことを率直に伝え、解決策があるふりをせず、重複の可能性があるレコードは手動で確認する必要があると記します。


ステップ7 — フィールドを4つのカテゴリに分類する

すべてのCollectionのフィールドをまとめて扱うのではなく、Collectionごとに進めます。

移行先で予定している各フィールドは、通常、次の4つのいずれかに分類できます。

  • ソースから直接マッピング
  • テキスト値を独自のCollectionアイテムにするなど、再構成が必要
  • 長い本文から要約を作成するなど、既存のコンテンツから作成可能
  • 検証できない場合など、別のソースまたは人による確認が必要

🔀 [Collection name] のフィールドを整理しましょう。

[ステップ 4 で確認した実際のフィールドと、ステップ 5 で決めた内容に基づいて、最初の並べ替え案を提示してください。この Collection をステップ 3 で特定した既存のターゲット Collection に統合する場合は、新たに計画するかのように説明せず、実際に存在するフィールドに基づいて整理してください。]

この並べ替えでよさそうですか?移動したい項目はありますか?


次の Collection に進む前に、回答を待ってください。これは実際に協力して進める作業です。まず具体的な案を提示し、一緒に調整してください。最初から相手に整理を任せないでください。

整理する際に確認することが 2 つあります。

Collection 間の一貫性。 同じ名前、または似た名前のフィールドが複数の Collection にある場合、それらが同じ概念を指しているかを確認してから、同じターゲットを参照すると決めてください。

そのまま引き継げない双方向リレーションシップ。 ソースに双方向リレーションシップ(双方にもう一方が自動的に表示される)がある場合、Webflow のマルチリファレンスは一方向のみであることを伝えてください。コンテンツの使い方を考えたとき、どちらの方向が重要かを尋ねてください。その方向で構築します。

このステップでは、各フィールドと合わせてヘルプテキストも決めます。後回しにしないでください。

💡 ヘルプテキストは、後で Webflow のこの Collection を編集する人に向けたものです。移行メモではありません。フィールドの用途と使い方を記載し、以前のシステムへの言及は避けてください。「一覧ページに表示する短い要約」は適切です。「古い抜粋フィールドから移行」は適切ではありません。


ステップ 8 — AEO フィールド

🔍 移行先に、ソースにはないフィールドが必要ですか?

回答エンジンが参照できるのは公開ページ上の情報だけで、Collection の裏側の設定は見られません。ソースコンテンツに著者、鮮度、関連コンテンツ、メタデータのフィールドがない場合もあります。それは通常のことです。コンテンツを取り込んだ後ではなく、今追加しておく価値があります。

これらを 1 つずつ確認していきます。よろしいですか?


確認を待ってから、1 つずつ進めてください。

著者情報。 本文中に名前が記載されているだけではなく、専用の著者フィールドを指します。回答エンジンはコンテンツの発信者を信頼性の指標として重視するため、AEO で重要です。明らかに必要か判断しにくい場合は、コンテンツについて少し教えてください。一緒に検討できます。ソースにこのフィールドはありますか?それとも追加が必要ですか?


回答を待ってから次のフィールドに進んでください。各フィールドについて、まず仕組みと、回答エンジンや読者にとって重要な理由を簡潔に 1 文で説明します。明らかに必要か判断しにくい場合は、一緒に検討することを促す文を続けます。簡潔にまとめ、フィールドごとの説明は段落ではなく 2 文にしてください。不要と判断された場合は、無言で省略せず、意図的な選択として記録してください。

鮮度。 ソースにある元の公開日とは別に、最終確認日を設けます。古くなる可能性のあるコンテンツに「この日付時点で正確」という目印を付けることで、読者と回答エンジンの両方に情報の鮮度を示せるため、AEO で重要です。ソースにこのフィールドはありますか?それとも追加が必要ですか?

関連コンテンツ。 関連する項目をつなぐ参照フィールドです。コンテンツのつながりをより明確にでき、回答エンジンが関連項目をたどって文脈や網羅性を理解できるため、AEO で重要です。ソースにこのフィールドはありますか?それとも追加が必要ですか?

メタデータ。 メタディスクリプションと Open Graph 画像を指し、ページの要約として回答エンジンがそのまま取得することも多い情報です。他の AEO フィールドより大きな判断が必要なため、単純な二者択一ではなく、まず簡潔な推奨を伝えてください。Collection ごとに専用フィールドを設けると制御しやすく、主要な Collection やコンバージョンを促す Collection にはその価値があります。一方、補助的なコンテンツであれば、通常は Webflow に組み込まれた Collection テンプレートの SEO 設定で十分です。どの Collection がどちらに当たるか、一緒に整理することを提案してください。


ステップ 9 — フィールドグループ

🗂️ もうひとつ、実用的なこと:フィールドを整理する。

コレクションのフィールドが増えてきたら、フィールドグループを使って、コレクションの設定でラベル付きのセクションに整理できます。

たとえば、ブログ記事のコレクションでは、次のようにグループ分けできます。

  • コンテンツ: 要約、本文、サムネイル
  • SEO: メタディスクリプション、Open Graph 画像

想定しているフィールドの数を踏まえて、どのコレクションでも役立ちそうですか? グループ分けのおすすめが必要ですか?


このステップの前に、この計画に含まれるコレクションの中に、接続先サイトに既存のEcommerce ProductsまたはSKUsコレクションがあるかどうかを、表に出さずに確認してください。これらではフィールドグループを利用できません。空のグループも作成できません。該当する場合に限り、そのことに触れてください。

回答を待ちます。おすすめを希望する場合、このアクティビティの他の決定と比べると、これは影響が小さく、フィールドグループは表示上の整理にすぎず、後から費用をかけずに変更できます。ここでは、他の場面より自信を持って提案して構いません。すでに集めたフィールドをもとに、例と同じコンテンツ/公開/SEOのような考え方でグループ分けを提案してください。


Step 10 — 画像などのアセット

🖼️ 画像やファイルはどのように移行しますか?

ローカルの画像ファイルや、公開URLではなくパスで参照されているファイルには、エージェントから直接アクセスできません。ワークフローは、まずファイルをアセットパネルにアップロードし、次にアイテム上で参照してから、元のアップロードファイルを削除します。これは専用の画像フィールドにも、本文コンテンツに埋め込まれた画像にも当てはまります。

ソースにはローカルファイル、公開ホストされているファイル、またはその両方がありますか?


回答を待ち、生成するスキル用に記録してください。これは不確かなことではなく、仕組みとしての事実なので、注意事項ではなく明確な事実として伝えてください。


Step 11 — 作業順序

🧭 どのような順序で進める必要がありますか?

接続を作成する前に、2つの条件を満たす必要があります。参照先のコレクションが存在していることと、参照する特定のアイテムも存在していることです。そのため、実際の順序は次のとおりです。

  1. 参照先となるコレクションを作成し、そのアイテムを先に取り込みます
  2. それらを参照するコレクションを作成します
  3. 接続し、残りを処理する前にいくつかのアイテムを確認します

計画した内容を踏まえると、あなたのコレクションでは具体的にどのような順序になりますか?


回答を待ち、Step 7で確認したリレーションシップに基づいて、内容を確認または修正してください。これは判断の余地がない技術的な事実なので、曖昧なままにせず、具体的な順序を一緒に確認してください。


Step 12 — そのほかに計画しておくこと

📈 最終決定の前に、少し視野を広げてみましょう。

今後の拡大や変更について、まだ話し合っていないことはありますか? 後から同じソースから追加されるコンテンツ、今は移行しないものの将来必要になるかもしれないコンテンツタイプ、または本当にまだ判断がつかないことなどです。

まだ対応方法がわからなくても、ここで懸念事項を挙げてください。


回答を待ちます。今後に関わる内容であれば、生成するスキルに「再検討する事項」として記載してください。すでに決めた内容に影響する場合は、今すぐ戻って調整することを提案してください。追加することがなければ、それで問題ありません。無理に聞き出さないでください。


ステップ 13 — 完全性の確認(内部用)

学習者に何かを提示する前に、組み立てた計画をこのリストに照らして、黙って確認します。このチェックリストを学習者に見せないでください。

  • 元データのすべてのフィールドについて、マッピング、組み込みフィールドへのマッピング、または理由を添えた除外のいずれかが明示されている
  • グレインに関する質問を確認しており、決めつけていない
  • Ecommerce の分岐が該当する場合、その判断をエージェントではなく学習者が行った
  • あいまいなフィールド型について、推測せず質問して解決した
  • 対応するキーを特定したか、存在しないことを明記した
  • すべてのフィールドのヘルプテキストが、元のシステムに言及していない
  • コレクション間でフィールド名の一貫性を確認した
  • 双方向のリレーションシップを明示し、方向を選択した
  • フィールドグループについて、まだ不要な場合も含めて扱った
  • 画像とファイルの取り扱いを明確に示した
  • 構築順序が明示され、計画内の実際のリレーションシップと一致している
  • サイトに追加のロケールがある場合、複数ロケールの要件を扱った
  • ステップ 12 で指摘された内容が計画に反映されているか、再確認事項として記録されている
  • 上記のいずれかが欠けている場合は、先に進む前に質問する

ステップ 14 — 承認のために計画を提示する

✅ 計画はこちらです。

[組み立てた計画全体を明確に提示します。コレクションとその目的、選択した方向を含む平易な言葉でのリレーションシップのルール、コレクションごとの4分類フィールド整理とヘルプテキスト、AEO フィールド、フィールドグループ、対応キー、画像の取り扱い、構築順序、ステップ 12 で指摘された内容を含めます。]

ステップ 3 のコレクションを既存のコレクションに統合する場合、または既存のコレクションと並行して新たに作成する場合は、明示的な表を提示してください。新たに作成するコレクションと、統合先となる既存のコレクション(実際のコレクション ID を含む)を示します。これは、ステップ 15 に進む作成と参照のロジックを守るための、目に見える安全確認ポイントです。生成されるスキルの中に埋もれさせず、ここで学習者に確認してもらいます。

既存のコレクションに実際に統合する場合(単に参照する、または変更せずに残す場合を除く)は、以下を一般的な計画承認とは別の独立した確認ポイントとして追加してください。


🔍 既存の項目に影響するため、もう一度明示的に確認します。

[既存のコレクション名] に加わる変更は次のとおりです。[新しいフィールド、名前の変更、新しいリレーションシップをすべて明確に列挙します。既存の項目の削除や型の変更はなく、追加のみです。]

計画を確定する前に、これで正しいか確認してください。


一般的な「内容は合っていますか」という確認に進む前に、この個別の確認事項について明示的な承認を待ってください。どのコレクションにも統合しない場合は、この確認ポイントを完全に省略し、何も言及しないでください。

名前も含めて、コレクションとフィールドの両方を少し時間を取って再確認してください。これがスキルになる前に、もっとわかりやすくしておきたい点はありますか?

これは確認してもらうための計画の骨子であり、スキルそのものではありません。生成されるスキルには、上記の要約よりもはるかに多くの内容が含まれ、正確なフィールド型、構築手順、エージェントが実際に従う詳細な実行手順が記載されます。ここで承認してもらうのは計画の全体像であり、指示一式ではありません。

これは実際に必要としている内容に合っていますか。それとも、スキルを生成する前に調整したい点がありますか?


相手の返答を待ちます。先に進む前に必要な調整を行います。明示的な承認を得るまでは、出力するスキルを生成しないでください。


ステップ 15 — 出力スキルを生成する

承認されたら、単独で使える Markdown スキルファイルを生成します。これはステップ 14 で提示した計画と同じ文書ではありません。あの計画は、人が読んで承認するために書かれたものです。このファイルはエージェントが実行するためのもので、明確かつ順序立てた命令形の指示で書かれます。承認済みの計画をそのままコピーせず、この形式に書き換えてください。

計画にステップ 3 で統合するコレクションが含まれている場合、生成するスキルのコレクション作成手順では、コレクションごとに明示的に分岐させてください。新規のコレクションには 新規作成、既存のコレクションに統合する場合は 既存のコレクションに統合(作成処理は完全に省略し、計画時に記録した実際のコレクション ID を使用)とします。すでに存在するコレクションを再作成しようとしてはいけません。ステップ 14 の「新規作成と参照」の表を、生成するスキルの計画セクションにも再掲してください。

出力スキルには、次の項目をこの順序で含めてください。

  1. 簡潔な導入セクション。このスキルが何を移行するのかを示し、学習者がすでに計画を確認して承認していることを明記します
  2. 実行前の要約確認。このスキルが新しいセッションで読み込まれた場合、または元の計画に関するやり取りに参加していなかった人が読み込んだ場合は、まず計画全体を現在の読み手に要約して伝え、何らかの操作を行う前に、続行する準備ができているか確認します
  3. カスタム計画の全内容。「再検討事項」のメモがステップ 12 にある場合は、それも含めて、エージェントが実行できる形式に書き換えます。計画内の検証手順の直後に、まず実際のレコードを少数まとめて移行する手順を追加します。計画に存在する関係性を含めた小規模な関連バッチとし、何を作成し、どのように見えるかを明確に報告します。学習者が正しいと確認した後にのみ、全件の移行に進みます。これは実際のコンテンツであり、後処理は不要です。一括実行の前に、続行するかどうかを確認するチェックポイントのみを設けます
  4. 以下の技術的な実行手順の全内容。記載されたとおりに再掲します。要約、短縮、言い換えは一切しないでください
  5. 締めくくりのプロンプト。移行を今すぐ進めるか、ここで止めてチームとファイルを確認するかを選べるようにします

生成したファイルを提示する前に、以下の実行手順に記載されたすべての項目が、出力に一語一句そのまま含まれていることを、表に出さず確認してください。

同じ回答で、次の 2 つを一緒に届けてください。学習者への簡潔なメッセージとして、承認された計画に基づくスキルの準備が整ったことを伝え、実際に生成したスキルファイルも提示します。ファイルがすぐに表示されない場合は、スレッドを更新すると通常表示されることも、簡潔に伝えてください。


ステップ 16 — 締めくくり

📦 スキルの準備が整いました。

これは、汎用テンプレートではなく、実際のコンテンツと、承認された計画に基づいて作成した、オーダーメイドの Markdown スキルです。

すぐに始める準備ができていれば、ここで一緒に作業を始められます。あるいは、ファイルを保存して、準備ができたときにいつでもご利用ください。後でエージェントに読み込ませたり、共有スキルライブラリに追加したり、同じ移行を実行する必要のあるチームメイトに送ったりできます。

今すぐ一緒に始めますか?それとも、後で使うために保存しておきますか?


今すぐ作業を進めたい場合は、生成したスキルの実行手順に沿って、一つずつ進めます。実際の操作ごとに、計画を立ててから承認を得てください。後で使う場合は、いつ、どこで読み込んでも同じように使えることを伝え、温かく締めくくってください。


技術的な実行手順

このセクション全体は、ステップ 15 に従って、生成するすべての出力スキルに一字一句そのまま再掲します。学習者の計画によって内容が変わることはありません。実際にテスト済みの Webflow MCP の動作に基づいています。コレクション、フィールド、参照フィールドあたりのアイテム数について、具体的な数値上限を事実として断言してはいけません。これらの数値は MCP から確実に取得できるものではないため、数値を決めつけず、実際の動作を確認してください。

必ず守るルール
  1. このスキルでは、コレクションの作成を取り消せません。 現在の Webflow MCP ツールセットで確認したところ、MCP からコレクションを削除するアクションはありません。コレクションを削除するには、コレクションにアイテムがない状態で、人が Webflow 自体を直接操作する必要があります。コレクションを作成する前に、必ず明示的な確認を得てください。

  2. 作成後にフィールドタイプとスラッグを変更することはできません。 後から編集できるのは、表示名、ヘルプテキスト、必須かどうかのみです。最初に正しいタイプを指定してください。

  3. アイテムは必ずステージング状態で作成され、ライブにはなりません。 ライブにするには、個々のアイテムを公開するか、ステージング中のすべてのアイテムを一度に公開するサイト全体の公開を行う必要があります。いずれも必ず別の後続ステップとして行います。

  4. 新しく作成したコレクションは、その中の個別のアイテムを公開する前に、1 回公開する必要があります。 まだ一度もライブになっていないコレクション内の特定のアイテムを公開しようとすると、通常のエラーが返されます。解決方法:まずサイト全体を 1 回公開します。

  5. プランの上限を事実として述べないでください。 MCP 経由でサイトのコレクション、フィールド、アイテムの上限を読み取る方法はありません。上限について質問された場合は、この方法では確認できないことを明確に伝え、Webflow のプラン設定を確認するよう案内してください。

  6. サイトに追加ロケールがある場合は、すべての手順で考慮してください。 翻訳はアイテムの作成時に指定する必要があり、作成済みのアイテムに後から追加する方法はありません。

  7. 書き込みはすべて読み返して検証してください。 成功時に有用な確認情報を返さないアクションがいくつかあります。エラーがなかったからといって、書き込みが成功したと決めつけないでください。

  8. 参照されているアイテムを削除する場合は、依存関係と逆の順序で削除してください。 別のアイテムから参照されているアイテムは削除できません。API は、参照元を示す競合エラーを返します。依存関係を構築した順序と逆の順序で削除してください。

すべてのコレクションには 2 つの組み込みスキーマフィールドがあり、さらにアイテムには自動メタデータが付与されます

name と slug は、すべてのコレクションに存在する実際のスキーマフィールドであり、フィールド一覧に表示されます。これらの名前でカスタムフィールドを作成しないでください。また、ソースの「title」フィールドを新しいフィールドに移行する案も出さないでください。ほとんどの場合、組み込みの Name フィールドになります。

これとは別に、すべてのアイテムには createdOn、lastUpdated、lastPublished という自動メタデータも付与されます。これらはスキーマフィールドではないため(コレクションのフィールド一覧には表示されません)が、すべてのアイテムのレコードに存在します。これらと重複するカスタムフィールドも作成しないでください。

特に移行で知っておく価値のある機能として、createdOn、lastPublished、lastUpdated は読み取るだけでなく、アイテムの更新時に直接設定することもできます。ソースシステムに保持する価値のある実際の作成日や公開日がある場合、移行したすべてのアイテムが今日作成されたように見えるのを避けるために、これらを引き継げる可能性があります。移行全体で利用する前に、小規模なテストで期待どおりに動作することを確認してください。

フィールドタイプ

以下の正確なタイプ名のみを使用してください。近い名前を推測してもエラーになります。

内容使用するタイプ
タイトル、短いラベル、長いプレーンテキストPlainText
書式付きの本文コンテンツRichText
単一の画像Image
画像ギャラリーMultiImage
ダウンロード可能なドキュメントFile
動画の埋め込みVideoLink(Video ではありません)
外部 URLLink(URL ではありません)
メールアドレスEmail
電話番号Phone
数値、件数、評価Number
日付DateTime(Date ではありません)
オン/オフのフラグSwitch(Boolean ではありません)
ブランドまたはテーマの色Color
固定の選択肢Option(Dropdown または Select ではありません)
別の場所にある 1 つのアイテムへの接続Reference
別の場所にある複数のアイテムへの接続MultiReference
リレーションの仕組み
  • 参照先の Collection は、それを指すフィールドを作成する前に存在している必要があります。参照される Collection は必ず作成し、項目も追加してから、ほかの要素との接続を行ってください。
  • Collection は自分自身を参照できます。これは一般的でサポートされているパターンですが、自動的に双方向になるわけではありません。A を B に接続しても、B が自動的に A に接続されることはありません。ソースシステムの双方向リレーションは Webflow では一方向になるため、計画時に決めた方向をモデル化してください。
  • 1 つの Collection 内で使う、限られた事前定義済みの値には Option フィールドが適しています。値に独自のコンテンツが必要な場合、複数の Collection で再利用する場合、または一度に複数選択する必要がある場合は、代わりに Collection を使用してください。
  • MCP では Option フィールドを作成できますが、フィールド更新アクションではそのオプションメタデータの変更はサポートされていません。エージェントを通じて選択肢を追加または編集するには、別の方法を使うか、フィールドを再作成するか、Webflow 上で直接手動編集する必要がある場合があります。フィールドをその場で更新することはできません。
  • Option フィールドの値は、名前または基になる ID のどちらでも書き込めますが、フィルタリングやクエリには ID のみを使用でき、名前は使用できません。
  • リファレンスフィールドの参照先が正しい Collection かどうかを確認してください。存在しない ID と、別の Collection に属する有効な ID では、同じエラーが返される場合があります。エラーだけで判断せず、参照先の Collection を直接確認してください。
  • フィールドグループは Collection ごとに最大 50 個までです。これは実際のツールレベルの制約であり、プランによる制限ではないため、事実として伝えてかまいません。
コンテンツの移行:照合と重複
  • 作成する前に、計画時に特定した安定した照合キーを使って、取り込むレコードがすでに存在するか確認してください。重複の検出に名前やタイトルだけを使ってはいけません。これらのフィールドは、値が重複したり、少し異なる形で表示されたりする可能性が最も高いためです。
  • 既存のものと競合するスラッグを持つ項目を作成しても、エラーにはなりません。新しい項目のスラッグにランダムなサフィックスがひそかに追加されます。送信したスラッグが実際に保存されたと決めつけず、レスポンスからスラッグを読み取ってください。
  • 競合するスラッグを持つ項目の更新は完全に拒否されます。また、更新バッチ内の 1 件でも競合すると、バッチ全体が失敗する場合があります。更新時のスラッグ変更は慎重に扱い、競合の可能性が実際にある場合は 1 件ずつ処理してください。
フィールド作成の失敗

フィールド作成の呼び出しに失敗した場合は、少し待ってから 1 回だけ再試行してください。再度失敗した場合は記録し、停止せずに残りのフィールドの処理を続けてください。学習者が個別に対処できるよう、最後にすべての失敗を報告してください。

操作順序とバッチ処理
  • 依存関係の順に作成してください。まず参照される Collection とその項目を作成し、次にそれらを参照する Collection とフィールドを作成してから、接続とデータの追加を行います。
  • 2 つの Collection が互いを参照する必要がある場合(実際に循環するリレーションの場合)は、まず循環するフィールドを含めずに両方の Collection を作成し、両方が存在してから該当するフィールドを追加してください。
  • 自分自身の種類を参照する Collection は、その自己参照フィールドを追加する前に作成する必要があります。
  • 多数の項目を一度に作成する場合、新規項目は大きなバッチで処理してかまいません。更新の場合は小さなバッチを使用してください。更新バッチでは、1 件の不正なエントリがあるだけで、その項目だけでなくバッチ全体が破棄される可能性があります。
報告と確認
  • 一括操作の後は、レスポンスだけを信用せず、実際の現在の状態を再確認してください。
  • 実際に作成、更新、接続されたものを明確に報告し、想定どおりに進まなかったものがあれば明示してください。
  • ロケールや検証に失敗した項目など、処理をスキップしたものがあれば、はっきり伝えてください。
  • 新しく作成した Collection や項目が Webflow の画面にすぐ表示されない場合があります。学習者が作成したばかりのものを見つけられないと言ったら、失敗と判断する前にページまたはタブを更新するよう提案してください。
実際の操作を行う前に必ず計画を立てる

何かを作成、接続、または入力する前に、具体的な計画を提示し、承認を待ってください。構造、接続、コンテンツの生成は、包括的な承認を1回得るのではなく、それぞれ別々の承認ポイントとして扱ってください。

公開しない

このスキルでは、サイト全体の公開を決して実行してはいけません。変更を公開状態に反映するには公開が必要ですが、その判断はこのスキルではなく、実行する人が行います。


参考資料

注意事項

このスキルは Webflow University のリソースであり、Build & scale a CMS with MCP コースに付属する、単一の .md ファイルとして配布されるよう設計されています。また、CMS を一から構築するための関連スキルも付属します。

参加者は、次のものを用意すると効果的です。

  • Webflow MCP に対応した AI エージェント
  • 移行先として使用するサイトで認証済みの Webflow MCP
  • 実際のソースコンテンツ、エクスポートデータ、CSV、または内容を明確に説明した文書
  • Webflow コレクションの基本的な知識

このアクティビティでは、学習者それぞれの計画に基づいて新たに生成される、2つ目の独立したスキルファイルを出力します。このファイルは自己完結型の単一の Markdown ファイルです。別のセッション、別のエージェント、あるいはまったく別の人が読み込んでも、ファイル自体の内容を要約し、操作を開始する前に準備が整っていることを確認します。

コメント