perf-theory-gatherer — субагент для Claude Code: обзор и установка
Субагент perf-theory-gatherer формулирует гипотезы о причинах просадки производительности на основе истории git и метрик. Пригодится при поиске регрессий перед профилированием.
MIT ★ 2 003 обновлён 2026-07-26
/plugin marketplace add composio-community/awesome-claude-plugins
/plugin install perf@awesome-claude-pluginsЧто делает perf-theory-gatherer
Субагент исследует историю коммитов git и текущие метрики проекта, чтобы локализовать узкие места. Он работает на модели opus. При вызове субагент принимает сценарий и границы репозитория, а затем запускает профильный скилл perf-theory-gatherer.
Для сбора данных субагент использует инструмент Read и консольные команды через Bash. Он может обращаться к git, пакетам node, npm, yarn, pnpm, компиляторам cargo и go, тестам pytest и python, а также сборщикам mvn и gradle.
Перед выдачей гипотез субагент строго проверяет файл docs/perf-requirements.md. Без этого документа в репозитории агент просто откажется выводить результаты.
Какие задачи решает
- найти вероятные причины просадки производительности по коммитам
- сформулировать гипотезы о регрессиях перед нагрузочным тестированием
- сопоставить изменения в коде с требованиями из
docs/perf-requirements.md
Примеры запросов агенту
- Проанализируй недавние коммиты и выдвини гипотезы о причинах падения RPS.
- Запусти субагента perf-theory-gatherer для проверки регрессий в API.
Как установить perf-theory-gatherer
1Через маркетплейс плагинов
/plugin marketplace add composio-community/awesome-claude-plugins/plugin install perf@awesome-claude-plugins2Вручную: положить файлы
.claude/agents/perf-theory-gatherer.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/perf-theory-gatherer.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/perf-theory-gatherer.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о perf-theory-gatherer
Как установить perf-theory-gatherer в Claude Code?
Выполните команду /plugin marketplace add composio-community/awesome-claude-plugins, затем установите пакет через /plugin install perf@awesome-claude-plugins. Конфигурация субагента сохранится в .claude/agents/perf-theory-gatherer.md.
Что делает субагент perf-theory-gatherer?
Он изучает историю коммитов git и показатели работы сервиса, после чего формирует проверяемые гипотезы о деградации производительности.
Какой файл обязателен для работы perf-theory-gatherer?
Субагент требует наличия docs/perf-requirements.md. Если файла нет, агент прервёт работу без формирования гипотез.
Исходный текст
perf-theory-gatherer.md · MIT
--- name: perf-theory-gatherer description: Generate top performance hypotheses after reviewing git history and current metrics. tools: Read, Bash(git:*), Bash(node:*), Bash(npm:*), Bash(pnpm:*), Bash(yarn:*), Bash(cargo:*), Bash(go:*), Bash(pytest:*), Bash(python:*), Bash(mvn:*), Bash(gradle:*) model: opus --- # Perf Theory Gatherer Generate hypotheses for performance bottlenecks and regressions. You MUST read `docs/perf-requirements.md` before outputting hypotheses. You MUST execute the perf-theory-gatherer skill to produce hypotheses. Do not bypass the skill. This agent should only add agent-specific context (scenario, repo scope) and then run the skill.
© Community · MIT · composio-community/awesome-claude-plugins