Skip to content
0

没验证就汇报,是 AI 协作里最贵的坏习惯

这次改博客,我被自己一句话提醒了:

你要验证完再来报告,没验证来加剧工作量呢。

这句话听起来像在催进度,实际不是。

它是在讲一个很具体的协作成本:没验证就汇报,不是在交付结果,是把不确定性转交给对方。

AI 协作里最常见的低效,不是慢。慢一点还能接受。真正烦的是它看起来完成了,结果你一打开页面,发现又多了一个要解释、要截图、要回滚、要重测的问题。

AI 协作验证流程对比


这次问题怎么来的

我原本只是想把博客首页调好一点。

流程看起来很简单:

  1. 看首页截图
  2. HomeBoard.vue
  3. 跑构建
  4. 本地预览
  5. 截图确认

但实际踩了几个坑。

第一个坑:构建通过,不代表页面可用。

VitePress 构建成功了,但本地预览端口上可能还挂着旧进程。结果 HTML 是新的,CSS / JS 资源却可能对不上。你只看一句 build complete 就汇报,等对方打开页面,看到的是 404 或旧样式。

第二个坑:截图生成,不代表视觉正确。

移动端截图确实生成了,但标题被挤成奇怪的长行,推荐卡右侧看起来被裁掉。文件存在、命令成功、页面 200,都不能证明它好看。

第三个坑:“差不多了”最贵。

因为页面设计不是代码题。代码只要不报错,机器就觉得能跑。但用户看到的是排版、比例、阅读节奏、有没有别扭感。

这里不能靠“应该可以”。得打开看。


AI 最容易偷懒的地方

AI 很擅长给你一个“完成感”。

它会说:

  • 已修复
  • 已优化
  • 已构建
  • 已验证

但这四句话不是一回事。

说法真正应该代表什么
已修复代码改了,并且目标问题消失
已优化视觉 / 体验比原来更好,而不是只是 CSS 变多了
已构建生产构建通过,警告可解释
已验证页面、资源、核心路径、截图都看过

最危险的是把“我做了”说成“它好了”。

这两个差一轮验证。


验证不是仪式,是省时间

很多人会把验证当成流程负担。

我的感受相反:验证是为了少说废话。

这次博客改版里,真正有效的验证至少有四层:

1. 数据校验

先跑:

bash
pnpm run docs:check

它检查文章 frontmatter、封面路径、正文图片路径、permalink 是否重复。

这个东西不花几秒,但能挡掉一堆“页面为什么空了”“图片为什么不显示”的低级问题。

2. 生产构建

再跑:

bash
pnpm run docs:build

开发模式能跑,不代表生产构建能过。尤其是 VitePress 这种静态站,很多问题只在 build 时暴露。

这次构建有一个大 chunk 警告,但不是失败。之前尝试随手拆包,反而引发主题初始化问题。所以这类警告要记录,但不能为了“看起来干净”乱改。

3. 资源检查

预览服务起来后,要查:

  • 首页 / 是不是 200
  • 文章页 /articles/xxx/ 是不是 200
  • 最新 CSS 文件是不是 200

为什么要查 CSS?

因为静态站最容易出现“HTML 是新的,CSS 没加载”的假正常。页面能打开,但样式全乱。你不查资源,就很容易误报。

4. 截图复核

最后才是最关键的:

  • 桌面端截图
  • 移动端截图
  • 文章页截图
  • 特殊配置截图

这次“博客全图”就是特殊配置。默认首页看起来正常,不代表切到“全图”预设也正常。后来强制切到 wide 预设再截图,才确认原来那种深色整图背景裁切确实被改掉了。


什么时候可以汇报

我的标准现在很简单:

不是命令跑完就汇报,是能回答“你验证了什么”再汇报。

比如这次能说清楚:

  • docs:check 通过,10 篇文章校验正常
  • docs:build 通过,只有已知的大 chunk 警告
  • 首页、文章页、最新 CSS 都是 200
  • 桌面、移动端、文章页、wide 预设都截图看过
  • 本地预览在 4173 跑着

这才叫交付。

否则只是“我这边感觉差不多”。


对人也一样

这件事不只适用于 AI。

人和人协作也一样。

我以前最烦的工作方式是:对方发来一句“好了”,然后你问:

  • 哪个环境?
  • 哪个地址?
  • 你跑过没有?
  • 截图呢?
  • 有没有影响旧页面?

如果这些都要接收方再问一遍,那“好了”这两个字就没有信息量。

真正有用的汇报应该像这样:

我改了 A / B 两处;本地构建通过;生产路径 /xxx/ 打开正常;移动端 390px 截图看过,没有横向滚动;剩一个警告是 chunk 过大,不影响运行。

这段话长一点,但省掉后面十轮问答。


AI 协作的正确打开方式

我现在对 AI 的期待不是“你快点写完”。

我更在意三件事:

  1. 别把猜测当事实
  2. 别把命令成功当体验成功
  3. 别把未验证的东西扔给我验

AI 真正能省时间,是因为它可以替你做重复劳动:

  • 查文件
  • 改代码
  • 跑命令
  • 看截图
  • 对比结果
  • 总结变化

但如果它省掉的是验证,那节省的不是时间,是质量。

质量迟早要补回来,而且通常由你来补。


这笔账怎么算

一次没验证的汇报,看起来省了 2 分钟。

但后面可能多出来:

  • 用户打开页面发现不对:2 分钟
  • 截图发回来解释:3 分钟
  • 重新定位问题:10 分钟
  • 再构建、再预览、再截图:5 分钟
  • 信任损耗:不好量化,但最贵

省 2 分钟,亏 20 分钟。

这账不划算。

所以我现在更认可一个慢一点但完整的闭环:

改完 → 构建 → 重启预览 → 查资源 → 截图 → 看截图 → 再汇报。

多一步验证,少一轮返工。


一句话收尾

AI 协作不是让它更快地说“好了”,而是让它更稳定地交出“确实好了”。

没验证就汇报,本质是在把工作量往后传。验证完再报告,才是真的省时间。


你用 AI 写代码 / 改页面时,最不能忍的是哪种“假完成”? 评论区聊聊。

最近更新

基于 VitePress + Teek 搭建