用途:该技能用于给出与当前 TanStack Router 一致的、有据可查的实现指导,优先级为已安装包源码、官方 TanStack 文档、随包技能。API、版本、CLI 命令或源码时效性影响任务时,先读 references/current-authority.md。
主要能力与决策要点:新增路由用基于文件的路由,由插件/CLI 生成 routeTree.gen.ts;共享依赖在 createRootRouteWithContext<T>() 中声明类型并传给 createRouter({ context });URL 状态用 validateSearch 校验,用 loaderDeps 作为缓存键;路由数据用 loaders,仅当 TanStack Query 掌握服务端状态缓存时才用 Query;路由拆分优先用插件 autoCodeSplitting: true,.lazy.tsx 作为回退。
规则文件:code-splitting、custom-search-serialization、data-loading、errors-not-found、loader-deps、navigation、root-context、route-generation、search-middleware、search-validation、type-safety。
跨栈注意:TanStack Start 中 loaders 是同构的,仅服务端工作应放在 server functions、server routes 或 server-only 模块后;Convex 应用中响应式查询掌握实时后端状态,除非有意通过 @convex-dev/react-query 路由;Clerk 应用中 Router 守卫只改善体验,授权须由 server functions、server routes 与 Convex functions 强制执行;Bun 优先的仓库本地示例优先用 Bun 命令,引用官方文档时除外。
验证:行为对版本敏感时核对已安装包版本与源码;安装 CLI 后可用 tanstack search-docs ... --json 或 tanstack doc ... --json 查官方文档;实现后运行仓库的类型检查、路由生成与相关测试。技能维护可运行 python3 tools/skill/quick_validate.py skills/tanstack-router 与 python3 tools/skill/check_tanstack_skills.py --root .。具体收费、平台与价格信息暂未提供。