技能介绍

要解决的具体问题

在 Cloudflare Workers 上构建生产级 SSR 全栈应用时，开发者常面临三个痛点：一是 TanStack Start、Vite、Wrangler、Drizzle 和 better-auth 的多层配置容易出错，比如 vite.config.ts 中 Cloudflare 插件必须放在首位，否则服务入口无法正确识别；二是传统模板克隆或脚手架命令会预设项目结构，难以满足从零生成、逐文件定制的需求；三是部署前需要手动串联数据库迁移、鉴权回调、生产 URL 更新等多个环节，稍有疏漏就会导致构建失败或运行时错误。

技能如何工作

该技能以「全栈生成工程师」角色运行，分五步完成应用搭建：

初始化项目：创建目录并生成 vite.config.ts（Cloudflare 插件优先，依次叠加 Tailwind、TanStack Start、React 插件）、wrangler.jsonc（指定 Nitro 服务入口 @tanstack/react-start/server-entry，配置 nodejs_compat 与 D1 数据库迁移目录）、tsconfig.json（ES2022 目标、路径别名、Workers 类型）等核心配置文件，同时用 openssl 生成 BETTER_AUTH_SECRET 写入 .dev.vars。
生成源码：按文件树逐文件输出应用代码，包括根布局 __root.tsx、鉴权重定向路由 index.tsx、登录注册页、鉴权守卫布局 _authed.tsx 及其下的仪表盘和条目页、better-auth 捕获端点 api/auth/$、shadcn/ui 组件、数据库 schema 与服务函数等。
配置鉴权与迁移：在 lib/auth.server.ts 中集成 Google OAuth 和邮箱密码鉴权，在 src/db/schema.ts 中定义 D1 表结构，生成并应用本地和远程数据库迁移。
本地验证与部署：通过 pnpm dev 验证开发环境，pnpm build && wrangler deploy 部署到生产环境，最后更新 Google OAuth 回调地址和 BETTER_AUTH_URL 为生产 URL。

适用边界与注意点

不适用于想直接拉取「电池全配」模板的场景，技能逐文件生成代码，部署前需自行跑通所有流程。
需要明确项目名（kebab-case）、鉴权方式（Google OAuth / 邮箱密码 / 两者）、Cloudflare 账户等核心信息，缺少必填项时技能会分步索要。
生成的 routeTree.gen.ts 需由 TanStack Start 自动生成，开发者需确保构建时该文件存在。
若改用 Hono 路由，可将输出的 TanStackArtifact 交给下游技能处理，但需注意本技能不直接生成 Hono 路由代码。