用途:针对单个 Next.js 问题报告产出具体、可重复的证据,优先采用实际观察到的行为,而非仅凭阅读代码得出的假设。
主要能力:从报告中提取预期行为与实际行为、报告的 Next.js 版本与环境、复现 URL 或步骤,以及可测试的最窄断言;在可用时按原样运行报告者的复现,并记录为使其可执行所需的修复;若复现缺失、私有、不完整或未隔离断言,则创建能演示该问题的最小独立应用,移除无关依赖、路由、样式和配置。
使用方式:先检查复现及其依赖清单,再安装或运行;优先使用报告中的依赖版本,记录解析后的 next、react、react-dom 精确版本、运行时版本、平台、安装命令和运行命令;通过相关界面验证行为,如浏览器交互、HTTP 请求、构建、开发服务器、生产服务器或测试命令,并捕获最小决定性输出;重复足够次数以区分确定性行为与偶发问题,不凭单次模糊观察断言复现成功。
适用场景:调查 vercel/next.js 的 bug 报告是否可复现,需要可重复证据时使用。
限制:不修改 Next.js 产品源码、不做历史二分、不声称修复;不静默用 next@canary 替代报告版本;复现须与无关仓库改动隔离;除非用户要求,不发布分支、仓库或部署;凭据与无关主机数据须留在执行环境之外;若无法运行提供的复现,应报告阻塞而非把代码检查当作复现。报告需返回 outcome(reproduced、not-reproduced 或 blocked)、决定性证据摘要、精确依赖版本与环境、复现位置及是否创建或修复、安装与运行命令、预期与观察行为、最多五条具体发现,以及除 reproduced 外每种结果的阻塞原因。