perf-investigation-logger — субагент для Claude Code
Субагент perf-investigation-logger для структурированного документирования исследований производительности. Сохраняет прямые цитаты пользователя, выводы и доказательства в единый лог.
MIT ★ 2 003 обновлён 2026-07-26
/plugin marketplace add composio-community/awesome-claude-plugins
/plugin install perf@awesome-claude-pluginsЧто делает perf-investigation-logger
perf-investigation-logger автоматически создаёт записи анализа производительности в формате, который соответствует вашему контракту в docs/perf-requirements.md. Субагент собирает точные высказывания пользователя, резюме фазы исследования, принятые решения с обоснованием и ссылки на исходные данные — файлы, команды, метрики.
Лог сохраняется в {state-dir}/perf/investigations/<id>.md и включает фазу, дату, цитату, доказательства и решение. Субагент использует переменную окружения AI_STATE_DIR (по умолчанию .claude) и читает, пишет данные напрямую, не обходя механизм логирования.
Требует Claude Code с поддержкой чтения и записи файлов.
Какие задачи решает
- логировать исследования производительности с прямыми цитатами пользователя
- связать решение с доказательствами и точками в коде
- вести структурированный журнал фаз анализа
- соответствовать контракту
perf-requirements.mdпри документировании
Примеры запросов агенту
- Проанализируй, почему выполняется медленнее в
src/render.js, и запиши результаты - Создай запись исследования: попросил пользователь проверить утечку памяти в
components/List - Документируй фазу профилирования с командой
node --prof app.jsи выводами
Как установить perf-investigation-logger
1Через маркетплейс плагинов
/plugin marketplace add composio-community/awesome-claude-plugins/plugin install perf@awesome-claude-plugins2Вручную: положить файлы
.claude/agents/perf-investigation-logger.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/perf-investigation-logger.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/perf-investigation-logger.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о perf-investigation-logger
Как установить perf-investigation-logger в Claude Code?
Выполни последовательно: /plugin marketplace add composio-community/awesome-claude-plugins, затем /plugin install perf@awesome-claude-plugins, и откройте файл .claude/agents/perf-investigation-logger.md.
Что делает perf-investigation-logger?
Сохраняет структурированные записи анализа производительности с цитатами пользователя, фазой, решениями и ссылками на файлы и команды в лог под управлением AI_STATE_DIR.
Нужно ли мне готовить perf-requirements.md перед использованием?
Да, субагент ожидает, что вы следуете контракту в docs/perf-requirements.md как к основному руководству для формата и требований логирования.
Исходный текст
perf-investigation-logger.md · MIT
---
name: perf-investigation-logger
description: Append structured investigation notes with exact user quotes and rationale.
tools: Read, Write
model: sonnet
---
# Perf Investigation Logger
You MUST follow `docs/perf-requirements.md` as the canonical contract.
Append structured investigation notes to `{state-dir}/perf/investigations/<id>.md`.
## Required Content
1. Exact user quotes (verbatim)
2. Phase summary
3. Decisions and rationale
4. Evidence pointers (files, metrics, commands)
## Output Format
```
## <Phase Name> - <YYYY-MM-DD>
**User Quote:** "<exact quote>"
**Summary**
- ...
**Evidence**
- Command: `...`
- File: `path:line`
**Decision**
- ...
```
## Constraints
- Use `AI_STATE_DIR` for state path (default `.claude`).
- Do not paraphrase user quotes.
You MUST execute the perf-investigation-logger skill to produce the log entry. Do not bypass the skill.
© Community · MIT · composio-community/awesome-claude-plugins