SuperAPI AI 工具集

tanstack-integration

前端与建站

查看项目

更新于 10-16 03:42

技能介绍

用途:为 TanStack Start、Router、Query 的集成提供有来源依据的指导,优先对齐已安装包源码,其次官方文档,再次随包技能。涉及 API、版本、CLI 或源码时效性时,先读 references/current-authority.md。

主要能力与决策:Start+Router+Query 的 SSR 使用每请求新建的 QueryClient、router context 与 setupRouterSsrQueryIntegration;组件需要 loader 数据时,loader 用 ensureQueryData、组件用 useSuspenseQuery;Convex 实时数据由 Convex 拥有订阅,Query 仅在有意通过适配器/查询归属时使用;鉴权用 Router guards 改善体验,私有数据由 Start/Convex/服务端边界强制。

规则文件:rules/modern-start-app-plan.md 提供 Start+Router+Query SSR 接线骨架与清单;另有 auth-and-data-boundaries、bun-and-tooling、cache-ownership、loader-prefetch、mutation-invalidation、query-client-context、ssr-query-integration、suspense-components。

跨栈注意:Start 中 loader 是同构的,仅服务端工作应放在 server functions、server routes 或 server-only 模块;Convex 应用中响应式查询拥有实时后端状态,除非仓库有意经 @convex-dev/react-query;Clerk 中 Router guards 只改善体验,授权须由服务端函数、路由与 Convex 函数执行;Bun 优先仓库本地用 Bun 命令。

验证:行为对版本敏感时核对已安装包版本与源码;CLI 可用时用 tanstack search-docs ... --json 或 tanstack doc ... --json 查官方文档;实现后运行仓库的 typecheck、路由生成与相关测试;技能维护运行 python3 tools/skill/quick_validate.py skills/tanstack-integration 与 python3 tools/skill/check_tanstack_skills.py --root .。

限制:资料未提供具体版本号、安装命令、收费与平台信息,暂未提供。