在 Nuxt 项目用 @nuxt/content…

当项目已安装 @nuxt/content，需要处理 content.config.ts、collections、queryCollection、Markdown/MDC 渲染、内容数据库、hooks、自定义 source、搜索或 Content v2 迁移时使用。

适用场景

解决思路

1. 先检查已安装的 @nuxt/content 版本、content.config.ts、content/ 目录下匹配的文件，以及消费这些内容的 Nuxt 界面；当 collection、source glob、schema 与消费端三者一致时，才算把当前改动理解清楚。
2. 打开下方最小匹配的那一份指南；只把 Nuxt Content 的指导应用到内容自有的 API 上，其余部分若归 Nuxt、Nuxt Studio、Nuxt UI 或 Vue 所有，就改用对应包的指导。
3. 用带类型的 collection 和 payload 驱动的 Nuxt 数据加载来实现；当 collection 类型能解析、目标查询返回预期的文档结构、且渲染路由在目标渲染模式下可用时，改动才算完成。
4. 当任务涉及 collection 类型、schema、索引、本地/远程 source 或 locale 前缀时，打开 references/collections.md。
5. 当任务涉及过滤、排序、分页、导航、surroundings 或搜索时，打开 references/querying.md。
6. 当任务涉及 Markdown、MDC、ContentRenderer、prose 组件或代码高亮时，打开 references/rendering.md。
7. 当任务涉及数据库适配器、markdown 处理、renderer 别名或部署存储时，打开 references/config.md。
8. 当任务涉及 hooks、transformers、自定义 source、raw content、调试或 Content v2 迁移时，打开 references/advanced.md。
9. 当任务涉及可视化编辑、认证、媒体、草稿或 Git 发布时，改用 nuxt-studio skill。
10. 当任务是撰写或重构文档正文时，改用 document-writer skill。
11. 按 baseline 在 content.config.ts 中写好配置：从 @nuxt/content 导入 defineCollection、defineContentConfig，从 zod 导入 z，用 defineContentConfig 导出 collections，例如 docs 用 defineCollection({ type: 'page', source: 'docs/**', schema: z.object({ updatedAt: z.date().optional() }) })。
12. 按 baseline 在 Vue 组件中取数并渲染：在 <script setup lang="ts"> 中用 useRoute() 拿路由，再用 await useAsyncData(route.path, () => queryCollection('docs').path(route.path).first()) 取 data: page，模板里用 <ContentRenderer v-if="page" :value="page" /> 渲染。
13. 用 `npx nuxi typecheck` 验证生成的 collection 类型。
14. 当查询结果为空时，先确认该 collection 的 source 是否包含了目标文件——尤其是 `.navigation.yml`——再去改查询逻辑。

适用边界 · 注意事项

• 任务属于可视化编辑、认证、媒体、草稿、Git 发布（应使用 nuxt-studio skill）或文档正文撰写/重构（应使用 document-writer skill）时。
• 项目未安装或未使用 @nuxt/content 时。
• 待改动的 API 不属于 content 自有范围，而属于 Nuxt、Nuxt UI 或 Vue 时。