cloudflare-deploy

cloudflare-deploy 技能總覽

cloudflare-deploy 的功能

cloudflare-deploy 技能可以幫你在 Cloudflare 上部署應用程式與平台服務，比起通用提示更少猜測。它的目標是把像「把這個 app 發佈到 Cloudflare」這種模糊需求，轉成可執行的部署路徑，涵蓋 Workers、Pages、Durable Objects 以及相關的 Cloudflare 產品。

誰適合使用

如果你需要 Cloudflare 專屬的部署指引，尤其當問題不只是「執行 wrangler deploy」而是「這個服務應該放在哪個 Cloudflare 產品上？」時，就適合用 cloudflare-deploy skill。對於要搬移既有應用程式、加入 edge 邏輯，或在 Workers 與 Pages 之間做選擇的開發者，特別合用。

為什麼它有用

這個 repository 以決策樹和產品專屬參考資料為主，所以這個技能比起一體適用的部署提示，更擅長做路徑選擇與落地細節處理。當真正的阻礙不是產生程式碼，而是在部署前先選對 Cloudflare 目標、驗證流程，或 service binding 時，這點尤其重要。

如何使用 cloudflare-deploy 技能

安裝並驗證技能

請使用目錄標準指令走 cloudflare-deploy install 流程：
npx skills add openai/skills --skill cloudflare-deploy

安裝完成後，先確認這個技能能讀到 repository context，且你已準備好 Cloudflare 驗證資訊。cloudflare-deploy usage 流程假設 wrangler 已可用，而且在部署前可以先確認身分。

從正確的原始檔開始

若想快速進入 cloudflare-deploy guide，先讀 SKILL.md，再查看最能幫助做決策的目標路徑參考資料。常見的起點包括 references/wrangler/auth.md、references/pages/、references/workers/ 這類產品參考資料，以及如果你的部署包含 Cloudflare Agents，也可以看 references/agents-sdk/。

給技能一份有部署輪廓的簡報

當你的提示詞明確寫出以下資訊時，這個技能最有效：

• app 類型：靜態網站、API、worker、全端應用程式或 agent
• repo 結構：框架、建置指令、輸出資料夾、runtime
• Cloudflare 目標：預覽、正式部署、搬遷或初始化設定
• 限制條件：secrets、環境變數、區域、auth、或 CI/CD

更強的輸入像是：「把這個 Next.js app 部署到 Cloudflare Pages，保留 API routes 的運作，找出需要的 env vars，並告訴我應該用 wrangler pages deploy 還是 Git integration 比較好。」

用具體工作流程搭配這個技能

實務上的 cloudflare-deploy usage 流程可以這樣走：

1. 先從決策樹找出對應的 Cloudflare 產品。
2. 用 npx wrangler whoami 檢查 auth。
3. 將你的 app 對應到正確的部署指令或設定。
4. 檢查 env vars、bindings，以及任何產品專屬注意事項。
5. 完成部署，接著驗證 URL 和 runtime 行為。

如果部署過程可能遇到網路限制，記得預留更長的 timeout，或準備升級 sandbox 權限。當部署指令需要直接連線 Cloudflare 時，這一點尤其重要。

cloudflare-deploy 技能 FAQ

cloudflare-deploy 只適用於 Workers 嗎？

不是。這個技能不只涵蓋 Workers，也包括 Cloudflare 的部署選擇，例如 Workers、Pages、Durable Objects、Containers，以及其他平台服務。如果你只是想為單一 wrangler 指令找一個很小的提示，這個技能可能有點超出需求；但如果你需要先選產品再做設定，它會更合適。

我還需要一般的 Cloudflare 文件嗎？

需要，但這個技能可以減少你找對文件的時間。cloudflare-deploy for Deployment 的價值在於，它先幫你選對 Cloudflare 路徑，再去讀正確的參考資料，而不是在整個平台介面裡亂找。

初學者可以用嗎？

可以，只要能描述 app，並接受一個有引導性的流程。初學者最常見的風險，是把目標說得不夠清楚，結果選錯 Cloudflare 產品。如果你不知道該用 Pages 還是 Workers，就直接說明這一點。

什麼情況下不建議使用？

如果你已經知道要用哪個 Cloudflare 產品、具體設定是什麼，而且只需要把某份已知指南裡的指令複製出來，那就不太需要它。若你的部署目標根本不是 Cloudflare，或你要的是一般主機建議而不是 Cloudflare 專屬建議，也不適合用這個技能。

如何改善 cloudflare-deploy 技能

先把部署事實講清楚

最佳結果通常來自包含框架、入口點、建置輸出、環境變數，以及你要預覽還是正式上線的提示。例如：「把這個 Vite app 部署到 Cloudflare Pages，使用 npm run build 建置，輸出 dist，並列出 auth 和 API 呼叫需要的 env vars。」

直接說明你要做哪一類 Cloudflare 工作

當你明確指出工作類型時，cloudflare-deploy skill 的表現會更好：網站託管、edge function、有狀態後端、排程工作，或 agent。這樣可以避免不必要的建議，也能幫技能第一輪就選到正確的 Cloudflare 產品參考資料。

留意常見失敗模式

多數不理想的結果，通常來自 auth 缺失、runtime 需求不清楚，或把 Pages 和 Workers 當成可互換。若部署失敗，先檢查 npx wrangler whoami，確認指令是否對應目標產品，並驗證必要的 bindings 或 secrets 是否真的已設定。

針對第一輪輸出再迭代

如果第一次回答太過泛泛，就改要求更窄的部署計畫：例如 config 檔修改、必要的 secrets、route 設定，或產品比較。更好的迭代方式像是：「現在把它改成 Cloudflare Pages 部署檢查清單」或「現在直接給我精確的 wrangler 步驟和最小設定變更。」