圈一下截图就让 Agent 改页面,怎样描述问题才不会改错地方?
采集摘要介绍,scrawl 能将屏幕圈注和录制说明发送给编码代理。试用这类工具时,可以把截图位置、页面状态、复现步骤和不同屏幕大小下的表现一起交代,让每条反馈指向具体改动。
怎么判断?
先把一个圈注对应的问题说完整,再交给 Agent。采集摘要将 scrawl 描述为可以圈注屏幕问题、录制说明并发送给编码代理的工具;这能提供视觉入口,但摘要没有说明它如何找到页面代码。实际反馈应包含所在页面、触发状态、眼前表现与期望结果,避免让代理只凭一张局部截图猜测修改范围。下面是组织反馈的建议,并非该项目已经具备的功能清单。
一个圈注先对应一个明确问题
圈出按钮、标题或卡片后,紧接着写明哪里不对。例如“点开筛选后,确认按钮被底部栏挡住”,比“这里有问题”更容易定位。若同一张图里还有文字换行和图片裁切问题,可以分别编号描述,避免代理把几个症状当成一次整体改版。
保留适量周边内容,让接手者看得出这个元素处在哪个区域;同时清楚标出期待保留的相邻布局。圈注范围只是问题位置,不能自然代表允许重做整个区域。
把截图出现时的页面状态补齐
同一页面可能有不同状态:登录前后、列表有无数据、菜单是否展开,都会影响看到的内容。反馈时写下页面路径和触发顺序,说明是刚进入就出现,还是点击某个操作后才出现。如果录制说明能展示过程,就让它从问题发生前的一步开始。
还可以补一句期望行为,例如“展开菜单后仍能点击确认”。不要只说“改得正常一点”,否则代理即使改了视觉样式,也可能没有处理触发问题的状态。
用相同内容对照不同屏幕大小
遇到手机端挤压、横向溢出或标题遮挡,可以在相同页面状态下,分别保存手机与电脑的画面,并注明窗口大小。重点交代哪种大小正常、哪种大小异常,以及异常从哪里开始。这样更容易把问题限定到布局适配,而不是误改内容本身。
如果只能提供一张图,就明确设备和浏览器,列出尚未检查的屏幕大小。补充材料里的假设应当标出来,不能把没有观察过的其他设备表现当作事实。
修复后回到原圈注的位置对照
重新按原来的步骤打开同一状态,检查被圈出的元素,再看相邻内容有没有受影响。对只在特定窗口大小出现的问题,要回到那个大小复查。这样的记录适合可见的布局和交互问题;数据错误或偶发失败通常还需要相应记录,截图无法独自解释原因。本文未安装或实测 scrawl,摘要也不足以确认它支持哪些系统或怎样传送录制内容。
资料链接
以下为采集记录附带的资料链接;本文依据摘要做独立分析,未逐条核验原文,也不代表本站实测。