用途:为 TanStack Start 全栈 React 应用提供与已安装包源码一致的实现指导。
主要能力:覆盖服务器函数与服务端路由、中间件、SSR(含选择性 SSR)、鉴权边界、输入校验、错误处理、执行模型、文件组织与部署等主题。
使用方式:优先依据已安装包源码,其次官方 TanStack 文档,再次包内附带的技能。当 API、版本、CLI 命令或源码时效性影响任务时,先阅读 references/current-authority.md。按决策树判断:需要数据库、密钥、文件系统或私有 API 时,用服务器函数或服务端路由,不要直接放进 loader;需要同源应用 RPC 时用 createServerFn(...).validator(...).handler(...);需要公开或跨域 HTTP 时用 Start 服务端路由,通过 route server.handlers 实现;需要鉴权时在服务器函数、服务端路由或中间件中强制校验,beforeLoad 仅用于 UX;需判断代码运行位置时,先读 rules/execution-model.md 再设计 loader。规则文件包括 auth-boundaries、deployment、error-handling、execution-model、file-organization、input-validation、middleware、selective-ssr、server-functions、server-routes。
限制:loader 在同构环境运行,仅服务端的工作必须放在服务器函数、服务端路由或仅服务端模块后;Clerk 应用中 Router 守卫只改善 UX,鉴权须在服务器函数、服务端路由和 Convex 函数中强制;Convex 应用默认由响应式查询持有实时后端状态,除非仓库有意通过 @convex-dev/react-query 路由。验证方式:版本敏感时检查已安装包版本与源码,CLI 可用时用 tanstack search-docs ... --json 或 tanstack doc ... --json 查官方文档,实现后运行仓库的类型检查、路由生成和相关测试。技能维护可运行 python3 tools/skill/quick_validate.py skills/tanstack-start 与 python3 tools/skill/check_tanstack_skills.py --root .。