SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场web-quality-audit

web-quality-audit

测试与质量

查看项目

更新于 10-15 10:32

技能介绍

用途

web-quality-audit 是一个以证据为导向的网站质量审计技能，将实时浏览器证据与源码检查结合，覆盖性能、无障碍、SEO、最佳实践和智能体浏览（Agentic Browsing）五个类别，且不把聚合分数当作质量的证明。

主要能力

审计流程如下：

  1. 确立审计目标：代表性 URL、重要状态与流程、公开与登录访问、移动/桌面范围。
  2. 若页面可运行，先阅读测量工作流并采集最小化的实时基线，再广泛搜索代码库。
  3. 用运行时失败来定位源码检查，将实测发现与仅存在于代码中的假设分开。
  4. 按用户影响和置信度分类，然后实施或建议具体修复。
  5. 重新运行等效自动检查与受影响的手动流程，报告哪些已验证、哪些仍需现场或人工验证。

工具路由原则：使用已有最佳能力，不因可选设置阻塞审计。性能与 Core Web Vitals 优先录制浏览器性能 trace 并分析聚焦洞察（Chrome DevTools MCP 下用 performance_start_trace 再 performance_analyze_insight），回退为 Lighthouse CLI 或 PageSpeed Insights 实验室数据；真实用户性能优先使用当前 DevTools trace 摘要中的 CrUX 值，回退为 PageSpeed Insights/CrUX Vis，仅在已有密钥或要求自动化时直接调用 CrUX API；无障碍、SEO、最佳实践、智能体浏览优先运行实时 Lighthouse 审计（Chrome DevTools MCP 下用 lighthouse_audit），回退为分类 Lighthouse CLI 审计加手动检查；渲染语义与交互优先检查无障碍树并操作 UI（Chrome DevTools MCP 下用 take_snapshot 与聚焦的 evaluate_script），回退为浏览器/手动测试；源码冒烟测试用 scripts/analyze.sh <path>，回退为直接源码检查。注意 Chrome DevTools MCP 的 lighthouse_audit 有意排除性能；其导航模式会重载页面，需保留当前已登录或用户创建状态时用快照模式。静态分析器是快速冒烟测试，不能替代渲染页面审计。

审计类别要点

性能：Core Web Vitals 需达标——LCP < 2.5s、INP < 200ms、CLS < 0.1。资源优化包括图片压缩（WebP/AVIF 加回退、srcset 正确尺寸）、最小化 JavaScript（移除未用代码、代码分割、延迟非关键脚本）、优化 CSS（提取关键 CSS、移除未用样式、避免 @import）、高效字体（font-display: swap、预加载关键字体、子集化）。加载策略包括预连接来源、预加载关键资源、懒加载首屏以下内容、有效缓存。

无障碍：可感知（图片有意义的 alt、装饰图 alt=""、对比度普通文本至少 4.5:1、大文本 3:1、不单靠颜色、视频字幕与音频转录）；可操作（键盘可访问、无键盘陷阱、焦点可见、跳过链接、时间充足、无自动前进内容）；可理解（html 设置 lang、导航一致、错误识别、标签与说明）；健壮（有效 HTML、无重复 ID、正确嵌套、正确使用 ARIA、名称/角色/值）。

SEO：可抓取性（有效 robots.txt、XML 站点地图、规范 URL、重要页面无 noindex）；页面 SEO（唯一标题标签、元描述、标题层级、描述性链接文本）；技术 SEO（移动友好、点击目标 ≥ 48px、HTTPS、页面体验信号、结构化数据 JSON-LD）。

最佳实践：安全（全站 HTTPS、无混合内容、启用 HSTS、无漏洞库、CSP 头、生产构建不暴露 source map）；现代标准（无废弃 API、有效 doctype、声明字符集、无浏览器错误）；UX 模式（无侵入式插页、清晰权限请求、无误导按钮）。

智能体浏览：将 Lighthouse Agentic Browsing 结果作为助手理解与交互渲染页面的技术信号。可访问的交互面要求语义 HTML、标签、名称、角色和状态在无障碍树中暴露有意义的控件；WebMCP 集成存在时有效，应审查注册工具、schema 和表单覆盖，不要仅为提高审计分数而添加 WebMCP；llms.txt 是可选的，有效文件可能帮助兼容工具发现精选内容，但 Lighthouse 通过并不证明搜索或 AI 产品会摄取、排名或引用它。此类别应与 SEO 声明分开，智能体可浏览性不是搜索排名或 AI 可见性的证据。

严重级别

Critical：安全漏洞、完全失败，立即修复。High：Core Web Vitals 失败、重大无障碍障碍，发布前修复。Medium：性能机会、SEO 改进，本迭代内修复。Low：次要优化、代码质量，方便时修复。

输出格式

审计发现按以下结构组织：审计结果（证据表格，含信号、范围/条件、结果、来源）、Critical 问题、High 优先级、摘要（性能、无障碍、SEO、最佳实践、智能体浏览各自状态与发现数）、建议优先级、验证（同条件下重跑、手动检查完成、现场验证仍待定）。

快速清单

每次部署前：Core Web Vitals 通过、无无障碍错误（axe/Lighthouse）、无控制台错误、HTTPS 正常、元标签存在。每周：检查 Search Console 问题、审查 Core Web Vitals 趋势、更新依赖、用屏幕阅读器测试。每月深度：完整 Lighthouse 审计、性能剖析、与真实用户的无障碍审计、SEO 关键词审查。

适用场景与限制

适用于被要求“审计我的网站”等场景，需要结合实测与源码给出可验证的质量结论。限制：不以聚合分数作为质量证明；静态分析器不能替代渲染页面审计；Chrome DevTools MCP 的 lighthouse_audit 不含性能；智能体可浏览性不等于搜索排名或 AI 可见性；部分结论仍需现场或人工验证。