cloudflare-knowledge

Cloudflare ナレッジスキル

Workers、エッジストレージ、AI、MCP、Zero Trust を網羅する、Cloudflare プラットフォームの包括的な知識です。references/ にある詳細なリファレンスを活用する、軽量なオーケストレーターとして機能します。

アクティベーションのトリガー

ユーザーから次の内容について質問された場合、このスキルを有効にします。

• Cloudflare Workers の開発、Wrangler CLI、wrangler.jsonc の設定
• ストレージサービス（R2、D1、KV、Durable Objects、Queues、Hyperdrive）
• Workers AI の推論（LLM、TTS、STT、画像、埋め込み、ビジョン）
• Workers 上での MCP サーバー開発
• Zero Trust（トンネル、WARP、Access ポリシー）
• Workflows と永続的な実行、Vectorize、Pages、cron トリガー
• GitHub Actions または Workers Builds を使った CI/CD
• オブザーバビリティ、ロードバランシング、コストの最適化

リファレンスマップ

現在のタスクに必要なリファレンスだけを読み込みます。

トピック	ファイル	読み込むタイミング
Wrangler CLI の全コマンド、wrangler.jsonc の完全なスキーマ、GitHub Actions、Workers Builds	references/wrangler-cli-and-config.md	プロジェクトの初期化、バインディングの設定、CI パイプラインの作成、wrangler のトラブルシューティング
KV、R2、D1、Durable Objects、Queues、Hyperdrive — 特性、TypeScript API、ベストプラクティス、WebSocket Hibernation、マルチパートアップロード	references/storage-services-deep-dive.md	ストレージサービスの選定、バインディングのハンドラーコードの作成、スキーマまたはパーティショニングの設計
Workers AI カタログ（テキスト／TTS／STT／画像／ビジョン／埋め込み）、呼び出し例、Workers 上の MCP サーバー、Cloudflare Tunnel のインストール + Access ポリシー + WARP	references/ai-workers-usage.md	AI モデルの呼び出し、MCP サーバーの構築、cloudflared のセットアップ、Zero Trust イングレスの設定
Workers AI のモデル選定（タスクごとのモデル、コンテキストウィンドウ、パフォーマンス）	references/ai-workers-models.md	Llama、Mistral、Qwen、DeepSeek、Whisper の各種モデルなどの選定
MCP サーバー開発の詳細（トランスポートの種類、認証、ツールスキーマ）	references/mcp-server-development.md	本番環境向け MCP サーバーの構築、トランスポートのデバッグ
Zero Trust セットアップの詳細（組織ポリシー、ID プロバイダー、ポスチャチェック）	references/zero-trust-setup.md	本番環境への Zero Trust 導入
AWS／Azure／GCP とのコスト比較、料金表、最適化の手法	references/cost-comparison.md	予算計画、プラン選定、コストの最適化
Cloudflare 以外のサービスとの連携（Stripe、OpenAI、GitHub、Workers からのサードパーティ API）	references/third-party-integrations.md	外部 API と Worker の接続

プラットフォームの概要

Cloudflare は、300 以上のデータセンターを擁するグローバルなエッジコンピューティングプラットフォームで、次のサービスを提供します。

• Workers — エッジで動作するサーバーレスの JavaScript／TypeScript／Python／WASM
• Pages — 静的サイトおよびフルスタックアプリのホスティング
• R2 — エグレス料金が無料の S3 互換オブジェクトストレージ
• D1 — サーバーレス SQLite データベース（強整合性、最大 10 GB）
• KV — 結果整合性のキーバリューストア
• Durable Objects — WebSocket Hibernation によるステートフルな調整
• Queues — DLQ による非同期メッセージ処理
• Hyperdrive — リモートの Postgres／MySQL 向けデータベース接続プーリング
• Workers AI — エッジでの LLM／TTS／STT／画像／埋め込み／ビジョン
• Zero Trust — アイデンティティベースのセキュリティプラットフォーム
• Vectorize — RAG 向けベクトルデータベース
• Workflows — 永続的なマルチステップ実行

コアワークフロー

