SuperAPI AI 工具集

specsfy-specialist-astro

前端与建站

查看项目

更新于 10-16 08:07

技能介绍

用途:当项目包含 astro.config 或 astro 依赖,且任务涉及页面、布局、.astro 组件、内容集合、端点或交互岛时使用;也用于决定输出模式(static/server)、选择合适的 client:* 指令,或诊断发送到客户端的 JS 过大问题。不用于岛内 React/Vue/Svelte 组件的内部逻辑,那属于对应框架技能;本技能只负责何时以及如何水合。

主要能力与流程:先确认 Astro 版本、输出模式、adapter、启用的集成与内容来源(Markdown、MDX、远程 CMS),再给出建议。将每条改动路由归类为静态、按需服务端渲染或端点。默认保持静态 HTML 与零 JS,只对需要交互的组件水合,并选用最严格的 client:* 指令。用内容集合与显式 Zod schema 建模内容,把无效 frontmatter 视为构建错误。按路由定义缓存、响应头、资源与图片(astro:assets)。

使用方式与验证:运行 astro check、项目测试套件与完整生产构建;在禁用 JavaScript 下检查 HTML 仍可导航可读,再逐个验证岛的注水;检查内部链接、404/500 页面、优化图片及 RSS/sitemap/元数据;在目标 adapter 的真实运行时预览,测量每路由 JS 体积与 Core Web Vitals。

限制与注意:不要在边缘 adapter 中假设完整的 Node API(fs、process),使用 server-only 依赖前先确认目标运行时。不要默认对所有岛使用 client:load;不要向岛传递超出其渲染所需的数据;不要用无 schema 的内容集合;不要为单条需要 SSR 的路由而让整站使用 server 输出。不要用 Next.js 技能做本项目决策。更多渲染模式、岛、内容集合、actions、图片与部署细节见 references/standards.md。