用途:面向使用 React Hook Form 做客户端表单校验的项目,提供按影响优先级排列的性能优化规则,可用于新表单编写、自动化重构与代码生成,也用于审查现有表单的性能问题。
主要能力按优先级分为 8 类:表单配置(formcfg-,关键级,如校验模式、defaultValues、shouldUnregister);字段订阅(sub-,关键级,如用 useWatch 替代 watch、只订阅特定字段、避免在 render 中调用 watch);受控组件(ctrl-,高,如用 useController 实现重渲染隔离、正确连接 UI 库字段属性);校验模式(valid-,高,如把 schema 定义在组件外以缓存 resolver、错误信息访问方式、delayError);字段数组(array-,中高,如以 field.id 作为 key、为操作提供完整默认对象);状态管理(formstate-,中,如解构 formState、用 useFormState 隔离订阅、getFieldState 读取单字段状态);集成模式(integ-,中,如 shadcn 表单导入来源、shadcn Select 的 onValueChange 接线、MUI 的 Controller 用法);高级模式(adv-,低,如 FormProvider 子组件 memo、生产环境关闭 DevTools)。
使用方式:按 references/{prefix}-{slug}.md 阅读各规则参考文件,文件内含详细说明与代码示例;仓库另提供规则模板、分类定义与汇总文档 AGENTS.md。
适用场景:React Hook Form 表单的性能优化与规范落地,尤其涉及复杂校验、动态字段数组和第三方 UI 组件库集成时。
限制:资料未提供具体版本要求、安装命令、许可证、维护状态与效果基准数据,暂未提供;相关技能提及 Zod resolver、React 19 server actions 与前端表单设计,具体内容均需查阅对应技能。