让编程智能体照着仓库里的表单写
让智能体新增 React 表单时,提供同类表单作为参考,并指出项目已有的表单库、校验逻辑和错误组件。这样可以沿用统一的错误提示、无障碍属性和提交策略。
AI 深度解读
让 AI 给设置页加一个「编辑显示名称」表单,它可能交出 4 个 useState、一个手写的 errors 对象,以及一个和现有提交按钮行为不一致的 disabled={loading}。功能看起来做完了,字段样式、错误播报和重复提交的处理却都可能跟隔壁设置项不一样。
作者的做法是给 Agent 一份仓库里同类表单的真实实现,让它沿用表单库、字段组件和校验逻辑。对前端开发者来说,这篇最能直接用上的东西,是一段可以改成自家仓库版本的提示词,以及几个能在 diff 里快速定位的审查信号。
为什么一个小表单会变成一次重写?
教程常从 useState 起步,Agent 沿用这个写法,连旁边的文件都不用打开。但要接入 React Hook Form(RHF),它得先看懂项目怎么用 resolver 接入校验、用什么组件渲染字段,以及在哪里设置 aria-invalid。如果仓库用的是 Formik 或设计系统的 useForm,同样要先搞清项目自己的约定。
这些约定影响的不只是写法。手写的错误 <span> 如果没和输入框关联,辅助技术就可能在用户操作该字段时漏掉错误提示。自定义 onSubmit 如果漏掉共享 hook 里的防重复提交逻辑,按钮的 disabled={loading} 也未必能复现原来的行为。表单库和共享组件还统一了字段何时标记为已交互(touched)、提交失败怎么显示。作者因此把这类从零手写的改动按重写看待。
给 Agent 看哪一份表单?
找同类页面里的真实实现。新增设置项就找设置行,弹窗就找现有弹窗,多步向导就找相邻步骤。如果需求只是在现有表单加一个复选框,直接修改负责提交这份数据的表单,让新字段走同一套提交逻辑。
下面这段提示词把参考文件、要复用的组件和客户端校验方式一起交代给 Agent。
This repo uses React Hook Form (see src/components/forms/SettingsRow.tsx and src/lib/form.ts).
Build this form the same way: useForm, the shared Field component, and the shared error message.
Do not introduce a new useState-per-field form, and do not add Formik or another library.
Client validation should reuse the existing helper. Do not invent a new errors object.
第一行最值得保留的是两个文件路径。只写「用 React Hook Form」,Agent 仍然可能照着通用示例自己接一套。作者还建议把真实表单贴进上下文,让 Agent 能直接看到字段、错误消息和提交按钮怎么配合。
我的判断
这篇给的是实践经验。作者描述了他遇到的改动和现在采用的审查标准,没有给出对照实验、返工耗时或缺陷数据。它能帮团队识别容易漏的行为,至于给 Agent 一个范例能少返工多少,原文没有回答。
我会把 useState( 当成定位线索。用它控制弹窗开关很正常,真正要追的是 onChange 更新的值是否已经由表单库管理。同一个字段有两份状态,改值、重置和校验就都得考虑同步。相比只在提示词里写「遵循仓库风格」,给一份同类实现更具体,前提是那份实现确实代表团队现在的做法。作者也留了一个例外:在表单库覆盖不到的非 SPA 页面,原生非受控表单可以成立,在 PR 里交代范围即可。
能拿来做什么
- 给 Agent 派表单任务时,附一个同类表单和共享校验文件,让它按现有写法接入
useForm、Field和错误消息组件。 - 只新增一个复选框时,在任务里点明由哪个表单提交这个字段,验收时确认它走原有的校验和提交路径。
- 审查表单 PR 时,在 diff 里搜
useState(和onChange,在package.json里确认有没有新增第二套表单库,再核对错误提示是否关联输入框、连续提交时是否沿用现有处理。