perf-theory-gatherer — скилл для Claude Code: гипотезы
Скилл собирает до пяти гипотез о причинах просадки производительности, опираясь на историю git и код.
npx skills add composio-community/awesome-claude-plugins --skill perf-theory-gatherer -a claude-code
npx skills add composio-community/awesome-claude-plugins --skill theory -a claude-codeЧто делает perf-theory-gatherer
Скилл работает по сценарию, который вы описываете: сначала смотрит свежие коммиты в релевантных путях, потом находит задействованные участки кода через карту репозитория или grep. На выходе — список гипотез с доказательством и оценкой уверенности low, medium или high. Больше пяти не выдаёт.
Формат ответа фиксирован: у каждой гипотезы есть id, короткое описание, ссылка на файл или изменение в git и уровень уверенности. Проверка истории git обязательна — без неё гипотезы не строятся. Оптимизаций скилл не предлагает, только версии причин.
Работает он по контракту из docs/perf-requirements.md, поэтому этот файл должен быть в проекте. Если его нет, скилл не получит канонических требований к замеру и разбору — это повод проверить репозиторий до запуска.
Какие задачи решает
- собрать версии причин просадки производительности по истории коммитов
- найти участки кода, задействованные в конкретном сценарии
- отделить гипотезы от готовых советов по оптимизации
- привязать каждую версию к файлу или изменению в git
- ограничить разбор пятью приоритетными гипотезами
Примеры запросов агенту
- разбери сценарий медленной загрузки списка заказов и собери гипотезы по git-истории
- почему тормозит экспорт отчёта — найди код и предложи до пяти версий с доказательствами
- проверь коммиты за последние изменения в модуле поиска и выдай гипотезы с уверенностью
Как установить perf-theory-gatherer
1Через Skills CLI (Vercel)
npx skills add composio-community/awesome-claude-plugins --skill perf-theory-gatherer -a claude-codenpx skills add composio-community/awesome-claude-plugins --skill theory -a claude-code2Вручную: положить файлы
~/.claude/skills/theory/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/theory/
1Через Skills CLI (Vercel)
npx skills add composio-community/awesome-claude-plugins --skill theory -a codex2Вручную: положить файлы
.agents/skills/theory/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add composio-community/awesome-claude-plugins --skill theory -a cursor2Вручную: положить файлы
.cursor/skills/theory/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install composio-community/awesome-claude-plugins theory2Вручную: положить файлы
.github/skills/theory/SKILL.md1Через Skills CLI (Vercel)
npx skills add composio-community/awesome-claude-plugins --skill theory -a gemini-cli2Командой платформы
gemini skills install https://github.com/composio-community/awesome-claude-plugins --path perf/skills/theoryВручную: положить файлы
.devin/skills/theory/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add composio-community/awesome-claude-plugins --skill theory -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о perf-theory-gatherer
Как установить perf-theory-gatherer в Claude?
Выполните npx skills add composio-community/awesome-claude-plugins --skill perf-theory-gatherer -a claude-code. После установки скилл лежит в ~/.claude/skills/theory/SKILL.md.
Что делает perf-theory-gatherer?
Разбирает git-историю и код по заданному сценарию и выдаёт до пяти гипотез о причинах проблем с производительностью, каждую с доказательством и оценкой уверенности.
Нужен ли файл docs/perf-requirements.md?
Да, скилл следует ему как каноническому контракту. Без этого файла в проекте он не получит требований к разбору производительности.