让编程代理复用项目已有通知组件
文章建议明确向编程代理提供现有 toast 工具,避免新增缺少关闭、排队和无障碍支持的页面提示。字段错误保留在字段旁,页面级结果走共享通知,新变体则在公共组件中实现。
AI 深度解读
AI 给「保存成功」加了一块绿色提示条,界面看起来完成了,代码却可能绕开了项目已有的通知机制。原文讨论的就是这种小而常见的偏差:仓库明明有 toast.success(),模型仍在页面里重新造一个 alert。
作者的主张很明确:页面级成功和失败反馈应复用现有 helper。这件事值得看,因为判断 AI 代码是否完成,不能只看提示有没有显示,还要看它有没有接上应用已有的交互约定。
多一个提示条,为什么会成为问题
原文里的 PR 在页面组件中加入了固定定位的绿色 <div role="alert">Saved</div>。它位于页头下方,一直不消失,也没有接入现有通知管理机制。
而仓库的共享 toast helper 已经提供了实时播报区域(live region)、关闭按钮、消息队列,以及减少动态效果的适配路径。live region 的作用,是让辅助技术能够感知页面动态出现的消息。
因此,新提示条重复的并不只是一种视觉样式。它另外开了一条反馈路径:原来的消息遵循 helper 的播报和超时规则,新增的消息却有自己的生命周期,还缺少键盘关闭入口。
页面级反馈属于应用的公共交互约定,不能只按当前表单的显示需求来实现。
作者认为,这类代码容易出现,是因为教程常教人「设置 message state,再渲染一个 div」。在独立示例里,这足够演示效果;放进已有应用,就可能跳过团队已经解决的播报、排队和关闭问题。
要让模型复用,先把入口交给它
作者建议直接约定几条边界:页面级成功与失败走现有 helper;不要为相同用途增加页面局部 banner state;字段校验错误仍留在字段旁边。
这里的区分很实用。字段错误回答「哪个输入需要修改」,toast 回答「这次页面操作是否完成」。如果需要用户作出阻塞式确认,则应使用已有 dialog。
下面这段提示词解决的是生成代码前的约束问题,可以直接作为项目任务说明的一部分:
Use the existing toast helper (toast.success, toast.error) for page-level feedback.
Do not add a fixed alert div or a local banner state.
Keep inline field errors on the form.
If you need a new toast variant, add it next to the helper and show one example; do not invent a banner in this page.
要留意最后一行:新样式或新类型应扩展 helper,并提供一个使用示例,而不是在页面里临时另做一套。
不过,只有规则还不够。作者还建议把 helper 的公开 API 和一个现有调用点贴给模型。这样,toast.success、toast.error 就有了具体用法,模型也更容易沿用仓库中的实现。
Review 要查反馈链路有没有接完整
作者给出的检查入口很直接:在 diff 中搜索 role="alert"、role="status",以及 toast root 之外使用 fixed 或 absolute 定位的 banner。
这些匹配是排查线索,不能直接当作错误判据。例如,role="alert" 本身就涉及辅助技术播报;问题在于新增节点是否重复承担通知职责,是否绕开统一管理,以及有没有合理的关闭路径。
原文列出的未完成信号还包括:用 alert() 代替 toast、留下「TODO: hook up notifications」注释,以及为了单条消息引入新的 toast 库。
与之对应,完成度更高的实现应当让数据变更操作在成功和失败时都调用已有 helper;字段错误留在表单内;确实需要新变体时,由 helper 扩展并供新调用点使用。
我的判断
我赞成把「是否复用已有通知机制」纳入 AI 代码评审。它比「页面上出现了成功提示」更接近真实的完成标准,也能减少同一个应用里出现多套消息行为。
但这篇是经验之谈。作者没有给出对照实验,也没有量化提示词能减少多少重复实现。「不指明 toast.ts,模型就找不到」也说得过于绝对:模型是否能发现它,取决于仓库检索能力和拿到的上下文。
这套建议还有一个前提:现有 helper 确实可用,能够满足当前反馈需求。原文描述了一个功能较完整的 helper,却没有讨论它能力不足时该如何取舍。
因此,可以直接采用的是职责划分和上下文提供方式。至于复用现有 helper、扩展它,还是调整通知方案,仍要结合仓库实际情况判断。原文也没有提供足够依据,证明所有页面局部提示都应该改成 toast。
能拿来做什么
- 给 AI 分配前端表单或保存操作任务时,附上通知 helper 的公开 API 和一个调用示例,同时明确使用
toast.success、toast.error。 - 在验收时分别检查字段校验、操作成功和操作失败,确认字段错误留在输入项附近,页面级结果接入已有通知机制。
- Review 时搜索新增的
role="alert"、role="status"和固定定位 banner,逐个确认用途、关闭方式及其与 toast root 的关系。 - 遇到新通知变体时,让 AI 修改共享 helper 并补一个 story 或示例;需要阻塞确认时,指向已有 dialog。