igamingsychov

second-deposit Skill

根据运营商后台导出数据(存款,尽量加上提款、奖金、投注、玩家),分析玩家首次存款(FTD)后为何不做二次存款。为每个 FTD 归入 12 种原因之一,按原因统计二次存款缺口和 Sum Dep 金额,共 24 项二次存款、现金、提款、奖金和游戏指标,找出 STD 偏低的切分,并整理近期 FTD 名单供 CRM 使用,附玩家状态和所在国的规则(法定付款期限、禁用支付方式、法定存款限额)。用户提到"二次存款"、"STD"、"为什么不做二次存款"时使用。

安装方式:把技能目录放入 ~/.claude/skills/(Claude Code)或在 claude.ai 设置中启用;也可复制右侧安装命令一键添加。

查看源码

技能指令原文(SKILL.md)

Второй депозит

Скилл отвечает на вопрос "почему FTD не возвращаются и сколько это стоит". Считает код, модель только сопоставляет колонки и пересказывает итоги. Данные игроков не покидают компьютер: скрипты печатают агрегаты, списки игроков пишут в файлы.

Папка скилла: та, где лежит этот файл (обычно ~/.claude/skills/second-deposit). Нужен только python3 (3.9 и новее), сторонние библиотеки не нужны.

Правила приватности (строго)

  1. Не открывай выгрузки и не читай их строки: ни Read, ни cat, ни head. Все, что нужно для сопоставления, печатает sd_inspect.py, он скрывает ID, суммы и свободный текст.
  2. Не открывай rescue_list.csv, excluded_rg.csv и файлы в папке lists, в них ID игроков. Пересказывай пользователю итоги из summary.json.
  3. Не отправляй данные никуда: никаких загрузок, веб-сервисов и внешних API.
  4. Если пользователь сам вставил строки с данными игроков в чат, не повторяй их в ответе.

Как скилл учится под проект

  • Есть история. Полный запуск по выгрузке за 60-120 дней собирает профиль проекта profile.json: второй депозит за 24 часа, 72 часа, 7 и 30 дней, кривые возврата по каждой причине и у нормы, норма похожих игроков, додепы (сумма второго депозита, второй к первому, депозитов у вернувшегося, Sum Dep), апрув по странам и способам оплаты, время выплаты. Ежедневные запуски берут вводные из профиля и считают прогноз по списку на сегодня. Профиль обновляется каждым полным запуском.
  • Истории нет. Публичного бенчмарка второго депозита нет: открытых цифр с методикой не нашлось ни по одной стране, поэтому скилл не подставляет чужие цифры. Причины, действия и правила стран работают с первого дня. Норма, прогноз и деньги появляются с 8-го дня: когда у первых FTD пройдет 7 дней и таких FTD наберется 50, скрипт сам перейдет на полный расчет и сохранит профиль. Если пользователь просит ориентиры или нормы рынка, скажи именно это и не называй цифр.
  • Правила стран (references/geo_rules.json, описание и официальные источники в geo_rules.md): порог долгого вывода по законному сроку страны, если он короче 24 часов (Бразилия 2 часа, Колумбия 12); запрещенные в стране способы оплаты не подсказываются; при отказе по лимиту депозитов другой способ не предлагается, действие "объяснить лимит"; игрок с блокировкой гемблинга в банке исключается, как флаг ответственной игры. Чтобы фильтр способов работал точно, добавь в mapping.json поле method_types: каждому способу оплаты из выгрузки тип card, credit_card, instant_bank, online_banking, ewallet, voucher_cash, mobile_money или crypto (без него тип угадывается по названию). Если страны в выгрузке нет, а проект работает в одной стране, запускай с --country BR.

