用途:该技能面向 TanStack Start 应用的构建与部署,涵盖 Cloudflare、Netlify、Vercel/Node/Bun、预渲染与环境变量处理;不适用于应用逻辑或与 Start 无关的通用 Vite 配置。
主要能力:覆盖生产环境变量处理、插件顺序(cloudflare() 置于 tanstackStart() 之前)、start 脚本与构建产物的匹配、Bun 部署时对 React 19 的版本固定,以及预渲染限制(动态 $id 路由、布局 _ 路由、无组件的路由除非通过 crawlLinks 链接否则会被跳过)。资料还提到包含各适配器的完整 vite.config.ts 模板、完整的 Cloudflare Workers 部署模板及生产检查清单。
使用方式:Agent 工作流要求在实现前并行调用 fuse-ai-pilot:explore-codebase(读取 vite.config.ts、package.json scripts、现有适配器/wrangler 配置)、fuse-ai-pilot:research-expert(通过 Context7 校验适配器配置)与 mcp__context7__query-docs(确认目标主机的 tanstackStart 插件与适配器选项),实现后运行 fuse-ai-pilot:sniper。构建基于 Vite 或 Rsbuild:多数主机经 Nitro 部署层,Cloudflare 与 Netlify 有专用 Vite 插件。关键规则包括:在处理函数内按请求读取 process.env.X,禁止在模块作用域读取(Cloudflare 在请求时注入环境变量,模块级读取在边缘为 undefined);Nitro 输出以 node .output/server/index.mjs 启动,Cloudflare 使用 wrangler deploy;在 Bun 上部署时将 react/react-dom 固定为 >= 19。
适用场景:按目标选择 Cloudflare Workers(@cloudflare/vite-plugin 配合 wrangler.jsonc)、Netlify(@netlify/vite-plugin-tanstack-start)、Vercel/Render/Node/Docker/Bun/Railway(Nitro 层)或静态(tanstackStart 的 prerender 配置)。建议预渲染营销与博客路由,动态与鉴权路由保持 SSR。
限制:不覆盖应用数据/鉴权逻辑(参见 start-routing-data / start-auth)。具体价格、平台可用性等资料暂未提供。