arch-nuxt-module-builder
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
Chinesearch-nuxt-module-builder skills cover @nuxt/module-builder: the complete solution to build and ship Nuxt modules. It uses unbuild, automates module build config, generates types and shims for , and transforms (plugins, composables, components) to . Use these skills when creating or maintaining a Nuxt module with the official module-builder stack.
@nuxt/schemasrc/runtime/dist/runtime/The skill is based on @nuxt/module-builder v1.0.2, generated at 2026-01-30.
arch-nuxt-module-builder技能涵盖**@nuxt/module-builder**：这是一套构建并发布Nuxt模块的完整解决方案。它基于unbuild开发，可自动处理模块构建配置，生成@nuxt/schema的类型定义与垫片，并将目录下的内容（包括插件、组合式函数、组件）转换至目录。当你使用官方module-builder技术栈创建或维护Nuxt模块时，可运用这些技能。
src/runtime/dist/runtime/本技能基于@nuxt/module-builder v1.0.2版本生成，生成时间为2026-01-30。
Core References
核心参考
| Topic | Description | Reference |
|---|---|---|
| Overview | What module-builder is, requirements, quick start | core-overview |
| Project structure | src/module.ts, src/runtime/, package.json, build.config.ts | core-project-structure |
| Module definition | defineNuxtModule, ModuleOptions, hooks, runtime config types | core-module-definition |
| Dist output | module.mjs, module.json, types.d.mts, runtime/* | core-dist-output |
| CLI | nuxt-module-build build/prepare, args (cwd, outDir, stub) | core-cli |
| CI | GitHub Actions — lint, typecheck, build, test | core-ci |
| 主题 | 描述 | 参考链接 |
|---|---|---|
| 概述 | 什么是module-builder、系统要求、快速开始 | core-overview |
| 项目结构 | src/module.ts、src/runtime/、package.json、build.config.ts | core-project-structure |
| 模块定义 | defineNuxtModule、ModuleOptions、钩子、运行时配置类型 | core-module-definition |
| 构建输出 | module.mjs、module.json、types.d.mts、runtime/* | core-dist-output |
| 命令行工具 | nuxt-module-build build/prepare命令、参数（cwd、outDir、stub） | core-cli |
| 持续集成 | GitHub Actions — 代码检查、类型校验、构建、测试 | core-ci |
Features
功能特性
| Topic | Description | Reference |
|---|---|---|
| Runtime | src/runtime/ layout, plugins/composables/components, mkdist | features-runtime |
| Types generation | types.d.mts, ModuleOptions inference, shims | features-types-generation |
| Build config | build.config.ts, extra entries, unbuild preset | features-build-config |
| 主题 | 描述 | 参考链接 |
|---|---|---|
| 运行时 | src/runtime/布局、插件/组合式函数/组件、mkdist工具 | features-runtime |
| 类型生成 | types.d.mts、ModuleOptions类型推导、垫片 | features-types-generation |
| 构建配置 | build.config.ts、额外入口、unbuild预设 | features-build-config |
Best Practices
最佳实践
| Topic | Description | Reference |
|---|---|---|
| Package exports | exports, typesVersions, prepack, files | best-practices-package-exports |
| Setup patterns | createResolver, addPlugin without extension | best-practices-setup-patterns |
| 主题 | 描述 | 参考链接 |
|---|---|---|
| 包导出配置 | exports、typesVersions、prepack指令、文件列表 | best-practices-package-exports |
| 配置模式 | createResolver、无扩展名添加插件 | best-practices-setup-patterns |
Assets
资源文件
| Asset | Description |
|---|---|
| ci.yml | GitHub Actions CI workflow template — copy to |
| 资源 | 描述 |
|---|---|
| ci.yml | GitHub Actions CI工作流模板 — 可复制到 |