关于 arch-nuxt-module-builder
面向 Nuxt 模块开发与维护的 @nuxt/module-builder 参考技能，涵盖官方构建流程、运行时文件转换、类型生成及 CI 配置。
主要功能
- 01自动配置模块构建
- 02转换运行时资源
- 03生成类型与 schema shim
- 04CLI 与 CI 指引
- 05配置包导出
适用场景
- 01使用 module-builder 创建 Nuxt 模块
- 02维护运行时插件和组件
- 03为 CI 准备模块构建
- 04配置包导出
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/arch-nuxt-module-builder确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
GENERATION.mdassets/ci.ymlreferences/best-practices-package-exports.mdbest-practices-setup-patterns.mdcore-ci.mdcore-cli.mdcore-dist-output.mdcore-module-definition.mdcore-overview.mdcore-project-structure.mdfeatures-build-config.mdfeatures-runtime.mdfeatures-types-generation.md详细介绍
arch-nuxt-module-builder 技能涵盖 @nuxt/module-builder：构建和发布 Nuxt 模块的完整解决方案。它使用 unbuild，自动化模块构建配置，为 @nuxt/schema 生成类型和 shim，并将 src/runtime/（插件、组合式函数、组件）转换为 dist/runtime/。在使用官方 module-builder 技术栈创建或维护 Nuxt 模块时，请使用这些技能。
该技能基于 @nuxt/module-builder v1.0.2，生成于 2026-01-30。
核心参考
| 主题 | 描述 | 参考 |
|---|---|---|
| 概述 | module-builder 是什么、要求、快速开始 | core-overview |
| 项目结构 | src/module.ts、src/runtime/、package.json、build.config.ts | core-project-structure |
| 模块定义 | defineNuxtModule、ModuleOptions、hooks、运行时配置类型 | core-module-definition |
| 产物输出 | module.mjs、module.json、types.d.mts、runtime/* | core-dist-output |
| 命令行 | nuxt-module-build build/prepare、参数（cwd、outDir、stub） | core-cli |
| CI | GitHub Actions — lint、typecheck、build、test | core-ci |
功能
| 主题 | 描述 | 参考 |
|---|---|---|
| 运行时 | src/runtime/ 布局、plugins/composables/components、mkdist | features-runtime |
| 类型生成 | types.d.mts、ModuleOptions 推断、shim | features-types-generation |
| 构建配置 | build.config.ts、额外入口、unbuild 预设 | features-build-config |
最佳实践
| 主题 | 描述 | 参考 |
|---|---|---|
| 包导出 | exports、typesVersions、prepack、files | best-practices-package-exports |
| 设置模式 | createResolver、不带扩展名的 addPlugin | best-practices-setup-patterns |
资源
| 资源 | 描述 |
|---|---|
| ci.yml | GitHub Actions CI 工作流模板 — 复制到 .github/workflows/ci.yml |
评论
支持 Markdown