Два режима

  • Полный (первый запуск, потом раз в месяц): выгрузка за 60-120 дней. Причины, недобор вторых депозитов и Sum Dep (вилка от и до) против нормы похожих игроков, показатели, срезы, список. Сохраняет профиль проекта profile.json.
  • Список (каждый день): выгрузка за последние 7 дней с датой первого депозита у игроков. Причины и список на сегодня; способы оплаты, история причин и прогноз из профиля. Скрипт сам выбирает режим: если FTD старше 7 дней меньше 50, это режим списка.
  • Обе выгрузки кладутся в одну рабочую папку проекта, результат всегда в <папка>/second-deposit: там живут профиль и журнал rescue_log.csv. Не меняй папку результата между запусками, иначе пропадут профиль и журнал.
  • С "latest": true у файлов в mapping.json и маской в path (deposits*.csv) скрипт берет самую свежую выгрузку по времени изменения: ежедневные файлы копятся в одной папке, а раз в месяц туда же кладется выгрузка за 60-120 дней, и профиль пересчитывается сам.
  • В списке 20% игроков (без сервисных случаев) уходят в контрольную группу: им не пишут 7 дней. Журнал копит, кто вернулся, и отчет показывает эффект действий против контрольной группы, когда у игроков пройдет 7 дней.

Порядок работы

  1. Найди выгрузки. Спроси папку, если пользователь ее не назвал.
  • Человек не знает, что выгружать: дай путь к examples/export-example.xlsx (листы "Инструкция" и "Колонки" объясняют, что и откуда брать) и скажи коротко: в первый раз депозиты со всеми попытками за 60-120 дней, желательно выводы, бонусы, ставки по дням и список игроков; дальше каждый день то же за последние 7 дней, у игроков дата первого депозита; названия колонок могут быть свои.
  • Выгрузки делает аналитик или администратор базы: дай examples/export-queries.sql. В нем запрос на каждый файл с теми же названиями колонок, что в примере, и минимум одним запросом (депозиты и выводы с данными игрока в строке, 7 из 12 причин). Для таких CSV готовы examples/mapping-csv-example.json и examples/mapping-one-file-example.json.
  • Данные в Google Таблицах: не открывай ссылку и не скачивай по ней. Попроси пользователя скачать книгу: Файл, Скачать, Microsoft Excel (.xlsx), все листы попадут в один файл, и положить его в папку. Ссылка, которая открывается без входа в аккаунт, видна любому, у кого она есть, поэтому для данных игроков не подходит.
  • Выгрузок нет, но хочется посмотреть: python3 scripts/make_demo.py <папка>/demo --xlsx создаст вымышленную книгу export.xlsx в формате примера и готовый mapping.json, переходи к шагу 4.
  1. Посмотри структуру: python3 scripts/sd_inspect.py <папка или файлы>.
  2. Собери mapping.json в папке с выгрузками.
  • Книга в формате примера (листы "Депозиты", "Выводы", "Бонусы", "Ставки", "Игроки" с теми же колонками): скопируй examples/mapping-example.json, поменяй path на имя файла и сверь статусы с обзором.
  • CSV по export-queries.sql: скопируй mapping-csv-example.json (файл на лист) или mapping-one-file-example.json (один файл) и сверь статусы с обзором. В них уже маски и "latest": true для ежедневных выгрузок.
  • Свои выгрузки: собери по образцу из references/data.md. Сопоставь колонки с полями (player_id, time, amount, status и т.д.), разнеси каждое значение статуса и типа операции, флаги ответственной игры (самоисключение, лимиты, тайм-аут, признаки риска) перечисли в players.rg_flags, укажи валюту отчета, fx, dayfirst, decimal, tz, если обзор показал такой формат.
  • Статусы депозитов: success только успешный; declined отказ банка, провайдера или ошибка; abandoned игрок отменил, бросил или оплата истекла; cancelled для депозита тоже неудачная попытка; pending не учитывается. Статусы выводов: declined и cancelled не считаются, pending считается запросом на вывод.
  • Причина отказа у депозитов: если обзор показал такую колонку, сопоставь ее как reason и разнеси в decline_reasons: в limit только значения про лимит депозитов (лимит игрока или законный), в block только значения, где прямо сказано, что гемблинг заблокирован банком или самим игроком. Общие отказы банка ("Do not honor", "Insufficient funds", ошибки 3DS) не трогай: это обычный отказ, ему подсказывается другой способ оплаты.
  • Колонки с именами, email, телефонами, адресами никогда не сопоставляй. Если обзор их показал, скажи пользователю, что они не нужны и в следующий раз их лучше не выгружать.

