metrics — команда для Claude Code: сводка по ходам
Собирает записи хука track-metrics в короткую сводку: сколько было ходов, какие файлы менялись и какие коммиты вышли.
MIT ★ 1 424 обновлён 2026-10-06
.claude/commands/metrics.mdЧто делает metrics
Команда читает .claude/agent-metrics.jsonl — файл, куда хук track-metrics пишет по одной записи на каждый ответ агента. Из этих строк складывается обзор: сколько ходов всего, сколько набралось за последние 7 дней, сколько файлов в среднем правится за ход.
Дальше идёт таблица десяти последних ходов: время в UTC, число изменённых файлов, короткое сообщение коммита. Отдельным блоком — закономерности: где правок было много, как часто появляются коммиты, сколько ходов прошло без изменений в файлах. Инструменты у команды скромные: Read, Bash, Glob.
Записи пишет хук, а не сама команда. Если track-metrics не подключён, файла не будет, и /metrics ответит, что метрик пока нет.
Какие задачи решает
- узнать, сколько ходов записано всего и за последние 7 дней
- найти ходы, где не изменился ни один файл
- посмотреть последние коммиты рядом с ходами
- оценить, сколько файлов в среднем правится за один ход
- заметить, когда правок за ход стало больше обычного
Примеры запросов агенту
- Запусти
/metricsи покажи, сколько ходов записано за неделю. - Собери
/metricsи найди ходы, где не менялся ни один файл. - Выведи через
/metricsтаблицу последних десяти ходов с коммитами.
Как установить metrics
Вручную: положить файлы
.claude/commands/metrics.mdВызов — /metrics. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/metrics.mdВызов — /prompts:metrics. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/metrics.prompt.mdВручную: положить файлы
.gemini/commands/metrics.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о metrics
Как установить metrics в Claude Code?
Положите файл команды по пути .claude/commands/metrics.md в проекте. После этого вызывайте её как /metrics.
Что делает команда metrics?
Разбирает .claude/agent-metrics.jsonl, который наполняет хук track-metrics, и печатает обзор ходов, таблицу последних десяти записей и замеченные закономерности.
Почему /metrics пишет, что метрик нет?
Записи появляются только от хука track-metrics: без него файла .claude/agent-metrics.jsonl не существует, и команде нечего разбирать.
Исходный текст
metrics.md · MIT
--- allowed-tools: Read, Bash, Glob description: "Summarise the per-turn records written by the track-metrics hook: activity over time, files changed, and latest commits." --- ## Context - Metrics file: !`cat .claude/agent-metrics.jsonl 2>/dev/null || echo "NO_METRICS_FILE"` ## Task Analyze the recorded metrics and present a summary. **If the metrics file does not exist or the context above shows "NO_METRICS_FILE":** Print exactly: "No metrics recorded yet. Metrics are automatically collected after each turn." **If metrics data exists**, parse each JSON line and present: 1. **Overview** - Total turns logged (the hook writes one record each time Claude finishes responding) - Turns in the last 7 days (compare timestamps to now) - Average files changed per turn 2. **Recent Turns** (last 10) Format as a markdown table: | # | Timestamp (UTC) | Files Changed | Commit | | --- | --------------- | ------------- | ------ | - Show the most recent 10 turns, newest first - For "Commit", show the short commit message or "—" if none 3. **Patterns** - Note any trends (e.g., turns with many file changes, frequency of commits) - If there are turns with 0 files changed, note how many were "no-op" turns Keep the output concise and well-formatted.
© CloudAI-X · MIT · CloudAI-X/claude-workflow-v2