用途:为任意项目建立可长期维护的 shadcn-docs-nuxt 文档站,覆盖初始化、重建与故障排查。
主要能力:技能分三层——SKILL.md 负责导航与流程,references/ 提供排错手册与配置说明,templates/ 提供可直接复制的代码模板(含完整注释)。模板覆盖 nuxt.config、app.config、tailwind.config、CSS 入口、debug shim、workspace 别名、Nuxt Plugin、package.json、prettier 配置等。参考文档覆盖 Nuxt 配置、ESM/CJS 兼容、Tailwind CSS、MDC 与 Prettier、Windows 构建、workspace、事故修复、依赖排查、SSR 水合、生产图与运行时闭包。
使用方式:按标准流程推进——先建最小骨架(package.json、nuxt.config.ts、app.config.ts、tailwind.config.js、assets/css、content/index.md),再配置依赖与脚本(脚本需含 predev/prebuild/postinstall 三处 nuxt prepare),然后依次处理 Nuxt 配置、Tailwind 与 CSS、MDC 内容,最后验证。遇到配置细节查 reference,需要代码直接读 template。
核心原则:保持精简、先跑通再美化、先修运行链再修样式、避免错误扩展、内容语法严格、生产闭包先证据后配置。
适用场景:初始化或重建 shadcn-docs-nuxt 文档站;排查 Content cache/search API 500、H3 导出缺失、依赖解析失败、SSR 水合异常、Nitro OOM、standalone MODULE_NOT_FOUND、Windows 构建卡住、MDC 裸文本与 hydration mismatch 等问题。
限制:资料未提供具体收费、价格、平台支持范围与效果数据。技能强调验证口径需包含内容断言、水合判定、浏览器桌面视口截图与交互闭环,状态须标记 verified、candidate 或 needs_check;生产模板不得默认配置 nitro.externals,不得用 root 全局 rolldown override 掩盖兼容问题。