星图工坊

应用改到一半,怎样把需求说清楚

星图工坊更新于

“再优化一下”是很容易发出去的一句话。问题是,这句话可以指字体、布局、功能,也可以指打开速度。你心里想着一个地方,AI 调整的却可能是另一个地方,来回几次就会有点累。

在星图工坊修改应用时,尽量把位置和想看到的结果一起说出来。你不需要知道代码在哪里,只要能描述自己的操作过程,就已经提供了很有用的信息。

拿一个阅读记录应用来说。首页有十几本书,你想尽快找到正在读的那两本。“列表整理一下”和“正在读的书放在最上面,已读完的放到下面,每本书旁边显示状态”,指向的事情就很不一样。

后一种说法也方便验收:改完之后,打开列表看看顺序,再把一本书从“在读”改成“已读”,确认它去了对应的位置。如果没有按预期变化,就有了下一条明确的反馈。

一条需求里,带上这几个信息

可以按“在哪儿、现在怎样、想改成怎样”来写。比如:“首页的添加按钮在列表末尾,书多以后要滑很久。把它放到页面上方,保留现在的添加表单。”

这里还有一句容易被忘掉的话:保留什么。已经满意的颜色、分类和内容,不妨明确说出来。如果这次只想调整按钮位置,就把范围限定在这里。

要改的地方很多时,可以先列出来,再挑最影响使用的一项做。添加记录一直失败,就先处理保存;能保存但找不到记录,再处理排序和筛选。这样每轮结束时,你都比较容易判断有没有进展。

如果把位置、颜色、排序、统计一起改掉,结果不合适时就得重新分辨,到底是哪一处造成的。分开处理虽然多了几轮对话,核对起来通常更清楚。

还有一种情况是需求中途变了。原本按阅读状态分类,后来想按作者分类,这时最好直接说明旧要求不再采用。把当前要保留的规则写完整,后续修改才有统一的依据。

出了问题,先把过程记下来

“保存不了”说明有问题,但还不足以复现。可以补成:“打开新增页面,输入书名和作者,点击保存后回到首页,列表里没有新记录,刷新以后也没有。”

如果有报错提示,尽量保留原文。只有某一本书或某个浏览器会出现问题,也一并写上。条件越接近当时的情况,越方便排查。

截图适合说明页面上的位置,但看不出点击前后发生了什么。所以发图的时候,再加一句操作过程和期待结果。比如:“我点击保存后停在这里,希望保存成功后返回列表,并看到刚添加的书。”

不确定是哪里出了问题,也可以如实描述。没必要为了显得专业,先猜一个技术原因。你实际看到了什么,通常比猜测更值得保留。

修改完成后,用刚才同样的步骤再做一次。这次成功了,也顺便看看相邻的操作:新增能用了,编辑旧记录是否正常;列表顺序改了,切换分类以后是否仍然符合要求。

手机端的问题,最好回到手机上确认。电脑窗口缩窄可以看大致排版,却未必能复现键盘弹出后的遮挡。反馈时写上设备和浏览器,会比只说“移动端有问题”更明确。

如果改到一半发现方向不对,可以先停下来,整理当前还需要解决的两三件事。把已经完成的划掉,把改变的要求重新写清楚,再继续。连续追加很多零散指令,自己回头看也容易漏掉前面的约定。

下次准备发“再优化一下”的时候,可以多写一句:你刚才在哪一步觉得不好用,希望它怎样变化。往往就是这句补充,让一次修改有了明确的落点。

打开我的应用