nuxt

此技能作为基于 Nuxt 的项目维护核心决策引擎，专为 nuxt-convex Monorepo 设计。它管理框架层级决策的复杂环境，通过将任务路由至最合适的抽象层，协助开发者避免泛型或反模式的实现选择。无论任务涉及服务器端渲染 (SSR)、页面元数据、布局转换还是深度模块整合，此技能都能确保在退回手动 Vue 逻辑或自定义 HTML 结构之前，优先应用 Nuxt 原生方式。

• 为 SSR、数据获取和页面元数据配置简化路由至专业 Nuxt 套件。

• 强制执行以 Nuxt 原生抽象化取代原始 Vue 或手动 DOM 操作。

• 针对模块编写的上下文感知路由，包括钩子 (Hooks) 管理和运行时扩展脚本编写。

• 在 Nuxt 环境中整合 Convex 相关实时功能的具体指南，平衡服务器端安全性和客户端响应式。

• 智慧型后备机制，优先选择 Nuxt Content 和 Nuxt UI 原语来处理标准 UI 界面。

• 在开始实现前，务必检查组件、路由或模块界面。

• 遵循层级优先级：存储库全域规则 > Nuxt 套件 > Vue 最佳实践 > 模块增量规则。

• 使用 useFetch 或 useAsyncData 处理路由驱动的数据，以防止注水 (Hydration) 不匹配。

• 优先使用 definePageMeta 和 useSeoMeta 进行路由与文件头管理。

• 将仅供浏览器的 API 与环境变量隔离在符合 Nuxt 规范的边界之后 (ClientOnly、服务器端配置)。

• 本技能预设拥有 playground 子树的完全所有权；若需操作外部存储库文件，用户必须明确触发范围变更。