Спрашивай пользователя только о том, что нельзя понять из обзора: значение непонятного статуса, неоднозначный порядок дня и месяца, курсы валют, часовой пояс файлов без пояса, если в других файлах время с поясом (Z, +03:00), и реальные ли деньги в ставках, если по названию колонки это неясно. Задавай все вопросы одним сообщением.

  1. Проверь готовность: python3 scripts/sd_analyze.py --mapping <папка>/mapping.json --out <папка>/second-deposit --check. Скрипт скажет, сколько причин из 12 посчитается и чего не хватает, какой будет режим (полный или список) и что проверить (страна, флаги ответственной игры, типы способов оплаты). Перескажи это пользователю одним сообщением: если не хватает данных, которые легко добавить, предложи добавить их до расчета, иначе считай.
  2. Запусти расчет: python3 scripts/sd_analyze.py --mapping <папка>/mapping.json --out <папка>/second-deposit --lang ru (язык ответа пользователя: ru, uk или en). Если скрипт остановился с ошибкой сопоставления, исправь mapping.json и запусти снова. Проверь две строки вывода: "Бонусы" (у каждого бонуса найден вейджер, тяжелые помечены верно) и "Попытки депозита по статусам" (неудачных попыток не ноль). Остальные параметры (окно второго депозита, порог тяжелого вейджера и другие) меняй, только если пользователь попросил: python3 scripts/sd_analyze.py --help.
  3. Прочитай summary.json и ответь коротко:
  • STD за окно и норма (STD игроков без проблемных сигналов);
  • недобор Sum Dep в месяц вилкой: от lost_month_min (только сами вторые депозиты) до lost_month (Sum Dep вернувшегося за 30 дней), и три причины с самым большим недобором: сколько FTD, STD против нормы, вилка, что делать;
  • срезы из segments, если есть;
  • главные показатели из metrics: второй депозит за 24 часа и 7 дней, апрув кассы, доля выводов и отклоненных выводов, Sum Dep на одного FTD, динамика по неделям из weekly;
  • список: сколько игроков, по каким действиям (rescue.actions), на какой момент снят (последняя попытка депозита в выгрузке) и путь к папке rescue.list_dir: в ней actions.csv (сводка действий), файл на каждое действие для загрузки в CRM как сегмент, rescue_list.xlsx для чтения в Excel и копия отчета; в CRM при отправке исключать тех, у кого был депозит после snapshot_utc; действия с приоритетом 1 (много отказов подряд, отказ по лимиту, вывод отклонен или висит, документы) нужны сейчас;
  • правила стран из geo_rules: страны с правилами, что они изменили (applied: отказы по лимиту, исключенные из-за блокировки в банке, долгие выводы по законному сроку, выводы дольше законного срока), попытки депозита запрещенными в стране способами (banned_in_data), страны без правил;
  • оговорки из caveats простыми словами: чего не хватает в данных и что добавить в выгрузку.

В режиме списка вместо денег и показателей скажи, сколько игроков в списке, сколько писать и сколько в контрольной группе, по каким причинам, прогноз из forecast (сколько вернутся без действий, сколько не хватает до нормы, вилка денег) и откуда вводные. Если профиля нет, скажи, что публичного бенчмарка нет, норма и прогноз появятся с 8-го дня, а сразу полный расчет даст выгрузка за 60-120 дней. Если в summary.json есть effect, назови разницу в долях вторых депозитов и вывод: разница больше случайной (z от 2), в пределах случайной или действия вредят (z до -2).
Дай путь к report.html (копия по дате лежит в папке списка). Остальные файлы в той же папке: scenarios.csv и segments.csv (таблицы для Excel, в segments.csv колонка significant отделяет разрывы больше случайных), excluded_rg.csv (кто исключен по ответственной игре). Все суммы и штуки в ответе бери месячные (lost_month, gap_players_month). Не придумывай рыночных норм и не сравнивай с "рынком": все цифры только из данных пользователя.

  1. Предложи следующий шаг: загрузить файлы действий в CRM как сегменты (колонки action_code, priority, send_after_utc), включить триггеры по сценариям (references/scenarios.md, раздел "Триггеры"), поставить ежедневный запуск по расписанию (раздел ниже).

