affaan-m/ECC

nextjs-turbopack

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

57Collecting
See how to use itView GitHub source
npx skills add https://github.com/affaan-m/ECC --skill "docs/zh-CN/skills/nextjs-turbopack"
Automated source guide

Source checked Jul 28, 2026·Refresh due Oct 26, 2026

Reorganized from the pinned upstream SKILL.md

Turn nextjs-turbopack's source instructions into a guide you can follow

According to the pinned SKILL.md from affaan-m/ECC: Next.js 16+ 在本地开发中默认使用 Turbopack:这是一个用 Rust 编写的增量捆绑器,能显著加快开发启动和热更新的速度。

npx skills add https://github.com/affaan-m/ECC --skill "docs/zh-CN/skills/nextjs-turbopack"
Check the pinned source

Best fit

  • Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

Bring this context

  • A concrete task that matches the documented purpose of nextjs-turbopack.
  • The files, examples, or context the task depends on.
  • Your constraints, target environment, and definition of done.

Expected outputs

  • A result that follows the pinned nextjs-turbopack instructions.
  • A concise record of assumptions, inputs used, and unresolved questions.
  • A final check against the source workflow and relevant permission signals.

Key source sections

Read nextjs-turbopack through these 5 source sections

Sections are extracted automatically from the pinned SKILL.md and link back to the source.

01

何时使用

Turbopack (默认开发模式):用于日常开发。冷启动和热模块替换速度更快,尤其是在大型应用中。 Webpack (旧版开发模式):仅当遇到 Turbopack 错误或依赖仅在开发中可用的 webpack 插件时使用。可通过 --webpack(或 --no-turbopack,具体取决于你的 Next.js 版本;请查阅你所用版本的文档)来禁用。 生产环境:生产构建行为 (next build) 可能使用 Turbopack 或 webpack,这取决于 Next.js 版本;请查阅你所用版本的官方 Next.js 文档。

SKILL.md · 何时使用
Turbopack (默认开发模式):用于日常开发。冷启动和热模块替换速度更快,尤其是在大型应用中。Webpack (旧版开发模式):仅当遇到 Turbopack 错误或依赖仅在开发中可用的 webpack 插件时使用。可通过 --webpack(或 --no-turbopack,具体取决于你的 Next.js 版本;请查阅你所用版本的文档)来禁用。生产环境:生产构建行为 (next build) 可能使用 Turbopack 或 webpack,这取决于 Next.js 版本;请查阅你所用版本的官方 Next.js 文档。
02

工作原理

Turbopack:用于 Next.js 开发的增量捆绑器。利用文件系统缓存,因此重启速度要快得多(例如,在大型项目中快 5–14 倍)。 开发环境默认启用:从 Next.js 16 开始,next dev 默认使用 Turbopack,除非被禁用。 文件系统缓存:重启时会复用之前的工作成果;缓存通常位于 .next 下;基本使用无需额外配置。 捆绑包分析器 (Next.js 16.1+):实验性的捆绑包分析器,用于检查输出并发现重型依赖;可通过配置或实验性标志启用(请查阅你所用版本的 Next.js 文档)。

SKILL.md · 工作原理
Turbopack:用于 Next.js 开发的增量捆绑器。利用文件系统缓存,因此重启速度要快得多(例如,在大型项目中快 5–14 倍)。开发环境默认启用:从 Next.js 16 开始,next dev 默认使用 Turbopack,除非被禁用。文件系统缓存:重启时会复用之前的工作成果;缓存通常位于 .next 下;基本使用无需额外配置。
03

示例

运行 next dev 以使用 Turbopack 进行本地开发。使用捆绑包分析器(参见 Next.js 文档)来优化代码分割并剔除大型依赖。尽可能优先使用 App Router 和服务器组件。

SKILL.md · 示例
运行 next dev 以使用 Turbopack 进行本地开发。使用捆绑包分析器(参见 Next.js 文档)来优化代码分割并剔除大型依赖。尽可能优先使用 App Router 和服务器组件。
04

命令

Review the “命令” section in the pinned source before continuing.

SKILL.md · 命令
Review and apply the “命令” source section.
05

使用

运行 next dev 以使用 Turbopack 进行本地开发。使用捆绑包分析器(参见 Next.js 文档)来优化代码分割并剔除大型依赖。尽可能优先使用 App Router 和服务器组件。

SKILL.md · 使用
运行 next dev 以使用 Turbopack 进行本地开发。使用捆绑包分析器(参见 Next.js 文档)来优化代码分割并剔除大型依赖。尽可能优先使用 App Router 和服务器组件。

SkillSignal prompt templates

Provide the task, context, and acceptance criteria

These prompts were written by SkillSignal from the source structure; they are not upstream text.

Task-start prompt

Confirm source fit, inputs, and outputs before acting.

