# perf

Команда perf ведёт расследование производительности по фазам: базовый замер, поиск точки отказа, профилирование, оптимизация и решение по цифрам.

- команда · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 2003 у репозитория
- Автор: Community
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/composio-community/awesome-claude-plugins/tree/HEAD/perf/commands/perf.md
- Обновлён: 2026-07-26
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/commands/perf

## Что делает

Команда разбивает разбор производительности на фазы: `setup`, `baseline`, `breaking-point`, `constraints`, `hypotheses`, `code-paths`, `profiling`, `optimization`, `decision` и `consolidation`. Каждая фаза — отдельный шаг с сохранением состояния, поэтому расследование можно прервать и потом вернуться к нему через `--resume`.

Замер настраивается флагами. `--command` задаёт команду бенчмарка, `--duration` ограничивает прогон (по умолчанию 60s), а `--runs` вместе с `--aggregate` (по умолчанию median) нужны для замеров от старта до конца. Точку отказа команда ищет перебором значения из переменной окружения `--param-env` (по умолчанию `PERF_PARAM_VALUE`) в диапазоне от `--param-min` до `--param-max`. Потолки по ресурсам задают `--cpu` и `--memory`, по умолчанию 1 и 1GB.

Состояние расследования лежит в `{state-dir}/perf/investigation.json`. Требования и методику команда берёт из `docs/perf-requirements.md` и `docs/perf-research-methodology.md`. Доступ к Bash ограничен git, node, npm, pnpm, yarn, cargo, go, pytest, mvn и gradle. Ваш бенчмарк должен печатать маркеры `PERF_METRICS` — на них строятся все замеры, так что молчаливый скрипт оставит команду без цифр.

## Установка

### Claude Code (родная платформа)

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add composio-community/awesome-claude-plugins
```
В чате агента (не в терминале):
```text
/plugin install perf@awesome-claude-plugins
```

2. **Вручную: положить файлы**
- Файл: `.claude/commands/perf.md` — Вызов — /perf. Для всех проектов — ~/.claude/commands/

### Codex

**Вручную: положить файлы**
- Файл: `~/.codex/prompts/perf.md` — Вызов — /prompts:perf. В Codex этот формат помечен устаревшим, замена — скиллы

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/prompts/perf.prompt.md`

### Gemini CLI

**Вручную: положить файлы**
- Файл: `.gemini/commands/perf.toml` — Gemini хранит команды в TOML: текст запроса — в поле prompt

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/composio-community/awesome-claude-plugins/tree/HEAD/perf/commands/perf.md

## Когда брать
- снять базовый замер до правок и не потерять цифры
- найти точку отказа, поднимая параметр от минимума к максимуму
- подтвердить гипотезу об узком месте через профилирование
- прогнать оптимизацию под ограничением CPU и памяти
- зафиксировать решение продолжать или остановиться с обоснованием

## Примеры запросов агенту
- Запусти `/perf --scenario "горячий путь в API"` и сними базовый замер до оптимизации.
- Продолжи расследование с фазы профилирования: `/perf --resume --phase profiling`.
- Запиши решение: `/perf --phase decision --verdict continue --rationale "цифры стабильны между прогонами"`.

## Похожие
- [w-perf](https://affpapa.org/nevibecode/skills/w-perf.md) — скилл · 647 установок
- [benchmark-checklist](https://affpapa.org/nevibecode/skills/benchmark-checklist.md) — скилл · 9100 установок
- [android-benchmark-comparison](https://affpapa.org/nevibecode/skills/android-benchmark-comparison.md) — скилл · 559 установок
- [performance-monitor](https://affpapa.org/nevibecode/plugins/performance-monitor.md) — плагин · ★ 2858 у репозитория
- [perf-profile](https://affpapa.org/nevibecode/skills/perf-profile.md) — скилл · 692 установки
- [perf-profiler](https://affpapa.org/nevibecode/plugins/perf-profiler.md) — плагин · ★ 2858 у репозитория

Из того же набора: [composio-community/awesome-claude-plugins](https://affpapa.org/nevibecode/by/composio-community/awesome-claude-plugins.md) — 68 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
