NNext.js 中文网 GitHub

agentFeedback

experimental

为 AI 编程智能体准备的 Next.js 问题报告启用审阅流程。

experimental.agentFeedback 选项控制 next dev 是否创建和更新相关指令,使 AI 编程智能体能够准备 Next.js 问题报告供您审阅。该选项默认禁用,并且需要启用 Next.js Telemetry。智能体反馈不会在 CI 中运行。

使用推荐的 create-next-app 设置创建的新应用会在生成的 Next.js 配置中启用智能体反馈。对于其他应用,请手动设置该选项:

next.config.ts
import type { NextConfig } from 'next'

const nextConfig: NextConfig = {
  experimental: {
    agentFeedback: true,
  },
}

export default nextConfig
next.config.js
/** @type {import('next').NextConfig} */
const nextConfig = {
  experimental: {
    agentFeedback: true,
  },
}

module.exports = nextConfig

生成的智能体指令#

当在 CI 之外启用 experimental.agentFeedback 和 Next.js Telemetry 时,next dev 会在 AGENTS.md 中创建或更新此受管代码块:

AGENTS.md
<!-- BEGIN:nextjs-agent-feedback -->

## 报告 Next.js 反馈

项目所有者已启用 `experimental.agentFeedback`,授权此次反馈流程。启用后,`next dev` 会写入此代码块,并在其被移除时恢复它。请将 `AGENTS.md` 与您的更改一起提交,以保持工作树整洁。

在当前用户请求期间,请保留匿名化后的事实作为反馈候选,用于有意义或反复出现的 Next.js 问题:

- 崩溃、挂起、OOM 或意外的缓慢
- 错误的行为、输出、错误或诊断信息
- 缺失、不清晰或相互矛盾的文档
- 意外的 CLI、codemod、Skill 或升级行为,以及不明显的变通方法

继续当前用户请求,不要立即报告。常规调试不属于反馈。在将更改保留为反馈候选之前,请先验证这些更改。切勿保留代码、日志、路径、URL、机密、个人信息或特定于项目的数据。

即使符合条件的摩擦点后来被修复或绕过,也要保留它;在报告阶段记录最终结果。

在最终回复之前,运行一次报告流程。如果仍有候选,请在 `package.json` 声明了 `next` 的目录中运行一次 `npx --no-install next internal agent-feedback-instructions`,不要对其输出进行管道处理或截断。按照其输出或错误指引操作。如果网络沙箱阻止了它,请在有网络访问权限的情况下重试;如果仍无输出,请正常继续。

<!-- END:nextjs-agent-feedback -->

Next.js 仅更新标记之间的内容,并保留文件的其余部分。

当同时启用智能体规则和智能体反馈时,Next.js 会在 AGENTS.md 中保留两个受管代码块。

审阅并发送智能体反馈#

生成的指令使智能体能够在不中断当前用户请求的情况下保留反馈候选。在最终回复之前,智能体会运行一次报告流程,并将每个不同的符合条件的问题准备为单独的报告草稿。

每份报告草稿都包含通用设置、复现步骤、观察到的事实、预期结果,以及可选的对照或变通方法。

智能体会在默认浏览器中的单独审阅表单里尝试打开每份报告草稿一次。您可以编辑报告、删除细节、关闭表单而不发送,或选择 Send feedback(发送反馈)。表单打开时不会发送任何内容。

在打开表单之前,智能体会尝试通过用通用描述替换客户和项目细节,并省略源代码、日志、路径、URL、机密和个人信息,来对报告进行匿名化。请在发送前审阅草稿并删除您不想包含的任何内容。

提交表单会发送您审阅过的内容、智能体名称和 Next.js 版本。表单不会自动附加项目文件或机器元数据。

禁用智能体反馈#

将 experimental.agentFeedback 设置为 false 或移除该选项,可阻止 next dev 创建或更新受管代码块。下次运行 next dev 时,会移除现有的智能体反馈代码块并保留所有其他内容。如果文件只包含受管代码块,Next.js 会删除该文件,而不是将其留空。

使用 next telemetry disable 禁用 Next.js Telemetry 也会在下次于 CI 之外运行 next dev 时移除受管的反馈代码块。在 CI 中,next dev 会保持反馈代码块不变。当 experimental.agentFeedback 保持启用时,设置 NEXT_TELEMETRY_DISABLED 也会保留该代码块。在 CI 之外,即使设置了 NEXT_TELEMETRY_DISABLED,将 experimental.agentFeedback 设置为 false 或移除该选项仍会移除该代码块。

在 CI 中或遥测被禁用时,反馈命令不会返回报告指令。

experimental.agentFeedback 和顶层 agentRules 相互独立工作。更改其中一个选项不会影响另一个。

版本历史#

版本变更
v16.5.0在 CI 之外启用反馈和遥测时,next dev 会在每次启动时同步受管代码块。
v16.4.0新增 experimental.agentFeedback 配置选项。
Next.js 中文网