用途:这是一个 Next.js 客户端导航预取优化工作流,面向已经在项目中启用 Cache Components 与 Partial Prefetching 的场景。它把每个被请求的源链接与目标页面视为独立契约,明确点击前应预先就绪的 UI、应留待导航时加载的 UI,以及预取触发时机。
主要能力:先读取捆绑文档 node_modules/next/dist/docs/01-app/02-guides/optimizing-prefetching.md(不可用时用在线指南)作为预取阶段的依据;检查源路由、具体链接或交互、目标 Suspense 边界、数据读取与现有预取策略,梳理出目标 UI、触发方式、新鲜度与授权约束。复用已有的 instant-nav.rig.md 生产测试装置,为每个“源链接—目标—触发方式”组合单独编写一个点击驱动的 instant() 测试,不把多个目标合并进同一测试。
使用方式:先用未加锁的脚手架确认链接命中正确 pathname 与 query 且目标 UI 最终渲染,再在 instant() 锁定下运行正反断言;随后按指南做最小优化,逐条导航转 GREEN;添加或扩大缓存边界时需测试完整生命周期(填充、变更、再读取);最后仅移除优化并重跑,确认契约回到 RED,再恢复优化要求 GREEN,保留通过的正向测试作为回归覆盖。
适用场景:对指定页面导航做链接级预取成本与时机调优,减少点击后等待,同时保持新鲜度、授权与直接访问行为不变。
限制:这不是采用类技能;若未启用 Cache Components 或 Partial Prefetching,需先使用相应 adoption 技能。若 App Shell 无法在 instant() 下提交,应先使用 next-cache-components-optimizer。自动链接预取仅在 production build 或启用了 experimental.exposeTestingApiInProductionBuild 的预览环境可测;开发模式仅用于诊断。预取为尽力而为,未完成时 App Shell 仍是回退。不要把单链接策略扩展为全应用 Link 或缓存抽象,也不要基于私有 RSC URL 或内部请求头判断请求阶段。