npx skills add https://github.com/vercel/next.js --skill runtime-debug在复现运行时捆绑包、模块解析或用户捆绑包包含回归问题时使用此技能。
IS_WEBPACK_TEST=1 强制使用 webpack(默认是 turbopack),NEXT_SKIP_ISOLATE=1 跳过打包 next.js。NEXT_SKIP_ISOLATE=1 的情况下重新运行。设置 __NEXT_SHOW_IGNORE_LISTED=true 以禁用开发服务器错误输出中的忽略列表过滤。默认情况下,Next.js 会将内部堆栈帧折叠为 at ignore-listed frames,这在调试框架内部时会隐藏有用的上下文。该功能定义于 packages/next/src/server/patch-error-inspect.ts。
当用户执行 next build 意外开始捆绑内部仅限 Node.js 的辅助函数时:
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
.next/server/.../page.js.nft.json)。next/dist/server/stream-utils/node-stream-helpers.js、node:stream/promises)。test-start-webpack 断言,该断言读取路由跟踪和跟踪到的服务器代码块,并在发现禁止的内部模块时使测试失败。这用于验证用户项目的捆绑(而非发布时的运行时捆绑)。为了证明用户捆绑包含了什么,可以从应用的 next.config.js 中输出 webpack 统计信息:
// next.config.js
module.exports = {
webpack(config) {
config.profile = true
return config
},
}
然后使用 stats.toJson({ modules: true, chunks: true, reasons: true }) 并比较不同模式下的 webpack-stats-server.json 文件。这提供了具体的包含原因(例如,哪个模块需要了 node:stream/promises),并且比仅使用分析器 HTML 更可靠。
$flags - 标志连接(配置/模式/定义环境/运行时环境)$dce-edge - DCE 安全的 require 模式和边缘约束$react-vendoring - 基于入口的边界和供应商提供的 React每周安装量
334
代码仓库
GitHub 星标数
138.5K
首次出现
2026年2月17日
安全审计
安装于
codex319
gemini-cli319
opencode319
github-copilot318
amp315
kimi-cli315
Use this skill when reproducing runtime-bundle, module-resolution, or user-bundle inclusion regressions.
IS_WEBPACK_TEST=1 forces webpack (turbopack is default), NEXT_SKIP_ISOLATE=1 skips packing next.js.NEXT_SKIP_ISOLATE=1.Set __NEXT_SHOW_IGNORE_LISTED=true to disable the ignore-list filtering in dev server error output. By default, Next.js collapses internal frames to at ignore-listed frames, which hides useful context when debugging framework internals. Defined in packages/next/src/server/patch-error-inspect.ts.
When user next build starts bundling internal Node-only helpers unexpectedly:
.next/server/.../page.js.nft.json).next/dist/server/stream-utils/node-stream-helpers.js, node:stream/promises).test-start-webpack assertion that reads the route trace and traced server chunks, and fails on forbidden internals. This validates user-project bundling (not publish-time runtime bundling).To prove what user bundling includes, emit webpack stats from the app's next.config.js:
// next.config.js
module.exports = {
webpack(config) {
config.profile = true
return config
},
}
Then use stats.toJson({ modules: true, chunks: true, reasons: true }) and diff webpack-stats-server.json between modes. This gives concrete inclusion reasons (e.g. which module required node:stream/promises) and is more reliable than analyzer HTML alone.
$flags - flag wiring (config/schema/define-env/runtime env)$dce-edge - DCE-safe require patterns and edge constraints$react-vendoring - entry-base boundaries and vendored ReactWeekly Installs
334
Repository
GitHub Stars
138.5K
First Seen
Feb 17, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykPass
Installed on
codex319
gemini-cli319
opencode319
github-copilot318
amp315
kimi-cli315
Azure 升级评估与自动化工具 - 轻松迁移 Functions 计划、托管层级和 SKU
66,100 周安装
AWS SDK Java v2 RDS 管理教程 - 数据库实例、快照、参数组操作指南
327 周安装
AWS SDK Java 2.x Secrets Manager 使用指南:安全密钥管理与Spring Boot集成
327 周安装
React + Cloudflare Workers 集成 Microsoft Entra ID 身份验证完整指南 | Azure Auth
327 周安装
电商SEO审计技能 - 专业产品页面、集合页面、技术SEO与竞争分析工具
328 周安装
AI生成应用图标工作流:支持iOS 26 Liquid Glass与Android自适应图标配置
328 周安装
Sentry Next.js SDK 完整设置指南:错误监控、追踪、会话回放
328 周安装