1. スキャフォールド — npm create cloudflare@latest を実行し、続けて npx wrangler login を実行します。Wrangler CLI の詳細：wrangler-cli-and-config.md。
2. ストレージのプリミティブを選択 — 設定／セッションには KV、バイナリデータには R2、リレーショナルデータには D1、調整には Durable Objects、非同期処理には Queues、リモート SQL には Hyperdrive を使用します。特性とトレードオフ：storage-services-deep-dive.md。
3. wrangler.jsonc にバインディングを追加 — KV ネームスペース、R2 バケット、D1 データベース、DO、Queues、AI、Vectorize、サービスバインディング、cron トリガー、ルート、オブザーバビリティを設定します。完全なスキーマ：wrangler-cli-and-config.md。
4. ハンドラーを実装 — fetch、scheduled、queue、email を使用します。バインディングごとの API：storage-services-deep-dive.md。AI の呼び出し：ai-workers-usage.md。
5. ローカルで開発 — npx wrangler dev を実行します（リモートバインディングには --remote を使用し、/__scheduled?cron=*+*+*+*+* で crons をトリガーします）。
6. デプロイ — npx wrangler deploy [--env staging] を実行します。npx wrangler rollback でロールバックできます。CI/CD のレシピ（GitHub Actions、Workers Builds）：wrangler-cli-and-config.md。

クイック選択ガイド

タスク	選択肢	参照先
ユーザーセッション、設定フラグを保存する	KV（結果整合性）	storage-services-deep-dive.md
メディア、バックアップ、データセットを保存する	R2（エグレス料金ゼロ、5 TB のオブジェクト）	storage-services-deep-dive.md
リレーショナルクエリ、ACID	D1（SQLite、強整合性）	storage-services-deep-dive.md
リアルタイムの調整、チャット、カウンター	Durable Objects（＋WebSocket ハイバネーション）	storage-services-deep-dive.md
バックグラウンドジョブ、疎結合化	Queues（少なくとも 1 回の配信、DLQ）	storage-services-deep-dive.md
低レイテンシーのリモート Postgres／MySQL	Hyperdrive	storage-services-deep-dive.md
エッジでの LLM／埋め込み／TTS／STT	Workers AI	ai-workers-usage.md ＋ ai-workers-models.md
ファイアウォールを開かずに内部アプリを公開する	Cloudflare Tunnel（cloudflared）	ai-workers-usage.md（クイックスタート）＋ zero-trust-setup.md（本番環境）
Workers 上に MCP サーバーを構築する	@cloudflare/mcp-server	ai-workers-usage.md（クイックスタート）＋ mcp-server-development.md（詳細）
Stripe、OpenAI、GitHub などと統合する	サードパーティ API のパターン	third-party-integrations.md
AWS／Azure／GCP と比較して予算を計画する	料金の比較	cost-comparison.md

ベストプラクティス

パフォーマンス

1. エッジキャッシュを使用する — caches.default で API レスポンスをキャッシュします。
2. コールドスタートを最小限に抑える — Workers を小さく保ち、動的インポートを優先します。
3. サービスバインディングを使用する — Worker 間の呼び出しを無料で実行できます。
4. 操作をバッチ処理する — KV／R2／D1 の操作をまとめます。
5. リモートの PostgreSQL／MySQL には Hyperdrive を使用します。

セキュリティ

1. 認証情報には wrangler secret put を使用し、ハードコードしないでください。
2. すべてのユーザー入力を検証し、サニタイズします。
3. 常に HTTPS を使用し、ルートで強制します。
4. レート制限を実装します（Workers Rate Limiting API または WAF ルール）。
5. 内部サービスには Zero Trust Access を使用します（zero-trust-setup.md を参照）。

コスト最適化

1. 静的アセットを使用します（静的ファイルの配信は無料、無制限です）。
2. トラフィックの多い Workers では、observability.logs.head_sampling_rate を使用してログをサンプリングします。
3. KV／R2 をキャッシュに使用して、D1 や外部 API の呼び出しを減らします。
4. Queue メッセージをバッチ処理し、メッセージごとのオーバーヘッドを削減します。
5. タスクに合ったサイズのモデルを Workers AI で選択します。ai-workers-models.md を参照してください。
6. 料金表の全文とクラウド間の比較：cost-comparison.md。

クイックリファレンス

タスク	コマンド
新規プロジェクト	npm create cloudflare@latest
ローカル開発	npx wrangler dev
デプロイ	npx wrangler deploy
D1 の作成	npx wrangler d1 create <name>
KV の作成	npx wrangler kv namespace create <NAME>
R2 の作成	npx wrangler r2 bucket create <name>
シークレットの設定	npx wrangler secret put <NAME>
キューの作成	npx wrangler queues create <name>
トンネルの作成	cloudflared tunnel create <name>
Hyperdrive の作成	npx wrangler hyperdrive create <name> --connection-string=...

コマンドの全容（すべてのフラグとサブコマンド）は、references/wrangler-cli-and-config.md に記載されています。