情境

Cloudflare Workers 部署

部署 Cloudflare Workers，管理 KV 命名空間、邊緣函數和 Wrangler 工作流程，並提供自動化 CI/CD 管線。

6 技能 4 安裝次數

cloudflareworkersedgekvwrangler

4 天前更新

安裝

執行此指令以安裝此技能包中的所有技能：

npx skillstore add @cloudflare-workers-deploy

CLI 會自動偵測 Codex 與 Claude Code 資料夾；如果兩者都可用，會同時安裝。

總覽

使用指南

由 AI 強化

詳細指南

## 適用對象

部署至 Cloudflare Workers 和 Pages 的開發人員。本外涵蓋完整的生命週期 —— 從設計邊緣優化架構到使用 wrangler 部署、追蹤部署狀態，以及遵循生產環境最佳實踐。

## 3 步驟快速入門

1. **設計您的邊緣部署** — 詢問：`"Use edge-computing-patterns to suggest the best Cloudflare Workers architecture for a globally distributed API"`。此技能涵蓋 Worker 路由、KV 儲存和 D1 資料庫模式。
2. **使用 wrangler 部署** — 詢問：`"Use wrangler to deploy my Worker in ./src/worker.ts to production"`。wrangler 和 dicklesworthstone-wrangler 技能會處理 Wrangler CLI、KV 命名空間、R2 儲存桶和密鑰。
3. **追蹤與管理** — 詢問：`"Use deployment-management to list all active Workers deployments and check their health status"`。如需完整的部署策略，請詢問：`"Use the Deployment Engineer to create a deployment plan for rolling out v2 with zero downtime"`。

## 步驟 → 技能 → 輸入 → 輸出

| 步驟 | 技能 | 您需要提供 | 您將獲得 |
|------|-------|------------------|--------------|
| 架構設計 | edge-computing-patterns | 應用程式需求 | Workers 架構 + 路由建議 |
| 部署 | wrangler / dicklesworthstone-wrangler | Worker 原始碼路徑 + 環境 | 部署 URL + wrangler 輸出 |
| 生產部署流程 | deploying-to-production | 倉庫 URL + 目標平台 (Vercel/CF) | GitHub 倉庫 + 即時部署 |
| 追蹤部署 | deployment-management | 基礎設施名稱/範圍 | 部署狀態 + 健康報告 |
| 部署策略 | Deployment Engineer | 應用程式類型 + 發布需求 | 逐步部署計劃 |

## 常見問題與解決方案

- **wrangler 失敗並顯示 "not authenticated"** → 請先在終端機執行 `wrangler login`，或設定 `CLOUDFLARE_API_TOKEN` 環境變數。
- **edge-computing-patterns 給出通用答案** → 請指定您的使用案例：`"globally distributed read-heavy API with 50ms SLA"` 會提供更精準的模式。
- **deployment-management 顯示沒有部署** → 請確認基礎設施範圍或專案名稱與您 Cloudflare 儀表板中的內容完全匹配。

## 成功標準

當以下情況發生時，表示成功了：
- edge-computing-patterns 返回具體的架構圖或路由設定
- wrangler 或 dicklesworthstone-wrangler 輸出 `workers.dev` 或自訂網域 URL
- deployment-management 確認所有 Worker 實例都處於健康狀態