Programming · Building & coding
webpack
/webpack
Webpack构建开发专家助手。当用户需要进行Webpack 5构建配置、loader与插件编写、代码分割、打包体积优化、Module Federation微前端或遗留Webpack工程维护时调用。
For whom
- Author
- dkbnull ↗
- Repository
- hello-skill ↗
- Licence
- MIT
- Last repository change
- 09.11.2026
Assessment and security
90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
Deprecation
No signals detected. Repository changed on 09.11.2026, without references to retired models or APIs.
Licence
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Webpack构建开发专家助手。当用户需要进行Webpack 5构建配置、loader与插件编写、代码分割、打包体积优化、Module Federation微前端或遗留Webpack工程维护时调用。
Original author description
Webpack构建开发专家助手。当用户需要进行Webpack 5构建配置、loader与插件编写、代码分割、打包体积优化、Module Federation微前端或遗留Webpack工程维护时调用。
How it works
- 技术栈强制约束
- 命名规范
- 核心概念与配置基础
- Loader 与资源处理
- 代码分割与构建优化
- 开发体验与环境配置拆分
- 注释规范
- 代码质量强制要求
- 最佳实践
Original SKILL.md headings · 97 lines, 364 words
SKILL.md preview
---
name: "webpack"
description: "Webpack构建开发专家助手。当用户需要进行Webpack 5构建配置、loader与插件编写、代码分割、打包体积优化、Module Federation微前端或遗留Webpack工程维护时调用。"
---
# Webpack 开发技能
你是一位资深前端构建工程师。在协助 Webpack 项目时,请遵循以下规范。
> 新项目优先 Vite(见 frontend/skills/vite);框架层规范遵循对应框架技能(Vue 见 frontend/skills/vue,React 见 frontend/skills/react);本技能专注 Webpack 构建配置与优化(遗留工程维护或深度定制场景)。
## 技术栈强制约束
- 使用 Webpack 5.x,禁止基于 Webpack 4 及以下版本新建项目
- 开发服务统一使用 webpack-dev-server 5.x,禁止手工拼装已废弃的中间件方案
- 配置统一通过 `webpack-merge` 合并公共与差异配置,禁止单文件堆砌全部环境逻辑
- JS 转译统一 babel-loader + @babel/preset-env,禁止项目内混用多种转译工具
- 包管理器统一(npm/pnpm/yarn),禁止混用
- 模式显式声明:开发用 `mode: 'development'`,生产用 `mode: 'production'`,禁止依赖默认值
## 命名规范
- 配置拆分文件命名:`webpack.common.js`、`webpack.dev.js`、`webpack.prod.js`
- 自定义 loader 发布命名 `*-loader`,自定义插件命名 `webpack-*-plugin`
- splitChunks 的 cacheGroups 名称语义化小写(`vendors`、`commons`、`echarts`)
- resolve.alias 别名小写(`@`、`@components`),并与 jsconfig/tsconfig 保持一致
- 入口 chunk 名语义化(`app`、`admin`),禁止 chunk0 之类的自动命名长期存在
- 命名语义化,禁止拼音、无意义缩写
## 核心概念与配置基础
- entry:单页应用单一入口,多页应用(MPA)以对象形式声明多个入口并逐一配置 HTML 模板
- output:`filename` 必须携带 `[contenthash]` 支持长效缓存,`publicPath` 与实际部署路径一致
- loader:`module.rules` 通过 `test` 匹配类型,`use` 从右到左(从下到上)执行,用 `exclude: /node_modules/` 缩小范围
- plugin:打包优化、资源注入、变量定义等跨构建任务使用插件完成
- module resolution:`resolve.extensions` 保持精简且顺序固定,`resolve.alias` 配置路径别名
- Webpack 5 不再自动 polyfill Node 核心模块,浏览器端需要时用 `resolve.fallback` 显式声明
- 一个文件被多条规则命中时用 `oneOf` 保证只走一条,避免重复处理
- 禁止在生产配置保留开发专用配置(HMR、mock 代理等)
## Loader 与资源处理
- babel-loader 处理 JS/TS,目标兼容性交给 browserslist 声明,禁止手写全量 polyfill
- CSS:开发环境 style-loader + css-loader,生产环境 mini-css-extract-plugin 抽离 + css-minimizer-webpack-plugin 压缩,禁止生产使用 style-loader
- 样式预处理按需引入 sass-loader/less-loader,全局变量与 mixin 通过 `additionalData` 注入
- 资源统一使用 Webpack 5 内置 Asset Modules(`asset/resource`、`asset/inline`、`asset/source`、`asset`),禁止再引入 file-loader/url-loader/raw-loader
- 小资源内联阈值通过 `parser.dataUrlCondition.maxSize` 控制(默认 8KB),大图禁止内联
- 字体与媒体资源统一 `asset/resource` 输出,并用 `output.assetModuleFilename` 归类目录
- 自定义 loader 保持单一职责:输入源码字符串、返回处理结果,禁止在 loader 中做插件级任务
- rules 中必要时用 `enforce: 'pre'/'post'` 显式控制执行顺序
## 代码分割与构建优化
- 代码分割优先使用动态 `import()` 按路由与大型组件拆分,禁止整库静态引入
- `optimization.splitChunks.chunks: 'all'` 分离公共依赖,体积大且版本稳定的依赖在 cacheGroups 单独分组
- Tree Shaking:package.json 声明 `"sideEffects": false` 或列出有副作用的文件数组,配合 ESM 语法生效
- 单文件内混用 CommonJS 导出会破坏 Tree Shaking,业务代码统一使用 ESM
- 长期缓存开启 `cache: { type: 'filesystem' }` 加速二次构建,CI 中持久化缓存目录
- 微前端使用 Module Federation(ModuleFederationPlugin 的 exposes/remotes/shared),共享依赖声明版本与 singleton 约束
- 体积优化先用 webpack-bundle-analyzer 定位热点,提速用测速类工具(如 speed-measure-webpack-plugin 概念)定位耗时阶段,基于数据决策
- 多进程转译仅在大体量代码时引入 thread-loader,小项目引入得不偿失
- 生产压缩使用默认 Terser 方案,禁止重复叠加多个压缩插件
## 开发体验与环境配置拆分
- HMR 开发模式默认开启,需要模块级精确更新时使用 `module.hot.accept`;HMR 失效优先检查规则重复处理
- devServer 代理:`devServer.proxy` 转发 API,显式 `changeOrigin: true`,复杂场景用 `bypass` 区分页面与接口
- source map 策略分级:开发用 `eval-cheap-module-source-map`(构建快、行级映射),预发排障用 `source-map` 或 `hidden-source-map`,生产禁止 `eval-*` 与内联 map 上线
- 配置拆分:`webpack.common.js` 放公共配置,dev/prod 只留差异项,构建命令用 `--config` 指定入口
- 环境变量通过 DefinePlugin 或 Dotenv 类插件注入,禁止代码硬编码环境地址
- devServer 端口固定,代理目标从环境变量读取
- 启动耗时优化优先控制 plugin/loader 数量与处理范围,禁止盲目堆插件
- mock 能力通过 devServer 中间件或专用 mock 服务提供,禁止侵入构建配置
## 注释规范
- 每个配置文件顶部必须有中文注释说明职责(公共/开发/生产)
- 非默认值配置项必须注释原因与调整背景
- cacheGroups 与 proxy 规则必须注释用途
- TODO 注释格式:`// TODO(作者): 具体待办事项描述`
- 禁止无意义注释与整段注释掉的祖传配置
## 代码质量强制要求
- 所有配置项显式声明意图,禁止无解释的祖传配置
- 构建产物携带内容 hash,禁止无 hash 的静态资源引用
- 合入主干前构建必须无 error,warning 逐条确认
- 生产产物默认不发布 sourcemap(hidden-source-map 场景 map 文件也不下发)
- 禁止 import 未声明的依赖(幽灵依赖)
- 第三方依赖升级后必须复查构建产物与分析报告
- 构建配置变更必须经过 dev/build 双环境验证
## 最佳实践
- 升级 Webpack 大版本前查阅官方迁移指南,独立分支回归后再合入
- CI 中持久化 filesystem cache 与依赖缓存,缩短构建时间
- 多页应用入口与 HTML 模板集中维护,避免手工遗漏
- 定期审查 bundle 构成,清理未使用依赖与冗余 polyfill
- 团队沉淀公共 Webpack 配置模板或预设包,新项目复用统一约定
- 构建性能问题先量化(分析工具)再优化,禁止凭感觉调整
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · dkbnull/hello-skill | 90 | MIT |
| claude-dev-suite/claude-dev-suite | 100 | MIT |
| G1Joshi/Agent-Skills | 100 | MIT |
Database snapshot: 13.11.2026 · package version ca98b12b6295 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100bootstrap-webpack
Include and bundle Bootstrap 6's CSS and JavaScript in a project using Webpack. Use when setting up Bootstrap with Webpack, configuring Webpack loaders for Bootstrap's Sass and JS, or creating a Webpack-based Bootstrap project. - 90webpack-plugin-authoring
Writing webpack 5 plugins — hook selection (compiler vs compilation, tap vs tapAsync, processAssets stages), the asset pipeline (emitAsset, source classes, info metadata, source maps), watch-mode and persistent caching (file/context/missing/buildDependencies), plugin lifecycle… - 100micro-frontends-module-federation
Use this skill when orchestrating independently deployed frontend applications at runtime using Webpack or Vite Module Federation. - 100turbopack
Turbopack is the Rust-based incremental bundler built into Next.js, the default for next dev and next build since Next.js 16. Use when someone asks to configure Turbopack, migrate a webpack config or loaders to the turbopack option in next.config, fix a Turbopack build error, or… - 100rsdoctor-analysis
Use when analyzing Rspack/Webpack bundles from local `rsdoctor-data.json` and producing evidence-based optimization recommendations. - 100runtime-debug
Debug and verification workflow for runtime-bundle and module-resolution regressions. Use when diagnosing unexpected module inclusions, bundle size regressions, or CI failures related to NEXT_SKIP_ISOLATE, nft.json traces, or runtime bundle selection (module.compiled.js). Covers…