Use nextjs-turbopack to help me with: [specific task]. Context: [files, data, or background]. Constraints: [environment, scope, and prohibited actions]. Before acting, check the pinned SKILL.md and explain which sections apply, what inputs are still missing, and what you will deliver.

Source-guided execution

Make the Agent explicitly follow the key extracted sections.

Apply the pinned nextjs-turbopack source to [task]. Pay particular attention to these source sections: “何时使用”, “工作原理”, “示例”, “命令”, “使用”. Preserve the important decision at each step. Mark facts not covered by the source as “needs confirmation” instead of inventing them. Then verify the result against my acceptance criteria: [criteria].

Result-review prompt

Check omissions, permissions, and source drift before delivery.

Review the current nextjs-turbopack result: (1) does it satisfy the original task; (2) were any applicable steps or limits in the pinned SKILL.md missed; (3) did it perform any unauthorized file, command, network, or data action; and (4) which conclusions remain unverified? List issues first, then fix only what the source or user authorization supports.

Output checklist

Verify each item before delivery

The task matches the purpose documented in the SKILL.md.

The source section “何时使用” has been checked.

The source section “工作原理” has been checked.

The source section “示例” has been checked.

The source section “命令” has been checked.

Inputs, constraints, and acceptance criteria are explicit.

Unverified facts, compatibility, and outcome claims are clearly marked.

Any file, command, network, or data action has been reviewed.

Choose a different workflow

When another Skill is the better fit

FAQ

What does nextjs-turbopack do?

Next.js 16+ 在本地开发中默认使用 Turbopack:这是一个用 Rust 编写的增量捆绑器,能显著加快开发启动和热更新的速度。

How do I start using nextjs-turbopack?

The catalog detected this source-specific install command: npx skills add https://github.com/affaan-m/ECC --skill "docs/zh-CN/skills/nextjs-turbopack". Inspect the command and pinned source before running it.

Which Agent platforms does it declare?

No dedicated Agent platform is declared in the pinned source record.

Repository stars
234,327
Repository forks
35,711
Quality
57/100
Source repository last pushed

Quality breakdown

Based on traceable docs and repository signals; stars are not treated as quality.

57/100
Documentation15/30
Specificity10/25
Maintenance20/20
Trust signals12/25
View original Skill.mdThis page is parsed directly from the repository SKILL.md without editorial rewriting. Collected: Jul 28, 2026 · about 1 min

Next.js 与 Turbopack

Next.js 16+ 在本地开发中默认使用 Turbopack:这是一个用 Rust 编写的增量捆绑器,能显著加快开发启动和热更新的速度。

何时使用

  • Turbopack (默认开发模式):用于日常开发。冷启动和热模块替换速度更快,尤其是在大型应用中。
  • Webpack (旧版开发模式):仅当遇到 Turbopack 错误或依赖仅在开发中可用的 webpack 插件时使用。可通过 --webpack(或 --no-turbopack,具体取决于你的 Next.js 版本;请查阅你所用版本的文档)来禁用。
  • 生产环境:生产构建行为 (next build) 可能使用 Turbopack 或 webpack,这取决于 Next.js 版本;请查阅你所用版本的官方 Next.js 文档。

适用场景:开发或调试 Next.js 16+ 应用,诊断开发启动或热模块替换速度慢的问题,或优化生产环境捆绑包。

工作原理

  • Turbopack:用于 Next.js 开发的增量捆绑器。利用文件系统缓存,因此重启速度要快得多(例如,在大型项目中快 5–14 倍)。
  • 开发环境默认启用:从 Next.js 16 开始,next dev 默认使用 Turbopack,除非被禁用。
  • 文件系统缓存:重启时会复用之前的工作成果;缓存通常位于 .next 下;基本使用无需额外配置。
  • 捆绑包分析器 (Next.js 16.1+):实验性的捆绑包分析器,用于检查输出并发现重型依赖;可通过配置或实验性标志启用(请查阅你所用版本的 Next.js 文档)。

示例

命令

next dev
next build
next start

使用

运行 next dev 以使用 Turbopack 进行本地开发。使用捆绑包分析器(参见 Next.js 文档)来优化代码分割并剔除大型依赖。尽可能优先使用 App Router 和服务器组件。

最佳实践

  • 保持使用较新的 Next.js 16.x 版本,以获得稳定的 Turbopack 和缓存行为。
  • 如果开发速度慢,请确保你正在使用 Turbopack(默认),并且缓存没有被不必要地清除。
  • 对于生产环境捆绑包大小问题,请使用你所用版本的官方 Next.js 捆绑包分析工具。
Source repo
affaan-m/ECC
Skill path
docs/zh-CN/skills/nextjs-turbopack/SKILL.md
Commit SHA
4e973d3eaf92
Repository license
MIT
Data collected