mcpField
W
web-perf

web-perf

github.com/elithrar测试与质量22272 次安装2 周前更新
代码仓库

关于 web-perf

Web performance investigation 是用于诊断网页性能并验证限定范围内修复的技能。它引导开发者分析浏览器跟踪或其他现有证据,并区分实测数据、估算值与假设。

主要功能

  1. 01选择可用的性能分析证据
  2. 02记录设备、缓存与网络条件
  3. 03调查 Core Web Vitals 与性能瓶颈
  4. 04在等效条件下比较修复效果
  5. 05报告测量结果与验证限制

适用场景

  1. 01调查已报告的页面变慢问题
  2. 02利用现有跟踪记录审计性能
  3. 03验证针对性的性能修复

MCP 相关

有条件时优先使用 Chrome DevTools 跟踪;若相关 MCP 服务不可用,则可使用其他分析器或现有产物。它不会要求安装 MCP 服务才能继续基于源代码分析。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/elithrar/dotfiles --skill web-perf

安装后在 Claude Code 中输入/web-perf确认已加载。

附带文件evals/evals.jsonreferences/devtools.md

详细介绍

Web 性能调查

确定目标页面、报告的问题症状以及相关设备条件。对于审计请求,报告调查结果。对于优化或修复请求,在请求范围内实施有依据的更改并验证其效果。

选择证据路径

调用浏览器和性能分析工具前,先检查可用工具。若有 Chrome DevTools 跟踪数据,优先使用;跟踪数据和网络调查请参阅 references/devtools.md。使用已安装工具的架构定义,不要假设示例参数与当前版本一致。

如果 MCP 服务不可用,请使用现有的跟踪数据或 Lighthouse 产物、其他可用的性能分析器,或相关源代码。完成这些来源所支持的分析,并说明哪些内容无法测量。缺少性能分析工具并不意味着可以停止检查源代码,也不应因此强行安装 MCP。

诊断

记录页面/构建版本、视口、设备或模拟环境、网络/CPU 限流、缓存状态,以及与结果相关的交互。仅重新加载页面无法证明缓存处于冷状态。分别记录移动端和桌面端的观察结果。

区分现场 Core Web Vitals 与实验室测量值。仅包含加载过程的跟踪数据无法确定 INP;TBT 是实验室诊断指标,不能替代 INP 测量。评定等级时采用当前的指标定义,并将缺失的测量标记为不可用。

沿着瓶颈,从跟踪数据中的洞察追查到请求、元素或源代码路径。检查相关的 LCP 阶段、造成布局偏移的元素、长任务、延迟发现的资源或缓存标头。建议移除资源前,先确认其归属和用途,尤其是第三方脚本或仅在后续交互中使用的资源。估算节省为零并不代表存在实质性问题,但一次跟踪也无法证明某项资源永远没有用处。

验证并报告

根据观察到的用户影响和结论可信度,对发现进行优先级排序。区分实测值、工具估算值和未经测量的假设;避免承诺可将相互重叠的洞察所示节省量累加。

对于修复,应在等效条件下比较受影响的行为。如果测量结果存在波动,或声称的改进幅度较大,则重复测量。只有在回归风险尚未解决或项目要求必须扩大测试时,才扩大测试范围,然后完成工作。

报告测得的问题症状、有依据支持的原因、具体修复或建议,以及相关验证的局限。若多项测量有助于比较,请添加指标表。不要将性能请求扩展成强制的无障碍审计或全代码库审计。

评论

支持 Markdown