cloudflare-deploy

cloudflare-deploy 技能概览

cloudflare-deploy 的作用

cloudflare-deploy 技能可以帮助你在 Cloudflare 上部署应用和平台服务，减少像通用提示词那样靠猜的成分。它的目标，是把“把这个应用发到 Cloudflare 上”这类粗略目标，落成一条具体可执行的部署路径，涵盖 Workers、Pages、Durable Objects 以及相关 Cloudflare 产品。

适合谁使用

如果你需要 Cloudflare 专属的部署指导，就应该用 cloudflare-deploy skill，尤其是在问题不只是“运行 wrangler deploy”的时候，而是“这个应用应该由哪个 Cloudflare 产品来承载？”这种场景。对于正在迁移现有应用、添加边缘逻辑，或者在 Workers 和 Pages 之间做选择的构建者来说，它特别合适。

它为什么有用

这个仓库围绕决策树和产品级参考资料来组织，所以这个技能更擅长帮你选对路线并补足实现细节，而不是给你一段放之四海而皆准的部署提示词。尤其当真正的阻碍不是代码生成，而是在部署前先选对 Cloudflare 目标、认证路径或 service binding 时，它的价值会更明显。

如何使用 cloudflare-deploy 技能

安装并验证技能

使用 cloudflare-deploy install 流程，并执行目录中的标准命令：
npx skills add openai/skills --skill cloudflare-deploy

安装后，确认技能能够读取仓库上下文，并且你已经准备好 Cloudflare 认证信息。cloudflare-deploy usage 流程默认假设 wrangler 可用，而且你可以在部署前检查身份。

先从正确的源文件入手

如果想快速进入 cloudflare-deploy guide，先读 SKILL.md，再检查与你目标路径最相关、决策信息最密集的参考资料。好的起点包括 references/wrangler/auth.md、references/pages/、references/workers/ 这类产品参考文件，以及如果你的部署涉及 Cloudflare Agents，则查看 references/agents-sdk/。

给技能一份“像部署任务”的简报

这个技能在以下信息明确时效果最好：

• 应用类型：静态站点、API、worker、全栈应用或 agent
• 仓库形态：框架、构建命令、输出目录、运行时
• Cloudflare 目标：预览、正式发布、迁移或初始化
• 约束条件：secrets、环境变量、地区、认证或 CI/CD

更好的输入示例是： “把这个 Next.js 应用部署到 Cloudflare Pages，保持 API routes 可用，识别所需的 env vars，并告诉我应该用 wrangler pages deploy 还是 Git 集成更合适。”

按照具体工作流使用技能

一个实用的 cloudflare-deploy usage 流程通常是：

1. 通过决策树找出对应的 Cloudflare 产品。
2. 用 npx wrangler whoami 检查认证状态。
3. 将你的应用匹配到正确的部署命令或配置。
4. 检查 env vars、bindings，以及任何产品特有的注意事项。
5. 执行部署，然后验证 URL 和运行时表现。

如果部署可能涉及网络限制，就要提前预留更长的超时时间，或者申请更高权限的 sandbox。尤其是在部署命令需要实时访问 Cloudflare 时，这一点非常关键。

cloudflare-deploy 技能 FAQ

cloudflare-deploy 只适用于 Workers 吗？

不是。这个技能覆盖的不只是 Workers，而是 Cloudflare 上一整套部署选择，包括 Workers、Pages、Durable Objects、Containers 以及其他平台服务。如果你只需要一条 wrangler 命令的简短提示，这个技能可能有点大材小用；但如果你需要先选产品，再做配置，它就更合适。

我还需要看普通的 Cloudflare 文档吗？

需要，但这个技能能帮你少花很多时间去找对的文档。cloudflare-deploy for Deployment 的价值在于，它先帮你选对 Cloudflare 路径，再让你去读正确的参考资料，而不是在整个 Cloudflare 平台表面上漫无目的地翻找。

新手能用吗？

可以，只要能把应用说明清楚，并接受一个带引导的工作流。新手最大的风险是把目标说得太模糊，最后选错 Cloudflare 产品。如果你自己也不确定需要 Pages 还是 Workers，就直接说出来。

什么情况下不该用它？

如果你已经明确知道要用哪个 Cloudflare 产品、具体配置是什么，而且只是想复制一条来自已知指南的命令，那就没必要用它。如果你的部署目标根本不是 Cloudflare，或者你想要的是通用托管建议而不是 Cloudflare 专属建议，它也不合适。

如何改进 cloudflare-deploy 技能

一开始就给出部署事实

最好的结果来自这样的提示词：把框架、入口点、构建产物、环境变量，以及你要预览还是正式发布都写清楚。比如： “把一个 Vite 应用部署到 Cloudflare Pages，使用 npm run build 构建，输出 dist，并列出认证和 API 调用需要的所有 env vars。”

说清楚你要做哪类 Cloudflare 工作

当你明确说明工作类别时，cloudflare-deploy skill 的表现会更好：Web 应用托管、边缘函数、有状态后端、定时任务，或者 agent。这样可以避免无效推荐，也能帮助技能在第一轮就选对 Cloudflare 产品参考资料。

注意常见失败模式

大多数失败都来自认证缺失、运行时要求不清楚，或者把 Pages 和 Workers 当成可以互换的东西。如果部署失败，先检查 npx wrangler whoami，确认命令是否与目标产品匹配，再核实必需的 bindings 或 secrets 是否真的已经配置好。

对第一版输出继续迭代

如果第一次回答太泛，就要求它给出更窄的部署方案：比如只改配置文件、列出必需的 secrets、补充路由设置，或者做产品对比。更好的迭代方式是： “现在把它改成一份 Cloudflare Pages 部署检查清单” 或者 “现在给我精确的 wrangler 步骤和最小配置改动。”