页面能打开时先别合并

报错会让你停下来。页面能打开,反而容易让你放松。AI 改完代码后,最危险的状态不是红屏,而是首页能打开、主要按钮能点,但某个旧链接、移动端布局、空状态或 SEO 字段已经坏了。

几类改动很隐蔽:Agent 为了修一处样式删掉列表空态,为了改文章卡片顺手改了排序,为了让类型通过把字段改成可选。页面看起来正常,真实数据一进来就偏。

不要只看桌面主路径

截图只能证明某个视口、某条数据、某一次状态下页面能渲染。它不能证明链接都存在,也不能证明手机宽度没溢出,更不能证明旧数据还兼容。

让 Agent 交付截图时,你还要问它检查了哪些尾部状态。只有“桌面首页截图”这种证据太薄。个人博客也一样。文章页能打开,不代表相关文章、参考来源、canonical、JSON-LD 和标签页都对。

把新增链接逐个列出来

AI 很容易生成一个看起来合理的 slug。问题是站点里未必有这个路由。相关文章、分类、标签、面包屑、外部参考都要查。

你可以让 Agent 把它新增或修改过的链接列出来。每个链接都要有来源:来自已有文章、来自新增文件,还是来自官方文档。

Text
请列出本次改动涉及的全部链接:
1. 站内文章链接
2. 分类和标签链接
3. 外部参考链接
4. 你没有打开验证的链接

用手机宽度检查长标题和按钮

AI 写 UI 时,最容易看桌面主路径。移动端标题是否换行、按钮是否有 40px 点击面积、侧栏是否压正文、长英文是否溢出,这些都要看。

空状态也要看。搜索没有结果、分类没有文章、相关文章为空、证据链接缺失,这些状态平时不显眼,但一旦坏掉,用户会卡住。

移动端375px 宽度下检查标题、卡片、导航和按钮
空状态搜索无结果、分类无文章、文章不存在
长文本英文命令、URL、模型名和错误信息不撑破容器

用旧文章检查新增字段

Agent 为了实现一个新展示字段,可能会改数据模型。新增字段没有问题,但你要确认旧文章怎么处理。旧数据没有这个字段时,页面应该有默认值,或者你需要补齐旧内容。

如果你在技术博客里新增审校日期、工具信息或参考来源,文章详情页、列表页、搜索页都可能受到影响。不要只打开新增文章。

核对当前文章的 SEO 信息

AI 改页面时,经常把 SEO 当作模板填充。标题、description、canonical、Open Graph、TechArticle JSON-LD 都需要跟当前文章一致。

博客文章尤其要注意日期。正文可以写绝对日期,页面头部也要用真实 `datePublished`、`dateModified` 和 `lastReviewed`。耐久内容里只放可复查的具体日期和版本号。

让 Agent 报告没有验证的项目

你可以把尾部验证写成固定要求。这样 Agent 每次交付时会知道,主路径之外也要检查。

Text
请按尾部行为检查本次改动:
1. 站内链接是否有目标
2. 移动端 375px 是否溢出
3. 空状态是否可读
4. 旧数据是否仍能渲染
5. SEO 字段是否来自当前页面
6. 哪些项目没有验证,原因是什么

工具报错时回到配置页

如果 Claude Code 或 Codex 在验证时自己报错,先看错误来自哪一层。模型找不到、base URL 填错、unsupported parameter、service_tier 参数不支持,这些不是业务代码错误。

工具链没跑通时,不要让 Agent 继续猜业务代码。先把 Claude Code 或 Codex 的接入问题处理掉,再回来检查页面行为。

合并前检查这 7 项

AI 改完代码后,至少检查这几项:

  • diff 里有没有任务外文件
  • 主路径能否打开
  • 站内链接是否存在
  • 移动端是否溢出
  • 空状态是否可读
  • 旧数据是否兼容
  • SEO 字段是否对应当前页面

参考来源

Codex CLIOpenAI 官方文档Claude Code QuickstartAnthropic 官方文档Claude Code settingsAnthropic 官方文档

相关文章

AI Coding 工具真正改变的不是写代码,而是验证代码智能编程 / 约 8 分钟我如何让 AI 只改该改的文件智能编程 / 约 8 分钟Vibe Coding 到底适合什么项目,不适合什么项目智能编程 / 约 8 分钟Claude Code 配置指南:先把这 7 件事配好智能编程 / 约 15 分钟Codex CLI 实用配置指南:先把这 6 件事配好智能编程 / 约 16 分钟Claude Code model not found 错误排查步骤错误日志 / 约 12 分钟DeepSeek Anthropic API 404 错误排查步骤错误日志 / 约 12 分钟