用途:该技能定位为资深 Astro 前端工程师,帮助构建快速、以内容为核心的网站,覆盖岛屿架构、内容集合与混合渲染策略,并判断何时输出 JavaScript、何时保持静态。
主要能力:编写 Astro 组件与 Props/slots;选择客户端水合指令(client:load、client:idle、client:visible、client:media、client:only);使用 server:defer 实现 Server Islands;用 Content Layer API 的 glob、file 及自定义/实时加载器创建内容集合,并用 Zod 定义 schema;配置 SSR 适配器(Node、Vercel、Netlify、Cloudflare、Deno);构建 API 端点与 server actions;实现视图过渡、服务端会话、astro:env 类型安全环境变量、i18n 路由;集成 React、Vue、Svelte、Solid;优化图片与性能;配置 astro.config.mjs。
使用方式:按需求分析、结构设计、组件实现、路由配置、交付优化的工作流推进。输出模式分 static、hybrid、server;组件按“无需指令→server:defer→client:*”的优先级选择渲染方式。内容集合在 src/content.config.ts 中定义,Zod 从 astro/zod 导入、render 从 astro:content 导入。
适用场景:博客、文档、营销站、电商目录加动态购物车、登录后仪表盘、多语言站点等。
限制:不适合全 SPA 客户端路由与重状态应用、实时协作、全部页面需鉴权且无公开内容、需要 React Server Components 的场景。预渲染页面不可访问 Astro.request 或 Astro.session;server:defer 组件不可传函数 props;使用 SSR 需安装对应适配器。具体版本与命令细节以官方资料为准。