perf-guard
Measure REAL web performance with a budget and regression diff — runs Lighthouse CLI (mobile + desktop) or PageSpeed Insights API against a production URL, checks metrics against a perf-budget, and diffs runs. Never trusts chrome-devtools MCP traces (falsely optimistic). Use when user says "замерь перформанс", "проверь скорость сайта", "lighthouse", "core web vitals", "perf budget", "регрессия скорости", or types /perf-guard.
来源信息
- 仓库
- 1t1sCooL/claude-skills
- 最近来源活动
- 2026年6月22日 13:50
- 检测到的 SKILL.md 语言
- 俄语
- 星标
- 10
- 分支
- 0
安装方式
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
检查来源文件
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
文件资源管理器
2 个文件正在显示 SKILL.md
SKILL.md
来源说明 · 只读预览- name
- perf-guard
- description
- Measure REAL web performance with a budget and regression diff — runs Lighthouse CLI (mobile + desktop) or PageSpeed Insights API against a production URL, checks metrics against a perf-budget, and diffs runs. Never trusts chrome-devtools MCP traces (falsely optimistic). Use when user says "замерь перформанс", "проверь скорость сайта", "lighthouse", "core web vitals", "perf budget", "регрессия скорости", or types /perf-guard.
- argument-hint
- <url> [url2 ...] | --compare <runA.json> <runB.json> [--budget perf-budget.json]
- allowed-tools
- Read Write Edit Bash(node *) Bash(npx *) Bash(curl *) WebFetch
# Perf Guard
Измерение **реального** перформанса с бюджетом и диффом регрессий.
> ⚠️ **Главное правило скилла.** MCP `chrome-devtools` performance-trace даёт
> **ложно-оптимистичные** цифры (быстрый локальный прогон без троттлинга/сети).
> Для вердикта используем ТОЛЬКО реальный Lighthouse (CLI) или Google PageSpeed
> Insights API против **прод-URL**. Никогда не выноси вердикт по chrome-devtools trace.
## Что на входе (`$ARGUMENTS`)
- **URL** (один или несколько) — прогнать аудит.
- **`--compare <runA.json> <runB.json>`** — таблица «было→стало» по сохранённым прогонам.
- **`--budget <path>`** — файл бюджета (по умолчанию `./perf-budget.json`; если нет — создать дефолтный).
## Требования окружения
- **Node 18+**.
- Для CLI-режима — установленный **Google Chrome** + `lighthouse` (используется через `npx lighthouse`).
- Фолбэк — **PSI API** (ключ опционален, без ключа есть лимиты): `https://www.googleapis.com/pagespeedonline/v5/runPagespeed`.
- Скрипт движка: `scripts/perf.mjs` рядом с этим SKILL.md — запускать по абсолютному пути.
## Шаги
1. **Прогнать реальный замер** через движок (CLI Lighthouse, фолбэк PSI), mobile + desktop:
```bash
node <путь>/scripts/perf.mjs <url> --device both --out ./perf-guard-output/run.json
```
JSON прогонов складывать в `./perf-guard-output/`.
2. **Вытащить метрики:** Performance score, LCP, CLS, TBT, FCP, TTI, Speed Index, общий вес (transfer size).
3. **Сверить с бюджетом** (`perf-budget.json`). Если файла нет — создать дефолтный (разумные пороги mobile) и сообщить:
```json
{ "performance": 0.9, "lcp_ms": 2500, "cls": 0.1, "tbt_ms": 200, "fcp_ms": 1800, "weight_kb": 1500 }
```
По каждой метрике — **pass/fail** относительно порога.
4. **`--compare`** — таблица «было→стало» с дельтами; пометить регрессии (стало хуже порога чувствительности).
## Выход
- `./perf-guard-output/report.md` — метрики mobile/desktop, статус по бюджету (✓/✗), дельты при сравнении, краткие рекомендации.
- Сырые JSON прогонов в `./perf-guard-output/`.
- Явная пометка, каким движком измерено (Lighthouse CLI / PSI) — и напоминание, что chrome-devtools trace не использовался.
在 GitHub 查看