Навыки для агентов · Claude Code · Codex · stdlib Python · MIT

Агент для кода работает игровым аналитиком

Поставьте набор в проект игры и просите обычными словами. Агент выгружает сырые события AppMetrica в локальную базу SQLite, разбирается, что значат события именно этой игры, перепроверяет свои числа и выпускает отчёт, который можно переслать кому угодно, — каждый раз в тех же семи блоках.

Открыть живой пример отчёта Звезда на GitHub

Первый экран полного разбора: название — запрос, семь пронумерованных блоков, ключевые метрики со столбцами по версиям
Полный разбор на выдуманных данных: название — это запрос, ключевые метрики по билдам рядом, оценки по выборке устройств помечены ≈.

Как это работает

  1. Установкаpy install.py <project> кладёт в репозиторий игры семь навыков для Claude Code и Codex и небольшой движок. Ставить через pip ничего не надо.
  2. Подключение«Подключи AppMetrica». Агент найдёт ключ SDK в коде, возьмёт токен только на чтение и выгрузит данные в фоне — с выборкой устройств, если игра большая.
  3. Модель«Собери модель данных». Агент читает каталог событий и код аналитики игры, типизирует параметры, отсекает девайсы разработки, определяет сессии и новых игроков.
  4. Вопросы«Сделай полный анализ за две недели». «Где теряем новичков?» «Что изменила 1.2?» Каждый ответ — версионный отчёт, а выводы остаются в проекте для следующей сессии.

Одна структура для каждого отчёта

Читатель и следующий агент находят одно и то же на одном и том же месте. Отчёт со сломанной структурой или ссылками сборщик не соберёт.

1

Краткая информация

Ключевые метрики, столбцы — версии билда: D1/D3/D7, время в игре, сессии, реклама на игрока, ARPU, доход — и короткие ответы на ваши вопросы.

2

Продукт

Ретеншен, отвалы по шагам загрузки и обучения и по каждым 30 с игры, действия ядра по номеру в сессии, уходы после негативных событий, экономика.

3

Доход

Реклама по форматам, плейсментам и сетям; eCPM; покупки.

4

Техника

Техпроблемы и ошибки аналитики: дубли, пустые поля, расхождения источников — и какую метрику каждая искажает.

5

Страны

Разрез по странам в одном месте.

6

Гипотезы

H1, H2… — каждая стоит на числах со ссылками, с проверкой, порогом и уверенностью.

7

Рекомендации

Каждая ссылается на гипотезу, с ожидаемым эффектом и тем, как мерить.

Гипотезы с уверенностью и рекомендации со ссылками на гипотезы
Факты отделены от интерпретаций; каждое число из ответов, гипотез и рекомендаций есть в таблице или на графике выше.

Живые примеры на выдуманных числах: полный разбор · отчёт-вопрос · список отчётов с версиями

Что внутри

Семь навыков

  • analytics-kit — точка входа и шпаргалка команд
  • analytics-connect-appmetrica — ключ, токен, первая выгрузка
  • analytics-data-model — типизированные события, устройства, сессии
  • analytics-project-audit — что трекает код и что доходит
  • analytics-import-external — выгрузки Google Ads, AdMob, GA4, Play Console
  • analytics-research — вопрос → данные → гипотезы → независимая проверка
  • analytics-report — жёсткая структура, графики, версии

Движок, который можно прочитать

  • Только стандартная библиотека Python, Windows на равных
  • AppMetrica Logs API диапазонами дат, выгрузка отдельным фоновым процессом
  • Выборка устройств и защита диска для игр с 500 тысячами событий в день
  • Стандартные таблицы: ключевые метрики, отвалы, действия по номеру, уходы
  • Самодостаточные HTML-отчёты, светлая и тёмная тема, читаются с телефона
  • Офлайн-самопроверка на синтетике; проверено с настоящими агентами

Быстрый старт

Python 3.11+, git, Claude Code или Codex и игра, которая уже шлёт события в AppMetrica.

git clone https://github.com/Trafalgardi/game-analytics-kit.git <kit>
py <kit>/install.py <project>           # python3 на macOS/Linux

# токен AppMetrica только на чтение, один раз на все проекты:
#   ~/.config/game-analytics-kit/.env  →  APPMETRICA_TOKEN=...

cd <project> && claude                   # или: codex
> Подключи AppMetrica и выгрузи последние две недели.
> Собери модель данных.
> Сделай полный анализ игры за последние две недели.

Полная инструкция — токен по шагам, большие игры, обновление, безопасность, частые проблемы — в README на русском.