mcpField
K
knock-migrate-to-knock

knock-migrate-to-knock

github.com/knocklabs開発168 回インストール今日更新
リポジトリ

knock-migrate-to-knock について

リポジトリ内のメッセージングプロバイダー、SDK、テンプレート、送信箇所を調べ、Knockの概念に対応付けて段階的な移行計画を作成するスキルです。調査と提案に特化し、計画はルートの `knock-plan.md` に記録します。明示的な許可なしにKnockリソースは変更しません。

主な機能

  1. 01既存のメッセージング構成を調査
  2. 02メッセージング概念をKnockに対応付け
  3. 03段階的な移行計画を作成
  4. 04`knock-plan.md` に計画を記録
  5. 05無許可でのKnockリソース変更を回避

活用シーン

  1. 01BrazeまたはCourierからの移行を評価
  2. 02メールやプッシュなどの送信経路を整理
  3. 03アプリのトリガー切り替えと旧送信の廃止を計画

MCP 対応

明示的な許可がない限り、MCPまたはCLI経由でKnockリソースを作成、更新、プッシュ、コミット、削除しない仕様です。

インストール

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

$npx skills add https://github.com/knocklabs/skills --skill knock-migrate-to-knock

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

rules/
inventory-existing-messaging.md
map-concepts-to-knock.md
migration-plan.md

詳細

翻訳後に原文が更新されています。最新の内容は原文をご確認ください。

Knock スキルへの移行

このコードベースで現在使用しているメッセージングスタックを特定し、Knock の概念に対応付けて、順序立てた移行計画を作成します。これは調査と推奨を行うスキルです。

厳守事項

ユーザーが計画を確認した後に明示的に依頼しない限り、MCP または CLI を通じて Knock リソース（ワークフロー、ガイド、ユーザー、テナント、設定、パーシャル、レイアウト）を作成、更新、プッシュ、コミット、削除しないでください。本番環境へのインポートは実行しないでください。計画、インベントリ、任意のローカルアプリコードの提案のみを出力してください。

出力要件（厳守）

インベントリと移行計画を、リポジトリのルートにある knock-plan.md に書き込んでください（knock-product-messaging-strategy と knock-lifecycle-opportunities が共有する計画ファイルです。新しい計画ファイルを別途作成せず、既存のファイルを作成または更新してください）。チャットへの出力は最小限にしてください。ステータスと確認のみを伝えます。

インベントリの表や段階別の計画全体をチャットに貼り付けないでください。

チャットで許可される内容：

  1. 短いステータス行を1行（パスと件数。例：検出したプラットフォーム数と見つかったメッセージタイプ数）
  2. 任意のブロッカーを1行
  3. 最終行に太字の確認質問

例：

knock-plan.md に書き込みました：Courier と SendGrid を検出し、14 種類のメッセージをインベントリに記録、8 段階の計画を作成しました。

次に、どの移行フェーズを詳しく計画しますか？

使用するドキュメント（出力にリンクを含める）

推奨内容は必ず Knock のドキュメントに基づいてください。以下を優先してください。

状況ドキュメント
Braze → Knockhttps://docs.knock.app/tutorials/migrate-from-braze
Courier → Knockhttps://docs.knock.app/tutorials/migrate-from-courier
MCP 経由のメールテンプレート（ユーザーが実行を依頼した場合のみ）https://docs.knock.app/tutorials/migrate-email-with-mcp-server
ワークフローhttps://docs.knock.app/concepts/workflows
チャネルhttps://docs.knock.app/concepts/channels
ユーザーhttps://docs.knock.app/concepts/users
設定https://docs.knock.app/preferences/overview
テナント／マルチテナンシーhttps://docs.knock.app/multi-tenancy/overview
サブスクリプションhttps://docs.knock.app/concepts/subscriptions
翻訳https://docs.knock.app/template-editor/translations
ワークフローのトリガーhttps://docs.knock.app/send-notifications/triggering-workflows
ソース（CDP）https://docs.knock.app/integrations/sources/overview

概要

  1. 現在のスタックをインベントリ化する（rules/inventory-existing-messaging.md）
  2. 概念を Knock に対応付ける（rules/map-concepts-to-knock.md）
  3. 段階的な移行計画を作成する（rules/migration-plan.md）

このスキルの使い方

  1. リポジトリ内を検索して、プロバイダー、SDK、テンプレート、送信呼び出し箇所を特定します（インベントリのルールを参照）。調査結果はチャットではなく knock-plan.md に記録します。
  2. ソースプラットフォームを特定します。例：Braze、Courier、Customer.io、Iterable、Novu、ESP 直接連携（SendGrid／Postmark／Resend／SES）、Slack ボット、カスタムキューなど。
  3. Braze または Courier の場合は、該当する移行チュートリアルを開きます。それ以外の場合は、rules/map-concepts-to-knock.md の汎用マッピング表を使います。
  4. 段階別の移行計画（フェーズ、リスク、Knock の概念へのリンク）を knock-plan.md に記載します。チャットでは、次に計画または実行するフェーズを尋ねます。依頼がない限り、Knock への書き込みは実行しないでください。

ルールファイルの参照先

  • rules/inventory-existing-messaging.md — コードベース内で調査する項目
  • rules/map-concepts-to-knock.md — プラットフォームの概念 → Knock
  • rules/migration-plan.md — 段階別計画の出力形式

クイックリファレンス

推奨するリソースの移行順序（Knock の Braze／Courier チュートリアルより）：

  1. チャネル／プロバイダー接続
  2. ワークフローとテンプレート（ロジック＋コンテンツ）
  3. 翻訳
  4. テナント（マルチテナントの場合はブランディングのコンテキストも）
  5. ユーザー／identify
  6. サブスクリプション（リスト → オブジェクトのサブスクリプション）
  7. 設定（ユーザー作成後。トピック／グループをワークフローのカテゴリに対応付け）
  8. アプリケーションコード内のトリガーを切り替える
  9. 旧来の送信処理を廃止する

コメント

Markdown 対応