cloudflare

Cloudflare インフラストラクチャ運用

Cloudflare サービス（Workers、KV、R2、D1、Hyperdrive、Observability、Builds、Audit Logs）を管理します。

MCP は任意です。 このスキルは MCP（自動）、Wrangler CLI、または Dashboard で動作します。実行方法については BACKENDS.md を参照してください。

権限レベル

レベル	目的	対象範囲	リスク管理
診断	読み取り専用／クエリ／トラブルシューティング	Observability、Builds、Audit	デフォルトの開始点。書き込みなし
変更	リソースの作成／変更／削除	KV、R2、D1、Hyperdrive	確認と検証が必要
スーパー管理者	最高権限	すべて + Container Sandbox	隔離／テスト環境でのみ使用

セキュリティルール

読み取り操作

1. 最初に対象範囲を定義する — アカウント／ワーカー／リソース ID
2. アカウントが設定されていない場合 — まずアカウントを一覧表示し、その後アクティブなアカウントを設定する
3. 証拠が必要 — 結論にはログ／スクリーンショット／監査記録が必要です

書き込み操作（3 ステップのフロー）

1. Plan: Read current state first (list/get)
2. Confirm: Output precise change (name/ID/impact), await user confirmation
3. Execute: create/delete/update
4. Verify: audit logs + observability confirm no new errors

禁止事項

• ❌ 確認なしで作成／削除／更新を実行する
• ❌ 本番リソースを削除する（ユーザーが「本番の xxx を削除」と明示的に指示した場合を除く）
• ❌ 隔離されていない環境でスーパー管理者権限を使用する
• ❌ コンテナサンドボックスを永続的な環境として使用する

操作カテゴリ

診断レベル（読み取り専用）

カテゴリ	実行できる操作
Observability	ワーカーのログ／メトリクスをクエリし、フィールドを検出し、値を調査する
Builds	ビルド履歴の一覧表示、ビルド詳細の取得、ビルドログの表示
Browser	ページの HTML を取得し、Markdown に変換し、スクリーンショットを撮影する
Audit	時間範囲を指定して変更履歴を取得する
Workers	ワーカーの一覧表示、詳細の取得、ソースコードの表示

変更レベル（書き込み操作）

リソース	操作
KV	一覧表示、取得、作成 ⚠️、更新 ⚠️、削除 ⚠️
R2	一覧表示、取得、作成 ⚠️、削除 ⚠️
D1	一覧表示、取得、クエリ、作成 ⚠️、削除 ⚠️
Hyperdrive	一覧表示、取得、作成 ⚠️、編集 ⚠️、削除 ⚠️

⚠️ = 確認が必要

スーパー管理者レベル（Container Sandbox）

隔離されたタスク用の一時コンテナ（ライフサイクルは約 10 分）：

• 初期化、コマンドの実行、ファイルの読み取り／書き込み／削除
• 使用目的：テストの実行、問題の再現、データの解析
• 使用禁止：永続的な状態、本番ワークロード

一般的なワークフロー

トラブルシューティングのフロー

1. Clarify symptoms → worker name / time range / error type
2. Query observability to pull logs/metrics
3. If build-related → get build logs
4. If page-related → take screenshot to reproduce
5. Trace changes → pull audit logs
6. Summarize: root cause + evidence + fix recommendations

リソース管理のフロー

1. List accounts → set active account
2. List resources (KV / R2 / D1)
3. Plan changes → present to user
4. Execute after confirmation
5. Verify: audit logs + observability shows no errors

出力形式

• 言語：英語
• 構成：結論 → 主要なデータ／証拠 → ツール呼び出しの概要 → 次のステップ
• 書き込み操作：操作と影響範囲を明確に列挙する必要があります

例：

✅ Investigation complete: worker `api-gateway` experienced 5xx spike between 18:00-18:30

Root cause: New code deployed threw TypeError when processing /v2/users
Evidence:
- Logs: 18:02 first occurrence of "Cannot read property 'id' of undefined"
- Audit: 18:00 user [email protected] deployed new version
- Metrics: error_rate jumped from 0.1% to 12%

Recommendation: Roll back to previous version, or fix /v2/users handler

ファイルベースのパイプライン

複数ステップのワークフローに統合する場合：

runs/<workflow>/active/<run_id>/
├── proposal.md                # Symptoms/objectives
├── context.json               # Account/worker/resource/time_range
├── tasks.md                   # Checklist + approval gate
├── evidence/observability.md
├── evidence/audit.md
├── evidence/screenshots/
├── evidence/change-plan.md    # Write operations written here first
├── evidence/report.md         # Conclusion + evidence + next steps
└── logs/events.jsonl          # Optional tool call summary

エラー処理

状況	対応
アカウントが設定されていない	まず accounts_list を実行し、次に set_active_account を実行する
リソースが存在しない	ID／名前を確認し、利用可能なリソースを一覧表示する
権限が不足している	必要な権限を説明し、API トークンのスコープを確認する
Observability のクエリ範囲が広すぎる	時間範囲をより小さく分割する

関連ファイル

• BACKENDS.md — 実行方法（MCP／CLI／Dashboard）
• SETUP.md — MCP の設定（任意）
• scenarios.md — 実際のシナリオ例 20 件