研究想法

可审查的 Flutter 生成工作流

日 · 2026-07-01 · Cross Platform

这个案例给为 ADK agent 构建 Flutter 客户端的团队提供了一个实用模式:让编码 agent 在写代码前创建可审查的接口、用法、架构和设计文件,再把每次失败运行的修复写入可复用技能。最明确的构建目标是一个小型 ADK Flutter 客户端工作流,并带有生成后检查,覆盖平台权限、markdown、流式事件、Web 网络和工具调用显示。

3 个想法

为 ADK 客户端生成 Flutter 代码前使用分阶段规划文件

为 ADK agent 构建 Flutter 客户端的团队,可以要求编码 agent 在编写 UI 代码前先产出四个可审查文件:AGENT_INTERFACE_NOTES.mdFRONTEND_USAGE_NOTES.mdFRONTEND_ARCHITECTURE_NOTES.mdFRONTEND_DESIGN_NOTES.md。这样开发者能在修改成本还低时,检查后端接口、预期用户行为、状态模型和视觉方案。

有用的采用方式是在编码 agent 工作流中加入一道关卡。agent 读取 ADK 代码库,起草这些笔记,暂停等待审查,然后才生成 Flutter 应用。一个低成本测试方法是:把该工作流用于两个已有但没有前端的 ADK agent,检查这些笔记是否在生成代码前正确识别流式行为、API、工具调用和所需客户端状态。

针对 ADK Flutter 客户端故障模式的生成后检查

面向 ADK agent 的可复用 Flutter 前端技能,应包含一份生成后检查清单,针对应用在真实目标平台运行时出现的故障。清单可以覆盖 macOS 和 iOS 网络权限、使用 flutter_markdown 渲染 markdown、lint 和格式化规则、sealed 消息类型、聊天自动滚动、用于 Web 构建的 package:http 网络代码、部分流式事件聚合,以及工具调用显示。

这是生成式客户端的一层具体支持。编码 agent 可以运行格式化和 lint 检查,扫描面向 Web 的网络代码中是否有 dart:io,验证 entitlements,并加入一个小型流式事件测试:先组装 ADK 的部分事件,再把完成的消息加入会话列表。这些检查针对的是单次代码生成可能漏掉的错误。

把人工 Flutter 修复转成技能更新的审查循环

在不熟悉的 ADK 后端上使用编码 agent 的开发者,可以为可复用技能保留一个单独的审查循环。一个 agent 运行当前工作流并生成产物。第二个对话和开发者一起审查这些产物,记录缺口,并更新技能。更新后,删除生成的前端,再次运行工作流。

当开发者阅读生成的笔记和源文件、运行应用,并直接修复重复出现的故障时,这个流程效果最好。下一条提示会询问 Antigravity 如何把这些修复写入技能,让下一次生成的客户端从新学到的规则开始。这个工作流适合需要在 agent 会话结束后仍能解释和维护生成代码的团队。