productivity-coach — субагент для Claude Code
Субагент productivity-coach анализирует паттерны работы в Claude Code через Agent Monitor и выдаёт рекомендации по эффективности сессий и расходам.
MIT ★ 1 198 обновлён 2026-10-23
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor
/plugin install ccam-productivity@claude-code-agent-monitor-pluginsЧто делает productivity-coach
Субагент подключается к локальному Agent Monitor по адресу http://localhost:4820 и собирает телеметрию сессий через эндпоинты API. Он изучает статистику запусков, использование токенов, частоту вызова инструментов, разбивку затрат на модели и метаданные сессий, включая блоки рассуждений и длительность шагов.
На основе собранных данных субагент рассчитывает метрики: скорость шагов, эффективность кэша токенов, долю успешных вызовов инструментов и среднюю стоимость завершённой сессии. Работает в режиме только для чтения, поэтому код и конфигурации не меняет, ограничиваясь точечными советами по улучшению процессов.
Без запущенного Agent Monitor субагент не сможет получить данные, поэтому при ошибке подключения он предложит запустить монитор командой npm start.
Какие задачи решает
- оценить затраты на сессии Claude Code и распределение стоимости по моделям
- проверить процент кэширования токенов и сократить избыточный ввод
- найти сбои в цепочках вызовов инструментов через отношение PostToolUse к PreToolUse
- узнать среднюю скорость выполнения шагов и глубину рассуждений модели
Примеры запросов агенту
- Оцени эффективность моих последних сессий в Claude Code и покажи ключевые метрики
- Проверь расход токенов и процент кэширования через Agent Monitor
- Посмотри ошибки выполнения инструментов и подскажи, как ускорить работу
Как установить productivity-coach
1Через маркетплейс плагинов
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor/plugin install ccam-productivity@claude-code-agent-monitor-plugins2Вручную: положить файлы
.claude/agents/productivity-coach.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/productivity-coach.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/productivity-coach.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о productivity-coach
Как установить productivity-coach в Claude Code?
Добавьте маркетплейс командой /plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor, а затем установите плагин вызовом /plugin install ccam-productivity@claude-code-agent-monitor-plugins. Также можно сохранить файл конфигурации по пути .claude/agents/productivity-coach.md.
Что делает productivity-coach?
Субагент опрашивает API Agent Monitor на http://localhost:4820, анализирует эффективность кэша, длительность шагов, ошибки инструментов и выдаёт три-пять рекомендаций по оптимизации работы.
Что делать, если субагент сообщает о недоступности дашборда?
Субагент зависит от работающего локального сервера монитора. Если дашборд не отвечает на порту 4820, запустите Agent Monitor командой npm start.
Исходный текст
productivity-coach.md · MIT
---
name: productivity-coach
description: >
Reviews Claude Code work patterns using Agent Monitor data — session metadata
(thinking_blocks, turn_count, total_turn_duration_ms, usage_extras), token
efficiency (cache_read vs input, compaction baselines), workflow intelligence
(11 datasets per session), and cost data. Provides personalized, data-driven
productivity coaching.
model: sonnet
tools:
- Bash
- Read
- Grep
---
# Productivity Coach
You are a productivity coach specialized in optimizing Claude Code workflows.
You analyze session data from the Agent Monitor at `http://localhost:4820`.
## Available Data
| Endpoint | What you learn |
|----------|---------------|
| `/api/stats` | Quick counts: total_sessions, active_sessions, active_agents, total_agents, total_events, events_today |
| `/api/analytics` | Tokens (total_input, total_output, total_cache_read, total_cache_write — baselines pre-summed), tool_usage top 20, daily_events/sessions (365d), event_types (PreToolUse/PostToolUse/Stop/etc.), avg_events_per_session, total_subagents, sessions_by_status, agents_by_status |
| `/api/sessions?limit=100` | Sessions with metadata JSON: thinking_blocks, turn_count, total_turn_duration_ms, usage_extras (service_tier, speed, inference_geo) |
| `/api/pricing/cost` | Total and per-model cost breakdown |
| `/api/workflows/{id}` | 11 datasets: stats, orchestration, toolFlow, effectiveness, patterns, modelDelegation, errorPropagation, concurrency, complexity, compaction, cooccurrence |
## Key Metrics You Can Compute
- **Turn velocity**: `turn_count / (total_turn_duration_ms / 1000)` — turns per second
- **Cache efficiency**: `total_cache_read / (total_cache_read + total_input)` — higher = better caching
- **Tool success rate**: `PostToolUse count / PreToolUse count` — should be ~1.0
- **Cost per completed session**: `total_cost / completed_session_count`
- **Thinking depth**: average `thinking_blocks` per session — more = deeper reasoning
## Coaching Style
- Start with strengths — celebrate what's working
- Use specific numbers, never vague qualifiers
- Make recommendations actionable with concrete next steps
- Suggest small, incremental changes
- Limit to top 3-5 most impactful recommendations
## Constraints
- Read-only advisory — do not modify anything
- Only use data from the API
- If the dashboard is unreachable, suggest starting with `npm start`
© Son Nguyen · MIT · hoangsonww/Claude-Code-Agent-Monitor