用途:在涉及应用状态、数据获取或表单处理的任务中,指导状态架构决策与实现,例如选择状态方案、实现带缓存的数据获取、构建复杂表单、管理跨组件 UI 状态、URL 状态以及从一种状态方案迁移到另一种。触发词包括 state management、TanStack Query、Zustand、React Hook Form、form validation、data fetching、cache invalidation、URL state。
工作流:先做发现,用 discover 检索现有状态库、数据获取与表单写法,用 precision_read 查看 package.json 与示例;再做状态分类,按类型选工具——服务端状态用 TanStack Query,客户端状态用 Zustand,表单用 React Hook Form + Zod,URL 状态用 nuqs 或 searchParams,组件本地状态用 useState,并遵循就近放置原则。
主要能力:提供 Query Client 配置、查询与乐观更新 mutation、缓存失效写法;Zustand 简单 store 与 slice/persist/devtools 模式;Zod schema 校验、字段数组表单;nuqs 与 Next.js searchParams 的 URL 状态同步;用 precision_write 写入文件、precision_exec 做类型检查,并运行 bash scripts/validate-state.sh . 校验。
限制:资料未提供该技能的收费、价格、支持平台或效果数据;示例针对特定版本(TanStack Query v5、nuqs v1.x),实际使用需自行核对环境。反模式提示包括不要把服务端数据放入全局状态、不要手写表单状态、避免用 Context 承载高频变化数据、mutation 后需失效缓存。