Ежедневный запуск по расписанию

Скрипт не требует Claude: по расписанию его запускает планировщик системы. Ставь задачу только после явного согласия пользователя: это постоянная настройка его компьютера.

  1. Папка. Одна папка для выгрузок и результата. На Mac не на Рабочем столе и не в Документах или Загрузках: туда планировщик без отдельного разрешения не пустит. Например ~/second-deposit-data.
  2. mapping.json с масками и "latest": true у каждого файла (как в mapping-csv-example.json). Проверь одним ручным запуском.
  3. Задача. Полный путь к python3 покажет which python3. Mac и Linux, добавить строку к существующим, не стирая их:

(crontab -l 2>/dev/null; echo '0 9 * <папка скилла>/scripts/sd_analyze.py --mapping <папка>/mapping.json --out <папка>/second-deposit --lang ru >> <папка>/second-deposit/daily.log 2>&1') | crontab -
Windows: schtasks /create /tn second-deposit /sc daily /st 09:00 /tr "py <папка скилла>\scripts\sd_analyze.py --mapping <папка>\mapping.json --out <папка>\second-deposit --lang ru".
Время ставь после того, как выгрузка обычно появляется в папке.

  1. Скажи пользователю: куда класть выгрузки (с датой в имени, например deposits_2026-10-17.csv), где каждое утро лежит результат (second-deposit/lists/<дата>/), что лог без данных игроков пишется в daily.log, и как убрать задачу: crontab -e и удалить строку, в Windows schtasks /delete /tn second-deposit.

Как читать цифры

  • Две части по времени. Список собирается по свежим FTD за последние 72 часа: сигналы видны в первые часы (отказ в кассе и отклоненный вывод сразу, запрос документов в момент запроса, тяжелый бонус в момент FTD, "сгорел быстро" в первую сессию, долгий вывод через сутки после запроса, выигрыш и деньги на балансе через сутки после FTD).
  • Действие по состоянию. Рекомендация зависит от того, что видно в данных: вывод в обработке (провести быстро) или уже выплачен (через 2-3 дня повод вернуться), бонус еще отыгрывается (напомнить) или проигран (оффер без тяжелого вейджера). Состояние лежит в колонке state списка. Расчет потерь идет по FTD старше 7 дней, потому что вернулся игрок или нет, видно только через 7 дней. Если пользователь спрашивает "когда смотреть", объясни именно так и предложи запускать каждый день или поставить те же сигналы триггерами в CRM.
  • Норма это доля вторых депозитов у похожих игроков без проблемных сигналов: тот же размер FTD, источник и страна (если таких меньше 30, размер FTD и источник, потом только размер FTD). Недобор считается до нормы, поэтому это верхняя граница; вилка денег: минимум только сами вторые депозиты, максимум Sum Dep вернувшегося за 30 дней.
  • Эффект считается только по контрольной группе: это единственная цифра того, сколько реально вернули действия.
  • Сценарий показывает, где теряются игроки, а не доказывает причину. Причину проверяет тест с контрольной группой.
  • Срезы со сценариями не складываются: это другой взгляд на тех же игроков.
  • Ответственная игра: игроки с флагами из rg_flags исключены и из расчета, и из списка. Если флагов в выгрузке нет, скажи пользователю, что исключать их придется на стороне CRM.

Определения сценариев, пороги и формулы: references/scenarios.md. Форматы выгрузок и mapping.json: references/data.md.