workers-development について
Cloudflare Workers プロジェクトの開発とデバッグを支援するスキルです。既存のツールや設定に沿ってローカルデータやトレースを確認し、Cloudflare MCP が接続されていればデプロイ済み Worker の可観測性データも調べられます。
主な機能
- 01既存の開発コマンドを利用
- 02ローカルバインディングデータの確認
- 03ローカルリクエストのトレースとログ取得
- 04デプロイ済みサービスの可観測性データ照会
活用シーン
- 01ローカル KV、R2、D1 のデータ投入
- 02ローカルリクエストのトレース確認
- 03デプロイ済み Worker のログやメトリクス検索
MCP 対応
Cloudflare MCP サーバー接続時は、search と execute を使って Workers Observability API の操作を探し、実行できます。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/workers-developmentを入力して読み込まれたか確認します。
同梱ファイルreferences/skill-feedback.md
詳細
Workers の開発とデバッグ
プロジェクトに既存のツール、スクリプト、設定を使用してください。インストール済みのヘルプ、Local Explorer API スキーマ、最新のドキュメントに、サポートされている操作が記載されています。エンドポイントやフラグを推測せず、これらを確認してください。
| 必要なこと | ツールと確認方法 |
|---|---|
| ローカルで実行する | プロジェクトに既存の開発コマンドを使用してください。cf プロジェクトでは cf dev、それ以外では Wrangler または Cloudflare Vite の開発スクリプトを使用します。ローカル開発を参照してください。 |
| ローカルのバインディングデータを確認または投入する | Local Explorer は、ローカル KV、R2、D1、SQLite を基盤とする Durable Objects、Workflows 用の UI と API であり、Cron ハンドラーも実行できます。開発サーバーのオリジンで /cdn-cgi/local/explorer を開いてください。 |
| ローカルリクエストをデバッグする | Local Explorer は、コードを変更せずに、バインディング操作を含むすべてのローカル呼び出しのトレースとログを記録します。ログを追加する前にトレースを確認してください。 |
| デプロイ済み Worker をデバッグする | Workers observability を使用してログ、トレース、またはメトリクスを選択するか、インストール済みの場合は cloudflare スキルのオブザーバビリティに関するリファレンスを使用してください。Cloudflare MCP サーバー（このプラグインに同梱）が接続されている場合は、search で Workers Observability API の操作を探し、対象のアカウント、Worker、時間範囲を指定して execute で呼び出してください。 |
Local Explorer API を使用する
開発サーバーは、cf dev の実行中を含め、AI エージェントを検出すると、API の URL と関連エンドポイントを示すヒントを出力します。開発サーバーのオリジンで /cdn-cgi/local/explorer/api から OpenAPI 仕様を取得し、タスクに必要な操作だけを抽出してください。ヒントが表示されない場合は、その URL に直接リクエストしてください。API または操作が存在しない場合は、インストール済みの Wrangler または Vite プラグインのバージョンを Local Explorer ドキュメントの要件と照らし合わせてください。
デフォルトでは、バインディングはローカルでシミュレーションされますが、remote: true に設定されたバインディングは、Worker のローカル実行中に実際のデプロイ済みリソースへアクセスします。トレースには、これらのリモート呼び出しも記録されます。データを投入または書き込む前に、どのバインディングがリモートかを確認してください。
スキルへのフィードバック
このスキルのガイダンスが誤っている、または古いとユーザーから報告された場合や、情報が不足している場合は、references/skill-feedback.md を読んでください。