简介:AI 编程智能体能一夜产出上万行代码,但事后反馈常靠打字、截图、写复现步骤,低效且易让模型理解跑偏。本文提出“录屏口述 + 多模态解析”方案:一键录屏、边操作边说,由大模型自动整理成带截图、原话与时间点的结构化问题清单,再交给编码智能体逐条修复,五分钟即可讲清五十个问题。文中给出完整技术管线、JSON 结构设计与成本优化经验。
AI 编程智能体(vibe coding 工作流的核心角色)普及之后,“让 Agent 一口气写完几十个页面、几万行代码”已经不是段子,而是许多开发者的日常。真正的问题出现在下一个环节:验收与反馈。
当 AI 一夜奋战产出大量页面后,开发者需要回传大量修改意见。此时的沟通往往极其低效:打字描述、逐张截图、画圈标注、画箭头指示、编写复现步骤,还要交代业务背景、前后逻辑、触发路径……讲清一条问题可能要几分钟,几十条问题就是一场灾难。
更麻烦的是,模型越聪明,“讲不清楚”的代价越高。只要某处描述存在歧义,Agent 在自主执行时就可能直接跑偏,返工成本远高于一次性讲清。
从信息传递的角度看,一条合格的缺陷反馈至少包含五个维度:位置(哪里)、现象(什么表现)、预期(应该是什么)、路径(如何复现)、背景(业务上下文)。用文字加静态截图表达这五个维度,存在三个结构性缺陷:
解法方向非常明确:让开发者以人类最自然的方式表达——录屏口述。具体工作流如下:
以一个演示用的电商结账页走查为例:五分钟的口述录屏可以自动整理出五十余条事项,并自动归类:
每条事项自动附带截图锚点、口述原话和时间点,验收时点开即可对上现场,几乎零转译成本。
整条管线可以拆成六层:
录屏视频 + 音频├── 采集层:屏幕流 + 音频流,时间轴对齐├── 转写层:语音识别 → 带时间戳的字幕序列├── 对齐层:口述段落 ↔ 关键帧 ↔ 鼠标/点击事件├── 理解层:多模态大模型逐段抽取事项├── 整理层:语义去重、类型归类、编号(ISS-001…)└── 交付层:导出 JSON / Markdown,交给编码 Agent 逐条领取
理解层的输出建议用严格的 JSON Schema 约束,示例:
{"id": "ISS-021","type": "bug","title": "切换配送国家后总价未应用优惠券","evidence": {"screenshot": "frames/00-03-12.jpg","quote": "哦对,选了加拿大,总价没减优惠券","timestamp": "00:03:12"},"expected": "总价 $117.10","actual": "总价 $128.40","clue": "src/cart/reducer.ts:88"}
这条 JSON 的价值在于:每一条都有完整证据链——截图证明现场、原话证明意图、时间点证明顺序、预期与实际证明差异,还允许模型顺手给出可疑代码位置。Agent 拿到即可开工,人复核时点开截图即可,形成闭环。
要让模型整理得靠谱,提示词层面有几个关键点:
一个精简的提示词骨架:
你是走查整理助手。输入:视频关键帧序列 + 带时间戳的口述转写。任务:抽取所有事项,按给定 schema 输出 JSON 数组。规则:- type 仅限 bug / idea / todo / note;- 每条必须包含 quote 与 timestamp;- 以画面事实纠正转写错别字;- 语义重复的事项合并,保留最早时间点。
结构化清单天然就是任务队列:
如果要工程化落地,这条管线依赖的都是通用云能力:对象存储(存放录屏与截图)、语音识别(字幕转写)、媒体处理(抽帧与转码)、大模型服务(多模态解析)、函数计算或容器平台(承载编排逻辑)、日志与监控告警(追踪事项处理状态)。以百度智能云为例,上述每一层都有对应的通用产品类目可以组合使用,无需绑定任何专有接口即可复现整条流程。
AI 把“写代码”的成本打了下来,却把“讲清楚要改什么”变成了新瓶颈。录屏口述 + 多模态整理的本质,是用推理成本置换人类的表达成本:开发者只需说话,结构化、去重、归类、定位这些机器擅长的事全部交给模型。当五分钟真的能讲清五十个问题,AI 编程工作流的最后一公里才算真正打通。