本技能用于按当前、有来源依据的方式给出 TanStack 使用建议。回答优先级为：已安装包源码第一，TanStack 官方文档第二，随包附带的技能第三。当 API、版本、CLI 命令或源码时效性对任务有实质影响时，读取 references/current-authority.md。
用途与决策：需要服务端状态缓存时，使用 Query，配合稳定的 queryOptions 与层级化键。需要 Convex 实时订阅时，让 Convex 负责实时状态，除非有意使用 Convex Query 适配器，否则不要重复放入 Query。需要路由预取时，在 loader 与组件中使用同一份 queryOptions。需要变更 UI 时，按范围选择失效、乐观缓存更新或 UI 级乐观变量。
规则文件包含：rules/loading-states.md（首次加载、后台刷新、Suspense、待处理 UI 归属）、rules/mutations.md（useMutation、生命周期回调、共享待处理 UI、副作用位置）、rules/cache-defaults.md、rules/disabling-queries.md、rules/error-boundaries.md、rules/eslint.md、rules/infinite-queries.md、rules/invalidation.md、rules/key-factories.md、rules/optimistic-updates.md、rules/query-keys.md、rules/query-options.md、rules/ssr-hydration.md。
跨栈注意：TanStack Start 中 loader 是同构的，仅服务端工作应放在 server functions、server routes 或仅服务端模块后；Convex 应用中 Convex 响应式查询拥有实时后端状态，除非仓库有意经 @convex-dev/react-query 路由；Clerk 应用中路由守卫仅改善体验，授权仍须由 server functions、server routes 与 Convex functions 强制；Bun 优先仓库中本地工作流示例优先用 Bun 命令，引用官方文档时除外。
验证：行为对版本敏感时，核对已安装包精确版本与源码；安装 CLI 时可用 tanstack search-docs ... --json 或 tanstack doc ... --json 查官方文档；实施后运行仓库的类型检查、路由生成与相关测试。技能维护可在 dev-skills 运行 python3 tools/skill/quick_validate.py skills/tanstack-query 与 python3 tools/skill/check_tanstack_skills.py --root .。安装与价格信息暂未提供。