本技能用于 React 表单处理，采用 React Hook Form + Zod 作为标准技术栈，强调 schema 与 UI 行为保持一致。
适用场景：构建带校验的新表单；重构不稳定的表单状态逻辑；实现多步骤、动态或异步校验表单。
核心约定：以 Zod schema 为唯一数据源；使用由 schema 推断出的类型化表单值；在客户端与服务端边界均做校验；字段渲染与提交副作用分离；显式维护表单的加载与错误状态。
实现流程：基础表单先创建 Zod schema，再推断 TypeScript 类型，用 resolver 与默认值初始化 RHF，并在字段级和表单级渲染错误。进阶模式包括：多步骤表单为每步单独定义 schema、聚合类型化数据、显式处理前进/后退；动态数组使用 useFieldArray，保证稳定 key 与可预期的增删行为；异步校验对开销大的校验器做防抖，并将网络错误与同步 schema 错误隔离；文件上传在提交前校验类型与大小，显式管理上传状态与重试逻辑。服务端集成时，将服务端错误规范化为 RHF 兼容结构，可选且可回滚地使用乐观 UI，对 server actions 保持幂等提交行为。
UX 与无障碍清单：所有输入支持键盘导航；错误信息具体并关联到字段；提交按钮状态反映进行中的操作；成功与失败反馈可见且确定。
Agent 输出要求：schema 设计、表单状态模型、校验与提交流程、错误处理与无障碍检查。
参考：详细代码模板（基础、shadcn、多步骤、数组、上传）见 references/guide.md。其他细节暂未提供。