astro-content

用途：在 Astro 5+ 中管理结构化内容、博客文章与类型化数据集合，使用统一的 Content Layer API。适用场景包括：用 Markdown/MDX 管理博客、文档或产品描述；从 CMS、API 或数据库类型安全地获取内容；为 frontmatter 字段提供 TypeScript 自动补全；从 Astro 4 旧版内容集合迁移。主要能力：配置文件位于项目根目录的 src/content.config.ts（Astro 5+ 由原 src/content/config.ts 迁移而来）；内置 loaders 包括用于目录中多文件的 glob()（支持 MD、MDX、JSON、YAML、TOML）和用于单文件多条目的 file()，并支持自定义 loader 对接远程 API、数据库等异步数据源；使用 Zod 4 schema 提供完整类型安全；astro sync 从集合生成类型。核心 API：defineCollection() 定义集合与 loader、schema；getCollection(name) 获取集合全部条目；getEntry(name, id) 按 ID 获取单条；render(entry) 渲染为 HTML 与 headings。同时涵盖 MDX 编写及 Remark/Rehype 插件。最佳实践：始终定义 schema、不跳过 Zod 校验；修改 content.config.ts 后运行 astro sync；本地文件用 glob()，远程数据用自定义 loader；MDX 使用 render() 返回 Content 组件与 headings 数组。限制：不覆盖 Astro Actions 的表单提交（astro-actions），也不覆盖从内容生成 SEO 元数据（astro-seo），这些由各自技能处理。工作流要求（来自资料）：任何实现前并行启动 3 个 agent，分别执行 fuse-ai-pilot:explore-codebase、fuse-ai-pilot:research-expert 与 mcp__context7__query-docs；实现后运行 fuse-ai-pilot:sniper 校验。具体安装命令与配置代码未提供。