用途：在编辑 Astro 项目时提供按任务分流的参考指引，覆盖 .astro/.mdx 文件、astro.config.*、内容集合、客户端指令、Actions/表单、Tailwind CSS、视图过渡与服务端特性。核心原则是以项目已安装的 Astro 版本和本地约定为唯一事实来源，参考文档记录的是 Astro 7 的当前模式与常见迁移陷阱，不构成用户请求之外的广泛重构理由。
主要能力：按任务路由到对应参考文件，包括核心模式与路由、内容集合与 Zod 4、博客配方（RSS、分页、标签、SEO、TOC、Shiki、Markdown/MDX 定制）、Tailwind v4、岛屿与 client:* 水合、Actions 与表单、视图过渡、服务端特性（预渲染、会话、环境变量、i18n、CSP、缓存、Cloudflare）以及官方文档检索。
使用方式：先读 package.json、锁文件、astro.config.* 和目标文件，确认已安装的 Astro、Node、适配器、集成与内容配置；只读与任务匹配的参考，不预加载全部；对版本敏感或不熟悉的 API，用官方文档能力核实当前行为；做最小改动并保持仓库的组件、样式与部署约定；运行相关类型检查、构建与测试，对可见行为渲染受影响路由并验证相关状态。
兼容性基线：内容使用 src/content.config.ts、每个集合有 loader、从 astro/zod 导入 z、调用独立 render(entry)；Tailwind 使用已安装的 v4 配置，通常为 @tailwindcss/vite 加 @import "tailwindcss"，不重新引入已弃用的 @astrojs/tailwind；Markdown/MDX 在 Astro 7 默认 Sätteri，通过 markdown.processor 选择；水合按需选择 client:load、client:idle 或 client:visible；变更优先用类型化 Actions；环境变量优先用 schema 支持的 astro:env；ClientRouter 用 astro:page-load 初始化、对替换元素用事件委托、在 astro:before-swap 设置预绘制状态；Astro 7 要求 Node 22.12+、Vite 8、ESM 配置。已移除的 Astro.glob()、entry.render()、旧集合位置/类型、output: 'hybrid'、CJS 配置与 <ViewTransitions /> 不应写入新代码。
限制：模板仅为起点，需与已安装集成和部署目标兼容；构建通过不能证明水合时机、ClientRouter 生命周期或响应式布局正确；若环境无法运行相关检查，应如实报告缺口。