用途：web-perf 专注于首屏加载时用户可见的视觉缺陷，适用于未依赖框架字体/图片层、而是手写加载逻辑的技术栈，例如手写 @font-face、从 Google Fonts 等托管 CDN 拉取字体、使用原生 <img>、在文档 head 中自行添加资源提示。若框架已自动处理（如 Next 的 next/font/next/image、Astro 的 Fonts API），应优先采用框架输出，但包裹它的应用代码仍在范围内。
主要能力：以“症状→原因→修复→验证”为核心循环。先判断 HTML 是构建时固定（静态预渲染）还是按请求渲染（SSR），且按路由而非整站判断。通过症状决策树定位问题，再应用对应修复，最后在冷缓存下验证。修复按所影响的 Web Vital（LCP/CLS/INP/TTFB/FCP）标记。
使用方式：从 references/symptoms.md 开始诊断，按 fonts、hosted-fonts、images、resource-hints 等参考文档应用修复，并用 references/verify.md 验证。提供脚本模板：check-dist.mjs 做构建产物守卫，check-head.mjs 做已启动路由守卫，font-subset.config.mjs 共享覆盖模块，lh-ab.mjs 做本地 Lighthouse A/B。
适用场景：首屏字体闪烁、图片解码弹出、布局偏移、LCP/FCP 慢、先空白后绘制、水合或主题翻转等。
限制：不涉及后端/TTFB 延迟、打包体积分析、运行时交互调优（水合翻转之外的 INP）或 SEO。嵌入式/宿主拥有的界面（MCP 组件、Devvit iframe、CSP 强制单文件）因宿主控制 head/headers，提示与缓存手段不适用。动画设计、will-change 等属于其他技能。