用途:在已采用 React + TypeScript + Next.js、React Hook Form + Zod、React Query 或 Connect Query、以及 Proto 生成 API 类型的代码库中,实现和评审前端功能。若项目本地约定不同,应保留既有标准,只应用可迁移的原则。
主要能力与工作流:编辑前先划定归属边界——组件只负责渲染,获取、映射与业务规则放在 hooks 中;服务端状态放查询缓存,表单状态放 RHF,纯 UI 状态用 useState。实现时保持严格类型与显式映射,避免 any、as any 和忽略指令,用 mapper 把 API 模型映射为 UI 模型而非强制转换。完成前验证可靠性与体验:覆盖加载、错误、空状态;异步可能竞态时加入取消与清理;保留键盘可访问性与焦点行为。
不可妥协的检查:移除重复状态与 useEffect 同步循环;API 调用和业务逻辑不得进入渲染组件;只失效或更新受影响的查询键;仅使用可回滚的安全乐观更新;清除 console.*、debugger、死代码和未使用导入。
栈护栏:使用 RHF + Zod 时用 createZodResolver,避免 zodResolver(schema as any);使用 RHF 时不要把整个表单对象放进依赖数组;使用 Proto 契约时把 Proto 到 UI 的转换放在专用 mapper 文件(如 utils/proto-mappers.ts)。
参考:react-patterns.md 涵盖表单、hooks、状态归属、查询用法与可访问性;typescript-patterns.md 涵盖类型卫生、Proto 类型与代码组织。
限制:资料未提供安装命令、收费、平台支持或具体版本要求,暂未提供。