cloudflare · git:20261002.c0e127d · 2026-10-02 · sha256 191e641c865fd290
cloudflare git:20261002.c0e127dA
Immutable. This exact content never changes and is served at /api/v1/blob/191e641c865fd290.
--- name: cloudflare description: Cloudflare全体の製品選択と対象Accountの文脈を確定するルータースキル。Workers、Pages、KV、D1、R2、Workers AI、Vectorize、Agents SDK、Flagship、Tunnel、WAF、Terraform等のどの製品・参照・専用Skillを使うか判断する。Cloudflare要件が複数製品にまたがる、製品名が未確定、Accountの選択が必要な場合に使う。Wrangler操作、Durable Objects、Turnstile、Email Service、Workersコード、本番デプロイは責務表の専用Skillへ委譲し、本Skillで実行手順を重複定義しない。数値・API・設定は記憶よりCloudflare公式ドキュメントの取得を優先する。 --- > 本ファイルは cloudflare/skills（Apache-2.0）を基に改変しています。詳細は リポジトリルートの ATTRIBUTION.md を参照。 # Cloudflare製品選択ルーター Cloudflareの要件を実装する前に、以下の判断木で対象製品を1つ以上確定し、専用Skill・同梱reference・`cloudflare-docs` MCPのいずれか1つだけを読み込む。本Skillの責務は「何を使うか」と「どのAccountを使うか」の確定までであり、個別製品の実行手順は専用Skillに委譲する。 CloudflareのAPI、型、上限、価格は更新される。**事前知識より最新情報の取得を優先する**。同梱referenceは既定スタックと要件フラグ経由の製品に絞ってあり、それ以外の製品仕様は`cloudflare-docs` MCPで取得する。同梱referenceも探索の起点であり、最新仕様の正本ではない。 ## 最新情報の取得先 具体的な数値、APIシグネチャ、設定オプションを記載・実装する前に、必ず最新情報を取得する。事前知識や同梱referenceだけで確定しない。 **第一手段は `cloudflare-docs` MCP**(認証不要、`https://docs.mcp.cloudflare.com/mcp`)。本Skillが同梱するreferenceは、キット既定スタック(Workers / D1 / R2 / KV とそのbinding)と、要件フラグ経由で確実に使う製品(Queues / Workflows / Vectorize)だけに絞ってある。**それ以外のCloudflare製品のreferenceは同梱していない**。判断木で製品を確定したら、その製品名でdocs MCPを検索する。 | 取得先 | 取得方法 | 使う場面 | |--------|----------------|---------| | **Cloudflare docs (MCP)** | `cloudflare-docs` MCPで製品名・API名を検索 | **既定の第一手段**。上限、価格、API reference、compatibility dates/flags、および同梱referenceのない全製品 | | Cloudflare docs (Web) | `https://developers.cloudflare.com/<product>/` を取得 | docs MCPが使えないときの代替 | | Workers types | `pnpm pack @cloudflare/workers-types`または`node_modules`を確認 | 型シグネチャ、binding形状、handler型 | | Wrangler config schema | `node_modules/wrangler/config-schema.json` | 設定フィールド、binding形状、許容値 | | Product changelogs | `https://developers.cloudflare.com/changelog/` | 上限、機能、廃止予定の最新変更 | 同梱referenceは探索の起点であり、最新仕様の正本ではない。referenceと公式docsが食い違う場合は**公式docsを正とする**。特に数値上限、pricing tier、型シグネチャ、設定オプションは必ずdocs MCPで再取得する。 MCP の配置 scope と Cloudflare OAuth の認可 scope は別物であり、`cloudflare-docs` は認証不要、Bindings 等は**そのcapabilityを初めて使う時だけ対象1件を認可**する。詳細と MCP 不通時の復旧(未登録 / 不通 / legacy sse / scope 衝突)は `skills/wrangler/references/mcp-vs-cli-routing.md` が唯一の正本。docs MCP が使えないときの手順は下記「docs MCPに接続できないとき」。 ## 専用Skillとの責務分担 次の領域は本Skillで実行手順を展開せず、対応する専用Skillをロードする。Account文脈が必要な場合は、本Skillで確定した結果を委譲先へ渡す。 | 要件・作業 | 責務を持つSkill | 本Skillが行うこと | |---|---|---| | Wrangler CLIのコマンド、設定、トラブルシュート | `wrangler` | 対象製品とAccount文脈の確定のみ | | Durable Objectsの設計・実装・テスト | `durable-objects` | Durable Objectsを選ぶべきかの判断のみ | | Turnstile / CAPTCHA / bot対策 | `turnstile-spin` | Turnstileを選定しAccount文脈を渡す | | Email Sending / Email Routing / deliverability | `cloudflare-email-service` | Email領域へのルーティングのみ | | Workersコードの作成・レビュー | `workers-best-practices` | Workersの採用判断と関連製品の選定のみ | | 本番デプロイ、D1 migration、secret、セキュリティ設定 | `cloudflare-secure-deploy` | 対象Accountと利用製品の確定のみ | 委譲先で MCP と wrangler CLI のどちらを使うかは `skills/wrangler/references/mcp-vs-cli-routing.md` の「作業別の既定経路」に従う(仕様の確認と調査は MCP、deploy / secret / migration は CLI 既定)。本Skillでは経路表を複製しない。 上記以外の製品は、本Skillの判断木で確定したうえで、同梱referenceがあればそれだけを読み、なければ`cloudflare-docs` MCPで検索する。別の専用Skillがあるのに、本Skill内の似たreferenceと両方を実行手順として読み合わせない。 ## Account文脈の正本 Cloudflareのcreate/update/delete、secret、migration、deployの前に、[Account文脈の自動検出](references/account-context.md)を実行する。特定のrepository名、利用者名、Account名、Account IDを既定値として埋め込まない。 利用者へ最初からAccount情報を尋ねない。プロジェクト設定とread-onlyなCloudflare照合からAccount候補と既存resourceの所有先を自動検出し、次の順で決める。 1. 既存resourceの所有Accountが1つに定まる場合は、そのAccountを自動選択する。 2. 新規projectで既存resourceがない場合は、客観的にチーム用と確認できるAccountを既定推奨する。 3. 根拠が同率の候補が複数残る場合だけ、Account名・種別・一致したresourceを番号付きで示し、番号だけを選んでもらう。 選定結果のmodeは`existing` / `team` / `personal`のいずれかとする。既存resource所有先を選んだ場合は、Account種別を推測せず必ず`existing`にする。`team`既定はresourceが存在しない新規projectだけに適用する。 完全なAccount ID、token、secretはchat、ログ、最終報告、project fileへ出力・保存しない。選択結果はWranglerのdirectory-bound auth profileなど、プロジェクト単位の安全な仕組みで保持する。利用できない場合はsession内だけで扱い、次回は再検出する。CI/CDで資格情報が必要なら`ci-cd-pipeline`へ委譲し、Workers Buildsまたは外部CI/CDを選ぶ。どちらでも資格情報をrepositoryへ値として書かない。 ## docs MCPに接続できないとき 判断木で `docs:<name>` に到達したのに `cloudflare-docs` MCP が使えない場合は、次の3段で埋め、どの段で止まったかを報告に残す。 1. **MCP 不通**: `claude mcp list` で状態を確認し、`skills/wrangler/references/mcp-vs-cli-routing.md` の「MCP 不通時の復旧」4分岐に従う。復旧を待たずに次段へ進んでよい。 2. **Web 取得**: `https://developers.cloudflare.com/<product>/` を直接取得する(Codex サンドボックス等でネットワーク不可なら次段へ)。 3. **同梱知識で埋める**: `references/<name>/gotchas.md` と `patterns.md`、`node_modules/wrangler/config-schema.json`(設定フィールド・binding形状)で埋め、確認できなかった数値・API・上限は推測で書かず「未確認」として報告に残す。 ## 製品選択の判断木 判断木は「どの製品を選ぶか」を確定するためのものであり、選定後に読む先は2種類しかない。 - `→ references/<name>/` — 同梱referenceを読む(既定スタックと要件フラグ経由の製品のみ)。索引と「MCP で代替可か」は `references/README.md` - `→ docs:<name>` — **`cloudflare-docs` MCPで `<name>` を検索する**(同梱referenceはない) - `` → `<skill>` Skill `` — その専用Skillをロードする ### フィーチャーフラグが必要 ``` フィーチャーフラグが必要? └─ 機能のON/OFF、対象条件、割合配信 → docs:flagship ├─ Workers内で評価 → Flagship binding (env.FLAGS) ├─ Node.js / browserで評価 → OpenFeature SDK (@cloudflare/flagship) └─ APIでflagを管理 → Flagship REST API ``` ### コードを実行したい ``` コードを実行したい? ├─ エッジで動くサーバーレス関数 → references/workers/ ├─ Git連携で公開するフルスタックWebアプリ → docs:pages │ (キット既定はPagesではなくWorkers。 │ mvp-first-development §3 を優先する) ├─ 状態を共有する協調処理/リアルタイム → `durable-objects` Skill ├─ 複数段階の長時間ジョブ → references/workflows/ ├─ コンテナ実行 → docs:containers ├─ 顧客がコードを公開するマルチテナント → docs:workers-for-platforms ├─ 定期実行 (cron) → docs:cron-triggers ├─ HTTPを変更する軽量なエッジ処理 → docs:snippets ├─ Worker実行イベント（log/observability）の処理 → docs:tail-workers └─ backend infrastructureまでの遅延を最適化 → docs:smart-placement ``` ### データを保存したい ``` ストレージが必要? ├─ Key-value（config、session、cache） → references/kv/ ├─ Relational SQL → references/d1/ (SQLite)またはdocs:hyperdrive (既存Postgres/MySQL) ├─ オブジェクト/ファイルストレージ (S3-compatible) → references/r2/ ├─ バージョン管理されたファイルツリー（repo、build output、checkpoint） → docs:artifacts ├─ メッセージキュー（非同期処理） → references/queues/ ├─ Vector embeddings (AI/semantic search) → references/vectorize/ ├─ entity単位の強整合性を持つ状態 → `durable-objects` Skill ├─ シークレット管理 → docs:secrets-store ├─ R2へのstreaming ETL → docs:pipelines ├─ R2上のmanaged Apache Iceberg catalog → docs:r2-data-catalog ├─ Iceberg tableへのserverless SQL analytics → docs:r2-sql └─ 長期保持の永続キャッシュ → docs:cache-reserve ``` ### AI/MLを使いたい ``` AIが必要? ├─ 外部LLM API（既定） → `llm-api-integration` Skill ├─ 推論 (LLMs, embeddings, images) → docs:workers-ai ├─ RAG/search用ベクトルDB → references/vectorize/ ├─ 状態を持つAI agent → docs:agents-sdk ├─ AI provider用Gateway（キャッシュ、ルーティング） → docs:ai-gateway └─ AI search widget → docs:ai-search ``` ### ネットワーク/接続が必要 ``` ネットワークが必要? ├─ ローカルサービスをインターネットへ公開 → docs:tunnel ├─ TCP/UDP proxy (non-HTTP) → docs:spectrum ├─ WebRTC TURN server → docs:turn ├─ プライベートネットワーク接続 → docs:network-interconnect ├─ ルーティング最適化 → docs:argo-smart-routing ├─ backendまでの遅延を最適化（userまでではない） → docs:smart-placement └─ real-time video/audio → docs:realtimekit または docs:realtime-sfu ``` ### セキュリティ機能が必要 ``` セキュリティ機能が必要? ├─ Web Application Firewall → docs:waf ├─ DDoS protection → docs:ddos ├─ botの検出/管理 → docs:bot-management ├─ API保護 → docs:api-shield ├─ CAPTCHA代替 → `turnstile-spin` Skill └─ 資格情報の漏えい検出 → docs:waf (managed ruleset) ``` ### メディア/コンテンツを扱いたい ``` メディア機能が必要? ├─ 画像の最適化/変換 → docs:images ├─ 動画の配信/encoding → docs:stream ├─ browser自動化/screenshot → docs:browser-rendering └─ third-party script管理 → docs:zaraz ``` ### 分析/メトリクスを扱いたい ``` 分析が必要? ├─ Cloudflare全製品（HTTP、Workers、DNS等）の横断query → docs:graphql-api ├─ Workersからのcustom high-cardinality metrics → docs:analytics-engine ├─ client-side (RUM)のperformance data → docs:web-analytics ├─ Workers Logsとリアルタイムdebugging → `cloudflare-secure-deploy` Skill │ (wrangler.jsonc の observability 設定と │ head_sampling_rate を含む) ├─ Iceberg data lake（log、event）へのSQL → docs:r2-sql (+ pipelines, r2-data-catalog) └─ raw logs（外部ツールへのLogpush） → docs:logpush ``` ### Infrastructure as Code (IaC)が必要 ``` IaCが必要? → docs:pulumi (Pulumi)、docs:terraform (Terraform)、またはdocs:api (REST API) ``` ## 同梱referenceの一覧 同梱しているのは次の8製品だけ。**これ以外のCloudflare製品は判断木の`docs:<name>`に従い`cloudflare-docs` MCPで検索する**(公式ドキュメントに載っている製品はすべて取得できる)。 | 製品 | Reference | 同梱理由 | |---|---|---| | Workers | `references/workers/` | キット既定ランタイム(`mvp-first-development` §3) | | D1 | `references/d1/` | キット既定DB(同上) | | R2 | `references/r2/` | キット既定ファイルストレージ(同上) | | KV | `references/kv/` | キット既定セッション/キャッシュ(同上) | | Bindings | `references/bindings/` | 上記をWorkersへ接続する共通機構。全アプリで必ず使う | | Queues | `references/queues/` | 要件フラグ「上記以外のCloudflare機能」で本Skillへ明示ルーティングされる | | Workflows | `references/workflows/` | 同上 | | Vectorize | `references/vectorize/` | 同上 | Account文脈は `references/account-context.md`(本Skill独自。公式docsには存在しない)。 ## 選定結果の出力 本Skill自体は製品の実装完了を報告しない。ルーティング完了時に、次の4点を日本語で簡潔に出力し、選定先のSkillまたはreferenceへ引き継ぐ。 1. **選んだCloudflare製品** 2. **選定根拠**（要件のどの部分に対応するか） 3. **使う専用Skillまたはreference** 4. **Account文脈**（`existing` / `team` / `personal`のいずれか。`existing`をteam/personalへ言い換えず、Account IDは表示しない）