用 AI 辅助写代码:把需求变成可以验证的小改动
从一个待办列表需求出发,记录如何补全需求、组织上下文、验证模型建议,并把有效做法留在项目里。
文章目录
从一条真实的使用路径写起
假设你有一个可以在浏览器里运行的个人待办清单。点击勾选框后,事项会显示为完成,但刷新或重新打开页面,完成状态就消失了。很自然的提问是“帮我加一个保存功能”。同一个词却可以指很多事情:把整个清单保存到浏览器,在手机和电脑间同步,保存手工修改过的标题,或者只记住已经完成的事项。模型通常能给出一份看起来齐全的代码,但如果它选中了你没有考虑过的含义,改动越齐全,你要返的工就越多。
可以先写一段任何人都能照着复现的描述:“打开清单,勾选已有的‘整理资料’,刷新后希望它仍然勾选。新增事项和清单排序沿用原先的行为。此轮只关心同一浏览器内的刷新。”第一句给了入口、动作和观察结果。第二句约束已有行为,防止模型顺手把一次状态修复做成重构。第三句说明需求的边界。短短三句已经足以导出至少两个独立的检查,其中一个负责验证新增功能,另一个负责确认原先的使用路径依然可用。
遇到涉及时间、地区、人员权限或数据范围的需求,可以沿用这个写法。把“支持日期”写成“输入本地日期后,按同一天筛选,刷新后仍保留所选条件”。把“表格更好用”写成“键盘按下回车后保存当前单元格并跳到下一行,按退出键放弃本次修改”。这些句子描述的是可以操作的动作和可以看到的结果,有利于模型理解,也给自己保留了判断依据。
先让解释在项目里落到具体位置
把整个项目丢进会话会省掉初次挑选文件的时间,但也会把无关组件、过期示例和第三方代码混进来。可以先查看目录中最直接的一两个文件,找到列表渲染和勾选处理函数,再把这两处及其直接调用者交给模型。补上运行环境和启动方式,尤其是浏览器是否直接加载静态文件、项目是否有构建步骤。很多看似合理的答案默认了某个框架或包管理器,这些假设在几十行的静态网页中也会产生额外包袱。
第一轮可以问:“根据这些文件说明状态从哪里产生,点击后经过哪一个处理函数,刷新时从哪里取得初始值。每一步附上能定位的变量或函数名。材料不够时指出需要哪个文件。”读回解释时,依次核对它提到的三个地方。一个变量也许叫作完成事项,但实际用于当前筛选。一个函数也许名为加载列表,但只请求远端数据而没有负责首次渲染。命名能提供线索,数据如何流动仍需读实现或做一次运行观察。
如果会话里已存在真实的账户资料、访问配置、私人待办内容或运行日志,摘取与问题有关的部分即可。为了帮助模型理解记录结构,可以给出一条小型示例,保留键名、数据类型和有意义的空值,把真实内容换成自造的值。示例有时比一屏日志还清楚。若问题只发生在长标题、重复标题或特定字符上,示例应保留那个触发条件,从而同时服务解释和验证。
让改动对应数据的生命周期
为浏览器保存完成状态,先想清楚数据什么时候被读、什么时候被写。初次渲染前读取已经保存的状态,用户切换时更新当前列表并写回,下一次打开时再读取。这个顺序听起来平常,却能揪出不少实现错误。例如,若程序先把默认状态显示出来,再异步读取以前的记录,勾选框可能在加载过程中跳动。若程序在应用启动时无条件写一遍默认值,再去读存储,旧状态可能已经被覆盖。每一个操作都需要一个明确的触发点。
再看键和值。清单里可能有两条都叫“发邮件”的事项。拿标题当键会导致两条记录一起改变,改标题还会丢失原状态。如果已有稳定标识,优先沿用它,并检查标识如何产生。新建时生成一次比每次渲染重新生成更适合持久化。如果示例只有三条硬编码的默认项目,也可以为默认项目分配明确而恒定的标识。这样做既容易人工验证,也为之后插入一条新的默认事项留出了空间。
第三个问题是首次打开和读取失败分别如何处理。没有保存记录时回到清单默认值。读到合法数据时,根据现有记录恢复。读到无法解释的内容时,页面仍应该能够展示并处理勾选。至于何时替换那份旧内容,需要结合实际需求:当用户明确进行了新的修改时再保存,比页面每次打开就覆盖更容易解释。不同环境还可能不允许写入网页存储,临时浏览环境与拦截配置都可能影响它。将写失败限制在保存动作内,可以避免勾选操作因此报错退出。
实际准备让模型给出代码前,可以请它列出预计修改的文件和新增的状态字段。阅读列表时决定是否接受新增依赖、是否沿用既有工具函数、是否需要解释旧版本数据如何读取。一份集中在初始化和切换处理的小改动,通常比同时移动组件、重命名文件、换样式更便于核对。修改范围应与这一次的使用路径相匹配。
让测试从操作细节长出来
先把编写需求时那条最短路走一遍。刷新前勾选了什么,刷新后看到了什么。然后把同一项重新取消并再次刷新。后者容易漏掉,它能区分“只追加完成记录”和“确实支持来回切换”。分别点击两条同名事项能验证是否绑定稳定标识。再加一条无关事项,确认列表顺序与添加体验符合此前行为。浏览器的开发者工具还能显示存储内容,让你看到状态更新发生在操作之后以及保存内容的形状。
用少量样本覆盖三个层次
可以把检查安排成纯数据、页面交互、跨刷新三层。纯数据层只知道列表和完成标识,检查空列表、缺失记录、重复标题、旧标识,以及新加入的事项。页面交互层通过真实控件操作,发出和用户一样的点击或键盘事件,再观察勾选值和视觉状态。跨刷新层用同一个浏览器上下文重新打开页面,确认加载流程确实读到了上一轮留下的数据。若只测纯函数,数据格式即使正确,也可能根本没有接到页面初始化上。
示例项目如果没有自动测试,先把手工观察的输入和结果写下来就有价值。能用现成测试工具时,也可以把最关键的回归条件固定成一条自动检查。请模型生成测试后,再问一遍:“如果恢复成原来的代码,这条测试会在哪里失败?”有些测试模拟了过多内部函数,结果是没有使用实际的保存逻辑。复现旧行为失败、应用修改后成功,是检查测试敏感性的直接办法。也可以故意变更一处关键条件,观察测试是否真的能区分预期与异常,然后撤销那处临时改动。
处理读写失败时,人工和自动检查可以配合。手工可在本地测试资料中放入无法解析的内容再刷新,观察页面是否产生白屏。自动检查可以让保存方法返回失败,断言当前交互仍完成。只有目标环境中确实存在隐私设置限制或受限嵌入场景时,再增加对应浏览器的人工核对,避免把时间耗在与使用者无关的环境上。
看到一段建议,就问谁负责这一步
阅读模型给的代码时,可以顺着五个问题走:输入由谁提供,解析发生在哪里,内存状态何时更新,哪一步写到本地,以及异常怎样传回来。拿上面的清单来说,渲染时应能依照当前事项和已有状态构造勾选框。点击以后,由一个已有的事件入口更新状态。成功保存或暂时无法保存,都能在入口附近说清楚最终状态。若模型把同一功能塞到多个事件回调和渲染分支,处理顺序往往变得难以追踪。
异步操作尤其值得沿执行路径检查。一个常见情形是连续点两次,第一次点击发起的异步请求比第二次更慢,后续回执把较早的状态重新写了回来。只使用浏览器同步存储的小清单通常无需引入复杂的排队机制。如果以后为了延迟写入或同步到服务器而改变保存方式,旧实现的“最后一次操作生效”需要重新验证。可以保留同一条快速连点的交互检查,并记录哪个时刻发出、哪个时刻返回和哪一步改变了页面内容。
还要核对生成的名字和依赖是否真的存在。模型有时会从另一个版本的组件库借来函数名,或者在本应运行于浏览器的代码中使用服务端专有方法。看依赖文件与现有调用、实际运行页面,比问模型“你确定吗”更可靠。读不懂的一段代码,可以要求它拿同一条事项举例,逐条解释数据如何变化,然后对照调试器或日志验证。这里的目标是弄明白下次出现问题时该从哪里开始看。
把来回沟通变成可以重放的记录
有的对话会从“先说方案”跳到“直接写代码”,接着再聊视觉样式,十几轮以后连项目现状也说不准。可以在一轮验证完成时留一段很短的记录,含四项内容:需求,发生修改的位置,观察到的结果,以及尚未确认的情况。示例可以写成:“任务清单在本浏览器刷新后保持勾选。初始化从存储读取,点击切换时立即尝试写入。首次打开、重复标题、取消并刷新已经检查。受限浏览环境下仍待实机观察。”下次开始时把这段记录和当前文件一起带进去,比凭会话回忆更稳妥。
记录中可以保留一次错误尝试,前提是它能给未来一个明确的提示。比如“按标题绑定导致重名事项同时切换,现改用原有标识”。这种句子解释了设计取舍,避免下一次重构因为标题看起来更直观就换回去。还可以在需求中写明何时愿意扩展范围,例如“只有跨设备使用成为实际需求时再讨论统一存储”。它提供了判断时点,使后续工作从真实负担出发。
提交前,把本次修改与原先可运行的版本比较,阅读新增字段、配置与资源文件的差别。若会话生成了很多临时脚手架,逐个判断哪些是交付的一部分。回到最初定义的操作流程,做一次独立复核。自己可以闭上对话窗口,仅用项目目录和记录开始验证,当两个入口都能解释同一处改动时,后续维护也有了落脚点。测试结果要说明实际运行了什么,看到什么,以及未覆盖的是哪个环境或操作。
两个适合练习的小任务
可以拿一个熟悉的小程序重复这套流程。第一个题目是保留阅读筛选项。先写明页面载入时选择器该展示什么,地址栏有没有现成的输入,以及当两处同时保存一个值时谁优先。把初次访问、主动切换、带参数进入和清空筛选四条操作写下来,然后比较模型提出的两种方案需要哪几处代码。只选择与现有入口更贴合的方案,并说明你放弃了哪个状态来源,为什么两个来源会使维护变难。
第二个题目是给一个文本导入框增添错误提示。准备一组最小输入:有效文本、空文本、混合空白行和一行无法解释的内容。先决定每类输入会得到什么页面反馈,再请模型拆出解析和显示两个阶段。让它用同一条输入追踪具体执行路径,然后手工走一遍。若你还可以调整一个字段定义,试着判断对应哪些样本要修改预期,哪些原先的交互仍应成立。这个练习能够看到代码形状、规则和测试之间的关联。
人工复核并不要求你在模型开口之前就知道全部答案。你可以同时请它解释浏览器在背后做了什么、指出代码接入的位置,并建议一条测量办法。时间充裕时,选择一个边界条件自己构造例子再去询问它。时间有限时,先做主要路径和最容易悄悄出错的路径。比如个人清单的关键异常是旧状态丢失,那么先抓住刷新与重复记录,其次才轮到代码如何拆文件。
一轮协作可以在当前操作可重放时结束。打开页面,勾选,刷新,取消,再刷新,每一步都知道应该看到什么。模型的解释和代码各自有了验证位置。以后新增提醒、筛选或编辑功能,也能用同一套做法逐步扩展。每一次约束清楚的小改动都会让下一次更容易,因为项目里已有一段可以信赖的行为作为基线。