技能介绍

为什么要关注 Worker 脚手架

Cloudflare Worker 开发常卡在几个高频坑里：export default { fetch: app.fetch } 会触发 Cannot read properties of undefined，SPA 静态资源回退会把 /api/* 请求拦截成 index.html，Wrangler 4.45+ 首次部署前没显式指定绑定名称导致资源名随机，Vite 配置漏设 main 字段让开发服务器找不到入口。手动搭一套含 Hono 路由、Vite 调试和静态资源回退的壳子，往往要反复对照官方文档踩坑。

技能如何帮你搭好 Worker 外壳

它会以「Worker 脚手架工程师」角色接手，按四步走：

理清需求：先问应用是纯 API、SPA+API 还是落地页，数据存储选 D1/R2/KV 还是无，要不要鉴权框架，用自定义域名还是 workers.dev 子域——一句「带 D1 的待办应用」就能开工。
搭建项目骨架：用 npm create cloudflare@latest 生成 TypeScript 骨架，再定制 wrangler.jsonc、vite.config.ts、src/index.ts（含 Hono 路由和静态资源回退）等文件，装好 hono、@cloudflare/vite-plugin 等依赖。
按需配绑定：在 wrangler.jsonc 加 d1_databases、r2_buckets、kv_namespaces 绑定，静态资源用 assets 配 directory、binding 和 not_found_handling: single-page-application。
跑通调试与部署：npm run dev 本地起服务（http://localhost:8787），wrangler deploy 推生产。

关键模式里还标注了正确导出语法（export default app）、SPA 回退要加 run_worker_first: ["/api/*"]、Vite 要导入 @cloudflare/vite-plugin 的 cloudflare 方法等细节，避免你重复踩坑。

适用边界要记清

它产出的是可部署的 Worker 外壳，不会帮你写业务逻辑——需要全栈模板（含鉴权、数据库迁移等）得用 vite-flare-starter；定时任务要切到显式 export default { fetch: app.fetch, scheduled: ... } 形式，别用默认的 export default app。