Yandex Metrika — аудит, анализ, управление
Метрика — это не «отчёты», а способ понять, что на самом деле происходит с продуктом после запуска. Скилл работает над одним счётчиком в трёх режимах:
- Аудит (по умолчанию) — разовая read-only проверка, можно ли верить данным: паспорт счётчика, качество данных, цели, разметка трафика, связка с Директом. Итог — HTML-отчёт «починить / проверить / норма». В счётчик не пишет.
- Анализ — ответ на конкретный вопрос («откуда заявки», «почему упала конверсия», «какая РК окупается») или регулярный разбор (неделя/месяц к прошлому периоду). Read-only. Итог — сводка в чат + файл, при регулярном разборе — состояние в папке на диске.
- Управление — запись в счётчик: цели и сегменты. Только под гейтом: проект изменений →
dry_run → явное «ОК» → запись → журнал с before/after → проверка, что цель начала срабатывать.
Правка кампаний Директа — не задача этого скилла: аудит и ведение РК — yandex-direct-audit, создание РК — yandex-direct-manager. Из Метрики мы только смотрим на Директ (расход, клики, визиты, цели) и готовим для него цели и сегменты.
Проверка версии (один раз за разговор, до mode-gate)
Версия этого скилла — в файле VERSION рядом с этим SKILL.md. Прочитай его и одним запросом
загрузи актуальную версию: https://raw.githubusercontent.com/ai-hub-open/yandex-metrika-manager/main/VERSION.
Совпадает — ничего не пиши, переходи к mode-gate.
Загрузить не вышло (нет сети, нет чтения по URL, ошибка) — не повторяй запрос, ничего не пиши
и не ставь пометку о пропуске. Переходи к mode-gate.
На GitHub новее (сравнивай как semver: 1.1.2 > 1.1.0) — одним коротким сообщением скажи,
что вышла версия X (у пользователя Y), дай ссылку на
CHANGELOG и как обновиться:
- Claude Code, скилл установлен плагином:
/plugin marketplace update ai-hub-open, затем перезапустить сессию;
- скилл загружен архивом (Claude Desktop / claude.ai) или папкой: скачать
yandex-metrika-manager.zip
из релизов и заменить старый.
Спроси: обновиться сейчас или продолжить на текущей версии. Ответ «продолжить» — работаем дальше,
к вопросу в этом разговоре не возвращаемся.
Сам файлы скилла не скачивай и не заменяй, даже если среда это позволяет: обновление ставит
пользователь. Скилл, который сам переписывает свои инструкции из интернета, — дыра в безопасности.
Mode-gate (определяется первым делом)
| Сигнал в запросе |
Режим |
| «проверь Метрику / счётчик», «аудит Метрики», «можно ли верить цифрам», «какие цели не работают», «правильно ли настроено» |
Аудит |
| вопрос о данных: «откуда трафик», «какая кампания приносит заявки», «почему упало», «разбери за месяц», «сравни с прошлой неделей», «где теряем пользователей» |
Анализ |
| «создай / поправь / удали цель», «настрой цели под Директ», «сделай сегмент для ретаргетинга», «приведи цели в порядок» |
Управление |
«продолжаем разбор», есть папка metrika/<slug>/ с pulse.md |
Анализ (регулярный) |
Противоречиво или неясно — спроси одним вопросом: «Проверить настройку счётчика, ответить на вопрос по данным или поменять цели/сегменты?»
Режимы стыкуются: аудит часто заканчивается предложением перейти в управление («3 мёртвые цели — переделать?»), анализ — гипотезами для A/B и ТЗ. Переход в управление — всегда отдельный гейт.
|
Аудит |
Анализ |
Управление |
| Запись в счётчик |
никогда |
никогда |
только одобренное, через dry_run |
| Тулы |
*_get, report* |
*_get, report* |
+ goals_add/update/delete, segments_add/delete |
| Папка |
metrika/<slug>/audit/ |
metrika/<slug>/analysis/ |
metrika/<slug>/changes/ + changes_log.jsonl |
| Финал |
АУДИТ_МЕТРИКИ_<slug>.html |
сводка + .md/.csv |
журнал + change_report.md |
Принципы (для всех режимов)
- Сначала качество данных, потом выводы. Корректность данных важнее количества отчётов. Если счётчик считает роботов, теряет треть визитов из Директа или цель срабатывает на каждом втором визите — любые выводы о конверсии ложны. Поэтому даже в анализе сначала идёт быстрый санити-чек (Шаг 0.5).
- Симптом ≠ причина. «Упала конверсия» — симптом. Причина ищется разрезами: источник → страница входа → устройство → регион → шаг воронки. Не останавливайся на первом уровне.
- Объём ≠ качество. Канал с большим трафиком и нулевой доходимостью до целей хуже маленького с высокой. Всегда смотри пару «визиты + конверсия/отказ/глубина».
- Каждый вывод = число + период + объём + сравнение. Нет объёма (меньше ~100 визитов в сегменте или меньше ~10 достижений цели) — пиши «мало данных», не выдумывай.
- Атрибуция названа. Метрика по умолчанию — последний значимый переход с учётом всех устройств (
cross_device_last_significant; старое имя lastsign сервер переводит сам). Задавай attribution явно в каждом отчёте и подписывай модель словами по полю attribution ответа. Не сравнивай и не дели числа из разных моделей: визиты по последнему переходу (last) заметно меньше — на живом счётчике в 1,44 раза — и годятся только для вопроса «сколько кликов стали визитами».
- Семплирование видно. Если ответ помечен как семплированный — повтори с
accuracy: "full" для ключевых цифр или явно пометь приближённость.
- Сырьё — в файлы, в чат — 5–10 строк. Ответ тула идёт через контекст; тяни только нужные поля и строки (
limit, filters).
- Вывод → действие. Наблюдение без «что сделать, кто, какой ожидаемый эффект» — не находка. Для разработки — ТЗ (контекст, гипотеза, ожидаемый эффект), для маркетолога — конкретное действие.
- Ограничения — честно. Чего не смогли проверить (нет доступа, нет целей, нет связки с Директом) — отдельный блок.
Чего скилл не делает: прямой отказ
Просьба, которую скилл сейчас выполнить не может, получает прямой ответ — а не молчаливый
возврат к отчёту или следующему шагу.
| Просят |
Когда нельзя |
Где сделать руками |
Что можешь предложить вместо |
| Создать, изменить, удалить цель или сегмент |
Режим аудита или анализа |
— |
Перейти в Управление: превью и запись после «ОК» |
| Удалить цель или сегмент |
Инструмента нет среди доступных или вызов отклонён (так на платформе AI Hub) |
В интерфейсе Метрики, в настройках счётчика |
Не использовать цель в отчётах и стратегии; переименовать в [OFF] …, если изменение доступно |
| Изменить цель, созданную не в этой сессии |
Инструмента нет или вызов отклонён |
В интерфейсе Метрики, в настройках счётчика |
Создать новую цель с верным условием |
Записать что-то в счётчик с доступом view |
Всегда |
Попросить владельца счётчика выдать доступ на редактирование |
Аудит и анализ — они работают на чтении |
Инструмент есть и вызов проходит (Claude Desktop/Code) — Управление работает как раньше, по
references/write-safety.md. Нужного инструмента нет среди доступных — отказывай сразу, до
вызова и до конфирма.
Как отказывать — одним сообщением:
- Прямо, первой фразой: «Нет, у меня нет прав на удаление целей». Назови действие
словами пользователя. Не переспрашивай и не делай вид, что просьбы не было.
- Где руками — из таблицы.
- Что можешь вместо — если есть замена, предложи её вопросом и жди ответа.
- Стоп. После отказа ничего не продолжай: не возвращайся к отчёту, не переходи к
следующему шагу, не вызывай пишущие инструменты. Жди, что скажет человек.
Вызов отклонён. Ответ говорит, что действие запрещено, не разрешено или требует прав
(forbidden, not allowed, permission, 403), — это отказ, а не сбой. Не повторяй вызов,
не ищи смежный инструмент и не уходи на Management API в обход. Запиши операцию в журнал как
failed с причиной и ответь человеку по схеме выше.
References
| Файл |
Когда читать |
Зачем |
references/mcp-tools-map.md |
Шаг 0 и при любой ошибке коннектора |
Поиск коннектора, read/write тулы, параметры отчётов, справочник группировок/метрик, фильтры, семплирование, ошибки |
references/audit-checklist.md |
Аудит, Шаги 1–5; санити-чек анализа |
Все проверки с порогами: паспорт, качество данных, цели, разметка, связка с Директом |
references/report-recipes.md |
Анализ и Шаги 2–6 аудита |
Готовые вызовы отчётов под типовые вопросы |
references/analysis-playbook.md |
Анализ |
Как думать: дерево разрезов, воронки, аномалии, новые/вернувшиеся, A/B-гипотезы, ТЗ, регулярный разбор |
references/goals-design.md |
Аудит Шаг 3, Управление |
Иерархия целей, типы, нейминг, цели для Директа, шаблон ТЗ на JS-события |
references/write-safety.md |
Управление |
Гейт, dry_run, journal-before-write, обратимые/необратимые, проверка после записи |
references/report-template.md |
Финал аудита |
Схема findings.json и сборка HTML |
Scripts
Все — стандартная библиотека Python, без сети. Запуск из корня скилла: python -m scripts.<имя> ...
Где что лежит. Рабочая папка metrika/<slug>/ — в текущей папке пользователя, не внутри скилла. Раз скрипты запускаются из корня скилла, пути к рабочим файлам передавай абсолютные (--input <абсолютный путь>/metrika/<slug>/audit/findings.json). Скилл, установленный плагином Claude Code, при обновлении заменяется целиком: всё, что легло в его папку, пропадёт вместе с данными клиента.
metrika_table.py — ответ yandex_metrika_report (JSON) → CSV + производные (CR, CPA, доля), фильтр по минимальному объёму, сравнение двух периодов (--compare) с дельтами.
goals_health.py — ответ goals_get со stats_days → классификация целей: мёртвая / шумная / живая / мало данных, дубли условий, цели без ценности, нейминг.
utm_hygiene.py — отчёт по UTM-меткам → разнобой регистра и написания, нестандартные utm_medium, рекламный трафик без меток.
ab_calc.py — размер выборки и длительность A/B-теста по базовой конверсии, минимальному эффекту и трафику.
changes_log.py — append-only журнал записей в счётчик (before/after, откат). Только Управление.
render_report.py — findings.json → самодостаточный HTML-отчёт аудита.
Архитектура: оркестратор + субагенты
Оркестратор (этот файл) держит скоуп, _state.json, гейты и сборку отчёта. Три тяжёлых сбора вынесены в изолированные субагенты (context: fork) — чтобы большие таблицы не забивали основной контекст:
| Шаг |
Где |
Бриф |
| 0–3, 7 (скоуп, паспорт, качество, цели, отчёт) |
инлайн |
— |
| 4 — источники и разметка |
форк |
subagents/traffic-sources.md |
| 5 — связка с Директом |
форк |
subagents/direct-bridge.md |
| 6 — поведение и воронки |
форк |
subagents/behavior-funnel.md |
Оркестратор читает бриф и передаёт его форку целиком с аргументами; форк пишет артефакты на диск и возвращает сводку ≤20 строк. Субагенты недоступны → выполняй те же шаги инлайн по тем же references. Брифы — инструкции, не отдельные скиллы (в пакете ровно один SKILL.md). Read-only в форках держится инструкцией: пишущие тулы им видны, но запрещены.
Шаг 0. Подключение и скоуп (все режимы)
Прочти references/mcp-tools-map.md.
Предполётная проверка (read-only, дёшево)
- Коннектор найден. Ищи тул, чьё имя оканчивается на
yandex_metrika_counters_get — префикс задаёт пользователь (metrikaCM, MetrikaClient…). Нет — коннектора нет: стоп, скажи, как подключить (mcp-tools-map.md → «Подключение»). Несколько коннекторов — спроси, какой это клиент/кабинет.
- Доступ живой.
yandex_metrika_accounts_get → есть аккаунты. Пусто или ошибка «не подключена Яндекс Метрика» → в click.ru у пользователя нет интеграции Метрики: стоп, скажи, что подключить в интеграциях click.ru (или использовать коннектор с прямым OAuth-токеном).
- Счётчик найден.
yandex_metrika_counters_get({ search: "<домен>" }). Зафиксируй counter_id, permission (own/edit/view). view → Управление невозможно, предупреди сразу.
- Отчёты живые.
yandex_metrika_report({ counter_id, metrics: ["ym:s:visits"], date1: "7daysAgo", date2: "yesterday" }) → пришли числа. Ноль визитов за неделю у живого сайта — сам по себе блокер (счётчик не стоит или сломан).
Красный пункт → скажи до старта, что не работает и как это сузит работу.
Скоуп — одним блоком, с дефолтами
- Сайт / счётчик — если счётчиков по поиску несколько, покажи список и спроси.
- Период — дефолт: последние 30 полных дней (
date1: "30daysAgo", date2: "yesterday") + предыдущие 30 для сравнения.
- Что считается результатом — какая цель = лид/продажа (макро-цель), какие — микро. Не знают — возьмём из
goals_get и предложим.
- KPI — целевой CPA / CR / ДРР, если есть. Нет — работаем по относительным сигналам.
- Директ — используется ли; если да — найдём логины через
direct_clients_get.
- slug — короткое имя проекта для папки.
Формулируй гипотезой: «Беру счётчик 12345678 (site.ru), последние 30 дней к прошлым 30, результат — цель „Заявка“, Директ подтяну сам. Ок?»
Артефакт: metrika/<slug>/_state.json — connector_prefix, counter_id, site, permission, timezone, period, compare_period, macro_goal_ids, micro_goal_ids, kpi, direct_logins, mode, current_step.
Шаг 0.5. Санити-чек данных (для Анализа — обязательно, коротко)
Перед ответом на вопрос в режиме Анализа сделай три дешёвые проверки из audit-checklist.md → «Экспресс-санити»: доля роботов, живость макро-цели (goals_get со stats_days: 30), семплирование. Красный флаг → скажи об этом первой строкой ответа («Осторожно: 18% визитов — роботы, конверсия занижена») и предложи полный аудит.
Режим АУДИТ: Шаги 1–7
Только read-only: accounts_get, counters_get, counter_get, goals_get, segments_get, direct_clients_get, report, report_bytime. Пишущие тулы (goals_add/update/delete, segments_add/delete) в аудите не вызываются, даже с dry_run.
Каждый шаг пишет артефакт в metrika/<slug>/audit/ и находки в формате findings.json (схема — report-template.md).
Шаг 1. Паспорт счётчика
Прочти audit-checklist.md → «Паспорт».
yandex_metrika_counter_get({ counter_id, fields: ["goals","mirrors","grants","filters","operations","counter_flags"] })
Проверяешь: статус счётчика и кода, сайт и зеркала (поддомены, старый домен, платёжные страницы, лендинги на Тильде), фильтры (исключение своих IP / роботов), операции (вырезание параметров, замена домена), вебвизор/карты включены, часовой пояс совпадает с бизнесом, доступы (кто владелец, есть ли агентство/подрядчики, лишние доступы).
Артефакт: 01_passport.md.
Шаг 2. Качество данных
Прочти audit-checklist.md → «Качество данных», report-recipes.md → R1–R4.
- Доля роботов и её динамика (всплески по дням = бот-атака или скликивание).
- Визиты с нулевой длительностью / отказы > порога по источникам — подозрение на ботов или битую посадку.
- Домены входа (
ym:s:startURLDomain) — чужие домены, тестовые стенды, локалхост → нужен фильтр.
- Самопереходы (свой домен в источниках-ссылках) — теряется реальный источник, ломается атрибуция (кросс-домен, платёжный шлюз).
- Доля «Прямых заходов» аномально высокая (> ~40% у сайта с рекламой) — признак потерянных меток/редиректов.
- Разрывы в динамике визитов (дни с нулём) — счётчик слетал.
Артефакт: 02_data_quality.md + сырьё в raw/.
Шаг 3. Цели
Прочти audit-checklist.md → «Цели» и goals-design.md.
yandex_metrika_goals_get({ counter_id, stats_days: 30 })
Сохрани ответ в raw/goals.json и прогони:
python -m scripts.goals_health --input metrika/<slug>/audit/raw/goals.json --visits <визиты за те же 30 дней> \
--macro-ids <ID макро> --direct-goal-ids <ID целей стратегии Директа>
Ищешь: мёртвые цели (0 достижений), шумные (конверсия неправдоподобно высокая — «любой клик», «2 страницы»), дубли условий, нет макро-цели, нет составной цели под воронку, нет ценности у макро-целей, хаос в названиях, автоцели вперемешку с ручными. Отдельно — на какую цель оптимизируется Директ (спроси или возьми из скоупа): если на шумную/мёртвую — это находка №1 по деньгам.
Артефакт: 03_goals.md + 03_goals.json.
[GATE] Покажи сводку целей (5–10 строк): «Живых 6, мёртвых 3, шумных 1 — Директ, похоже, учится на шумной. Дальше — источники и Директ?»
Шаг 4. Источники и разметка [форк traffic-sources]
Что готовит оркестратор: slug, counter_id, период, macro_goal_ids.
Запусти изолированного субагента (форк). Задача = полное содержимое
subagents/traffic-sources.md, аргументы:
$0 = <slug> $1 = <counter_id> $2 = <date1..date2> $3 = <macro_goal_ids>
Возвращает: сводку ≤20 строк (структура каналов, объём vs качество, разметка, мусорные источники) + 04_sources.md, 04_utm_hygiene.json, 04_findings.json.
Шаг 5. Связка с Директом [форк direct-bridge]
Пропусти, если Директ не используется (direct_clients_get пусто и пользователь подтвердил).
Запусти изолированного субагента (форк). Задача = полное содержимое
subagents/direct-bridge.md, аргументы:
$0 = <slug> $1 = <counter_id> $2 = <date1..date2> $3 = <macro_goal_ids> $4 = <direct_logins>
Возвращает: сводку (потеря визитов клик→визит по кампаниям, расход и CPA по кампаниям по данным Метрики, кампании без конверсий, топ-фразы с отказами) + 05_direct.md, 05_findings.json.
Шаг 6. Поведение и воронки [форк behavior-funnel]
Запусти изолированного субагента (форк). Задача = полное содержимое
subagents/behavior-funnel.md, аргументы:
$0 = <slug> $1 = <counter_id> $2 = <date1..date2> $3 = <macro_goal_ids> $4 = <micro_goal_ids>
Возвращает: сводку (страницы входа-утечки, устройства/регионы с провалом конверсии, где рвётся воронка, новые vs вернувшиеся) + 06_behavior.md, 06_findings.json, гипотезы для A/B.
Шаг 7. Отчёт
Прочти references/report-template.md. Собери находки Шагов 1–6 в findings.json (образец — assets/findings_example.json) и:
python -m scripts.render_report --input metrika/<slug>/audit/findings.json
# → АУДИТ_МЕТРИКИ_<slug>.html рядом
Приоритет находок: сначала то, что ломает данные и обучение Директа (шумная цель в стратегии, потеря визитов, роботы, нет макро-цели), потом разметка, потом поведение и рост. Каждая карточка: диагноз (числа+период+объём) → что сделать → где → как перепроверить самому → ожидаемый эффект. Язык человеческий, без ym:s:* в тексте.
В чат — топ-5 находок и ссылка на файл. Если есть находки по целям/сегментам — предложи: «Могу сразу переделать цели — перейдём в управление?»
Режим АНАЛИЗ
Прочти references/analysis-playbook.md и references/report-recipes.md.
Разовый вопрос
- Шаг 0 (скоуп можно сократить до счётчика и периода) → Шаг 0.5 санити-чек.
- Переформулируй вопрос в метрику + разрез + сравнение («почему упали заявки» →
goal<макро>reaches по lastsignTrafficSource, этот период vs прошлый, затем вглубь по дереву разрезов из playbook).
- Тяни отчёты по рецептам. Сырые ответы →
analysis/raw/, через metrika_table.py (с --compare для двух периодов) → таблица с дельтами.
- Иди по дереву разрезов, пока не найдёшь сегмент, который объясняет большую часть изменения (вклад в дельту, а не просто «упал сильнее всех в %»).
- Ответ: 1 строка вывода → 3–5 строк доказательства (числа, период, объём) → что сделать → чего не знаем. Таблицы — в файл
analysis/<дата>_<тема>.md / .csv.
- Если вывод требует изменений на сайте — оформи ТЗ (
analysis-playbook.md → «ТЗ»); если спорный — A/B-гипотезу с критериями и длительностью через ab_calc.py.
Регулярный разбор (неделя / месяц)
Регулярные отчёты показывают динамику, а не разовые всплески. Состояние живёт в metrika/<slug>/pulse.md (что смотрим, нормы, история), поэтому разбор переживает новые сессии.
- Первый запуск: согласовать с человеком 5–8 ключевых метрик (визиты, доля рекламы, CR макро-цели, CPA по Директу, отказы на ключевых посадках, доля роботов), записать их нормы (среднее за 4–8 недель) в
pulse.md. Нужна постоянная папка — попроси подключить папку проекта.
- Каждый запуск: период к прошлому + к норме → отклонения больше порога из
pulse.md → разбор причин по дереву → 5–10 строк: что изменилось, почему, что делать. Дописать строку в историю pulse.md.
- Нет изменений за порогом — так и скажи одной строкой. Не высасывай находки.
- Если пользователь хочет, чтобы разбор шёл сам по расписанию — предложи создать запланированную задачу с промптом «продолжаем регулярный разбор Метрики ».
Режим УПРАВЛЕНИЕ (цели и сегменты)
Перед стартом прочти references/write-safety.md и references/goals-design.md целиком.
Требование: permission счётчика own или edit (см. Шаг 0). view → стоп, объясни, кто может выдать доступ.
Фаза A. Снимок
goals_get({ counter_id, stats_days: 30 }) + segments_get({ counter_id }) → сохрани в changes/<дата>/before.json. Это и база для отката, и защита от дублей.
Фаза B. Проект изменений
Из запроса пользователя, находок аудита и goals-design.md составь changes/<дата>/proposed.json — список операций. Для каждой:
op (goal_add / goal_update / goal_delete / segment_add / segment_delete), полное тело, зачем, класс (обратимая / необратимая);
- для цели — проверка, что её условие реально сработает (URL страницы «спасибо» существует в отчёте
ym:s:startURL/страниц, JS-идентификатор есть на сайте или для него пишется ТЗ разработчику);
- для удаления цели — проверка, не используется ли она в Директе (стратегия/ключевые цели). По умолчанию не удаляем, а переименовываем с префиксом
[OFF] — удаление необратимо и рвёт обучение кампаний;
- для сегмента — условие проверено отчётом с тем же
filters (покажи, сколько визитов/пользователей попадает: пустой сегмент бесполезен для ретаргетинга).
Фаза C. Dry-run и гейт
Каждую операцию прогони с dry_run: true — покажи человеку тело запроса и что изменится. Список: обратимые отдельно, необратимые отдельно.
[GATE] «Вот что создам/изменю в счётчике . Применяем всё, частично или правим?» Необратимые (удаление цели/сегмента) — отдельное подтверждение на каждую.
Фаза D. Применение
По одобренному, строго по write-safety.md: changes_log.py record (before) → боевой вызов → дописать after + ID. goals_update — только полным объектом (взятым из goals_get и изменённым), иначе Метрика сбросит пропущенные поля. Ошибка → статус failed в журнале, не молчи.
Фаза E. Проверка и передача
goals_get — новые цели на месте, ID записаны.
- Цели по JS-событиям — выдай ТЗ разработчику (
goals-design.md → «ТЗ на JS-событие») с готовым кодом ym(<counter_id>, 'reachGoal', '<id>').
- Цели не считают задним числом: попроси через 1–2 дня запустить «проверь новые цели» →
goals_get({ stats_days: 2 }). Ноль достижений при живом трафике → условие не срабатывает, разбираем.
- Если цель для Директа — скажи, какой ID указать в стратегии/ключевых целях (это делается в Директе, не здесь).
changes/<дата>/change_report.md: что сделано, ID, что ждём, как откатить.
Стиль работы
- Один вопрос за раз, скоуп — одним блоком с дефолтами.
- Новая просьба важнее плана. Сообщение пользователя посреди работы — сначала ответ на
него, а не следующий шаг из
_state.json. Просьбу, которую скилл выполнить не может,
закрывает прямой отказ (раздел «Чего скилл не делает»), после него — стоп.
- Гипотеза > пустой вопрос.
- В чат — 5–10 строк, таблицы и сырьё — в файлы.
- Числа с контекстом: период, объём, сравнение, модель атрибуции словами.
- Никаких
ym:s:* и lastsign в текстах для человека — «источник по последнему значимому переходу», «страница входа».
- В аудите и анализе — только чтение. Рука тянется поправить цель — стоп, это находка с предложением перейти в Управление.
- В управлении — dry_run, гейт, журнал. Ни одной записи без «ОК».
- References обязательны: «Прочти …» — требование.
Возобновление
Только по просьбе продолжить; сообщение с другой просьбой — сначала ответ на неё.
«Продолжаем» → найди metrika/*/, прочитай _state.json (mode, current_step) и продолжай с места. Отчёты за уже собранный период не перезапрашивай — они в raw/.
Карта артефактов
metrika/<slug>/
_state.json
pulse.md ← регулярный разбор: метрики, нормы, история
changes_log.jsonl ← все записи в счётчик (Управление)
audit/
01_passport.md
02_data_quality.md
03_goals.md 03_goals.json
04_sources.md 04_utm_hygiene.json 04_findings.json [форк traffic-sources]
05_direct.md 05_findings.json [форк direct-bridge]
06_behavior.md 06_findings.json [форк behavior-funnel]
findings.json ──(render_report.py)──→ АУДИТ_МЕТРИКИ_<slug>.html
raw/ ← сырые ответы тулов
analysis/
<дата>_<тема>.md / .csv raw/
changes/<дата>/
before.json proposed.json applied.json change_report.md
1---2name: yandex-metrika-manager3description: "Анализ, разбор и управление Яндекс Метрикой через коннектор Метрики, три режима. АУДИТ (по умолчанию, read-only) — проверка счётчика и качества данных: настройки, зеркала, фильтры, роботы, живые/мёртвые/шумные цели, UTM-разметка, потеря визитов из Директа → HTML-отчёт с приоритетами. АНАЛИЗ — ответы на вопросы и регулярный разбор: источники и каналы, кампании Директа с расходом и CPA из Метрики, страницы входа, устройства, регионы, воронки, динамика и аномалии, гипотезы для A/B. УПРАВЛЕНИЕ — создание и правка целей и сегментов под гейтом: проект → dry_run → «ОК» → запись → журнал с откатом, плюс ТЗ разработчику на JS-события. Триггеры: «проверь Метрику», «аудит счётчика», «какие цели не работают», «откуда трафик», «разбери Метрику», «почему упали заявки», «настрой цели», «создай сегмент для ретаргетинга», «кликов в Директе больше, чем визитов». НЕ для правки кампаний Директа — это yandex-direct-audit и yandex-direct-manager."4metadata:5 source: https://skillmd.com/skills/ai-hub-open/yandex-metrika-manager6---78# Yandex Metrika — аудит, анализ, управление910Метрика — это не «отчёты», а способ понять, что на самом деле происходит с продуктом после запуска. Скилл работает над одним счётчиком в **трёх режимах**:1112- **Аудит** (по умолчанию) — разовая **read-only проверка, можно ли верить данным**: паспорт счётчика, качество данных, цели, разметка трафика, связка с Директом. Итог — HTML-отчёт «починить / проверить / норма». В счётчик не пишет.13- **Анализ** — ответ на конкретный вопрос («откуда заявки», «почему упала конверсия», «какая РК окупается») или **регулярный разбор** (неделя/месяц к прошлому периоду). Read-only. Итог — сводка в чат + файл, при регулярном разборе — состояние в папке на диске.14- **Управление** — **запись в счётчик**: цели и сегменты. Только под гейтом: проект изменений → `dry_run` → явное «ОК» → запись → журнал с before/after → проверка, что цель начала срабатывать.1516Правка кампаний Директа — **не задача этого скилла**: аудит и ведение РК — `yandex-direct-audit`, создание РК — `yandex-direct-manager`. Из Метрики мы только **смотрим** на Директ (расход, клики, визиты, цели) и готовим для него цели и сегменты.1718---1920## Проверка версии (один раз за разговор, до mode-gate)2122Версия этого скилла — в файле `VERSION` рядом с этим `SKILL.md`. Прочитай его и одним запросом23загрузи актуальную версию: `https://raw.githubusercontent.com/ai-hub-open/yandex-metrika-manager/main/VERSION`.2425- **Совпадает** — ничего не пиши, переходи к mode-gate.26- **Загрузить не вышло** (нет сети, нет чтения по URL, ошибка) — не повторяй запрос, ничего не пиши27 и не ставь пометку о пропуске. Переходи к mode-gate.28- **На GitHub новее** (сравнивай как semver: 1.1.2 > 1.1.0) — одним коротким сообщением скажи,29 что вышла версия X (у пользователя Y), дай ссылку на30 [CHANGELOG](https://github.com/ai-hub-open/yandex-metrika-manager/blob/main/CHANGELOG.md) и как обновиться:31 - Claude Code, скилл установлен плагином: `/plugin marketplace update ai-hub-open`, затем перезапустить сессию;32 - скилл загружен архивом (Claude Desktop / claude.ai) или папкой: скачать `yandex-metrika-manager.zip`33 из [релизов](https://github.com/ai-hub-open/yandex-metrika-manager/releases/latest) и заменить старый.3435 Спроси: обновиться сейчас или продолжить на текущей версии. Ответ «продолжить» — работаем дальше,36 к вопросу в этом разговоре не возвращаемся.3738**Сам файлы скилла не скачивай и не заменяй**, даже если среда это позволяет: обновление ставит39пользователь. Скилл, который сам переписывает свои инструкции из интернета, — дыра в безопасности.4041---4243## Mode-gate (определяется первым делом)4445| Сигнал в запросе | Режим |46|---|---|47| «проверь Метрику / счётчик», «аудит Метрики», «можно ли верить цифрам», «какие цели не работают», «правильно ли настроено» | **Аудит** |48| вопрос о данных: «откуда трафик», «какая кампания приносит заявки», «почему упало», «разбери за месяц», «сравни с прошлой неделей», «где теряем пользователей» | **Анализ** |49| «создай / поправь / удали цель», «настрой цели под Директ», «сделай сегмент для ретаргетинга», «приведи цели в порядок» | **Управление** |50| «продолжаем разбор», есть папка `metrika/<slug>/` с `pulse.md` | **Анализ (регулярный)** |5152Противоречиво или неясно — **спроси одним вопросом**: «Проверить настройку счётчика, ответить на вопрос по данным или поменять цели/сегменты?»5354Режимы стыкуются: аудит часто заканчивается предложением перейти в управление («3 мёртвые цели — переделать?»), анализ — гипотезами для A/B и ТЗ. Переход в управление — всегда **отдельный гейт**.5556| | Аудит | Анализ | Управление |57|---|---|---|---|58| Запись в счётчик | никогда | никогда | только одобренное, через `dry_run` |59| Тулы | `*_get`, `report*` | `*_get`, `report*` | + `goals_add/update/delete`, `segments_add/delete` |60| Папка | `metrika/<slug>/audit/` | `metrika/<slug>/analysis/` | `metrika/<slug>/changes/` + `changes_log.jsonl` |61| Финал | `АУДИТ_МЕТРИКИ_<slug>.html` | сводка + `.md`/`.csv` | журнал + `change_report.md` |6263## Принципы (для всех режимов)64651. **Сначала качество данных, потом выводы.** Корректность данных важнее количества отчётов. Если счётчик считает роботов, теряет треть визитов из Директа или цель срабатывает на каждом втором визите — любые выводы о конверсии ложны. Поэтому даже в анализе сначала идёт быстрый санити-чек (Шаг 0.5).662. **Симптом ≠ причина.** «Упала конверсия» — симптом. Причина ищется разрезами: источник → страница входа → устройство → регион → шаг воронки. Не останавливайся на первом уровне.673. **Объём ≠ качество.** Канал с большим трафиком и нулевой доходимостью до целей хуже маленького с высокой. Всегда смотри пару «визиты + конверсия/отказ/глубина».684. **Каждый вывод = число + период + объём + сравнение.** Нет объёма (меньше ~100 визитов в сегменте или меньше ~10 достижений цели) — пиши «мало данных», не выдумывай.695. **Атрибуция названа.** Метрика по умолчанию — последний значимый переход с учётом всех устройств (`cross_device_last_significant`; старое имя `lastsign` сервер переводит сам). Задавай `attribution` явно в каждом отчёте и подписывай модель словами по полю `attribution` ответа. Не сравнивай и не дели числа из разных моделей: визиты по последнему переходу (`last`) заметно меньше — на живом счётчике в 1,44 раза — и годятся только для вопроса «сколько кликов стали визитами».706. **Семплирование видно.** Если ответ помечен как семплированный — повтори с `accuracy: "full"` для ключевых цифр или явно пометь приближённость.717. **Сырьё — в файлы, в чат — 5–10 строк.** Ответ тула идёт через контекст; тяни только нужные поля и строки (`limit`, `filters`).728. **Вывод → действие.** Наблюдение без «что сделать, кто, какой ожидаемый эффект» — не находка. Для разработки — ТЗ (контекст, гипотеза, ожидаемый эффект), для маркетолога — конкретное действие.739. **Ограничения — честно.** Чего не смогли проверить (нет доступа, нет целей, нет связки с Директом) — отдельный блок.7475## Чего скилл не делает: прямой отказ7677Просьба, которую скилл сейчас выполнить не может, получает прямой ответ — а не молчаливый78возврат к отчёту или следующему шагу.7980| Просят | Когда нельзя | Где сделать руками | Что можешь предложить вместо |81|---|---|---|---|82| Создать, изменить, удалить цель или сегмент | Режим аудита или анализа | — | Перейти в Управление: превью и запись после «ОК» |83| Удалить цель или сегмент | Инструмента нет среди доступных или вызов отклонён (так на платформе AI Hub) | В интерфейсе Метрики, в настройках счётчика | Не использовать цель в отчётах и стратегии; переименовать в `[OFF] …`, если изменение доступно |84| Изменить цель, созданную не в этой сессии | Инструмента нет или вызов отклонён | В интерфейсе Метрики, в настройках счётчика | Создать новую цель с верным условием |85| Записать что-то в счётчик с доступом `view` | Всегда | Попросить владельца счётчика выдать доступ на редактирование | Аудит и анализ — они работают на чтении |8687Инструмент есть и вызов проходит (Claude Desktop/Code) — Управление работает как раньше, по88`references/write-safety.md`. Нужного инструмента нет среди доступных — отказывай сразу, до89вызова и до конфирма.9091**Как отказывать — одним сообщением:**92931. **Прямо, первой фразой:** «Нет, у меня нет прав на удаление целей». Назови действие94 словами пользователя. Не переспрашивай и не делай вид, что просьбы не было.952. **Где руками** — из таблицы.963. **Что можешь вместо** — если есть замена, предложи её вопросом и жди ответа.974. **Стоп.** После отказа ничего не продолжай: не возвращайся к отчёту, не переходи к98 следующему шагу, не вызывай пишущие инструменты. Жди, что скажет человек.99100**Вызов отклонён.** Ответ говорит, что действие запрещено, не разрешено или требует прав101(`forbidden`, `not allowed`, `permission`, `403`), — это отказ, а не сбой. Не повторяй вызов,102не ищи смежный инструмент и не уходи на Management API в обход. Запиши операцию в журнал как103`failed` с причиной и ответь человеку по схеме выше.104105## References106107| Файл | Когда читать | Зачем |108|---|---|---|109| `references/mcp-tools-map.md` | Шаг 0 и при любой ошибке коннектора | Поиск коннектора, read/write тулы, параметры отчётов, справочник группировок/метрик, фильтры, семплирование, ошибки |110| `references/audit-checklist.md` | Аудит, Шаги 1–5; санити-чек анализа | Все проверки с порогами: паспорт, качество данных, цели, разметка, связка с Директом |111| `references/report-recipes.md` | Анализ и Шаги 2–6 аудита | Готовые вызовы отчётов под типовые вопросы |112| `references/analysis-playbook.md` | Анализ | Как думать: дерево разрезов, воронки, аномалии, новые/вернувшиеся, A/B-гипотезы, ТЗ, регулярный разбор |113| `references/goals-design.md` | Аудит Шаг 3, Управление | Иерархия целей, типы, нейминг, цели для Директа, шаблон ТЗ на JS-события |114| `references/write-safety.md` | **Управление** | Гейт, dry_run, journal-before-write, обратимые/необратимые, проверка после записи |115| `references/report-template.md` | Финал аудита | Схема `findings.json` и сборка HTML |116117## Scripts118119Все — стандартная библиотека Python, без сети. Запуск из корня скилла: `python -m scripts.<имя> ...`120121**Где что лежит.** Рабочая папка `metrika/<slug>/` — в текущей папке пользователя, **не внутри скилла**. Раз скрипты запускаются из корня скилла, пути к рабочим файлам передавай абсолютные (`--input <абсолютный путь>/metrika/<slug>/audit/findings.json`). Скилл, установленный плагином Claude Code, при обновлении заменяется целиком: всё, что легло в его папку, пропадёт вместе с данными клиента.122123- `metrika_table.py` — ответ `yandex_metrika_report` (JSON) → CSV + производные (CR, CPA, доля), фильтр по минимальному объёму, сравнение двух периодов (`--compare`) с дельтами.124- `goals_health.py` — ответ `goals_get` со `stats_days` → классификация целей: мёртвая / шумная / живая / мало данных, дубли условий, цели без ценности, нейминг.125- `utm_hygiene.py` — отчёт по UTM-меткам → разнобой регистра и написания, нестандартные `utm_medium`, рекламный трафик без меток.126- `ab_calc.py` — размер выборки и длительность A/B-теста по базовой конверсии, минимальному эффекту и трафику.127- `changes_log.py` — append-only журнал записей в счётчик (before/after, откат). Только Управление.128- `render_report.py` — `findings.json` → самодостаточный HTML-отчёт аудита.129130## Архитектура: оркестратор + субагенты131132Оркестратор (этот файл) держит скоуп, `_state.json`, гейты и сборку отчёта. Три тяжёлых сбора вынесены в изолированные субагенты (`context: fork`) — чтобы большие таблицы не забивали основной контекст:133134| Шаг | Где | Бриф |135|---|---|---|136| 0–3, 7 (скоуп, паспорт, качество, цели, отчёт) | инлайн | — |137| 4 — источники и разметка | форк | `subagents/traffic-sources.md` |138| 5 — связка с Директом | форк | `subagents/direct-bridge.md` |139| 6 — поведение и воронки | форк | `subagents/behavior-funnel.md` |140141Оркестратор читает бриф и передаёт его форку **целиком** с аргументами; форк пишет артефакты на диск и возвращает **сводку ≤20 строк**. Субагенты недоступны → выполняй те же шаги инлайн по тем же references. Брифы — инструкции, не отдельные скиллы (в пакете ровно один `SKILL.md`). Read-only в форках держится инструкцией: пишущие тулы им видны, но запрещены.142143---144145# Шаг 0. Подключение и скоуп (все режимы)146147**Прочти `references/mcp-tools-map.md`.**148149### Предполётная проверка (read-only, дёшево)1501511. **Коннектор найден.** Ищи тул, чьё имя **оканчивается** на `yandex_metrika_counters_get` — префикс задаёт пользователь (`metrikaCM`, `MetrikaClient`…). Нет — коннектора нет: стоп, скажи, как подключить (`mcp-tools-map.md` → «Подключение»). Несколько коннекторов — спроси, какой это клиент/кабинет.1522. **Доступ живой.** `yandex_metrika_accounts_get` → есть аккаунты. Пусто или ошибка «не подключена Яндекс Метрика» → в click.ru у пользователя нет интеграции Метрики: стоп, скажи, что подключить в интеграциях click.ru (или использовать коннектор с прямым OAuth-токеном).1533. **Счётчик найден.** `yandex_metrika_counters_get({ search: "<домен>" })`. Зафиксируй `counter_id`, `permission` (own/edit/view). **`view` → Управление невозможно**, предупреди сразу.1544. **Отчёты живые.** `yandex_metrika_report({ counter_id, metrics: ["ym:s:visits"], date1: "7daysAgo", date2: "yesterday" })` → пришли числа. Ноль визитов за неделю у живого сайта — сам по себе блокер (счётчик не стоит или сломан).155156Красный пункт → скажи **до старта**, что не работает и как это сузит работу.157158### Скоуп — одним блоком, с дефолтами1591601. **Сайт / счётчик** — если счётчиков по поиску несколько, покажи список и спроси.1612. **Период** — дефолт: последние 30 полных дней (`date1: "30daysAgo"`, `date2: "yesterday"`) + предыдущие 30 для сравнения.1623. **Что считается результатом** — какая цель = лид/продажа (макро-цель), какие — микро. Не знают — возьмём из `goals_get` и предложим.1634. **KPI** — целевой CPA / CR / ДРР, если есть. Нет — работаем по относительным сигналам.1645. **Директ** — используется ли; если да — найдём логины через `direct_clients_get`.1656. **slug** — короткое имя проекта для папки.166167Формулируй гипотезой: «Беру счётчик 12345678 (site.ru), последние 30 дней к прошлым 30, результат — цель „Заявка“, Директ подтяну сам. Ок?»168169**Артефакт:** `metrika/<slug>/_state.json` — `connector_prefix`, `counter_id`, `site`, `permission`, `timezone`, `period`, `compare_period`, `macro_goal_ids`, `micro_goal_ids`, `kpi`, `direct_logins`, `mode`, `current_step`.170171## Шаг 0.5. Санити-чек данных (для Анализа — обязательно, коротко)172173Перед ответом на вопрос в режиме Анализа сделай три дешёвые проверки из `audit-checklist.md` → «Экспресс-санити»: доля роботов, живость макро-цели (`goals_get` со `stats_days: 30`), семплирование. Красный флаг → скажи об этом **первой строкой ответа** («Осторожно: 18% визитов — роботы, конверсия занижена») и предложи полный аудит.174175---176177# Режим АУДИТ: Шаги 1–7178179Только read-only: `accounts_get`, `counters_get`, `counter_get`, `goals_get`, `segments_get`, `direct_clients_get`, `report`, `report_bytime`. Пишущие тулы (`goals_add/update/delete`, `segments_add/delete`) в аудите **не вызываются**, даже с `dry_run`.180181Каждый шаг пишет артефакт в `metrika/<slug>/audit/` и находки в формате `findings.json` (схема — `report-template.md`).182183## Шаг 1. Паспорт счётчика184185**Прочти `audit-checklist.md` → «Паспорт».**186187```188yandex_metrika_counter_get({ counter_id, fields: ["goals","mirrors","grants","filters","operations","counter_flags"] })189```190191Проверяешь: статус счётчика и кода, сайт и **зеркала** (поддомены, старый домен, платёжные страницы, лендинги на Тильде), **фильтры** (исключение своих IP / роботов), операции (вырезание параметров, замена домена), вебвизор/карты включены, часовой пояс совпадает с бизнесом, доступы (кто владелец, есть ли агентство/подрядчики, лишние доступы).192193**Артефакт:** `01_passport.md`.194195## Шаг 2. Качество данных196197**Прочти `audit-checklist.md` → «Качество данных», `report-recipes.md` → R1–R4.**198199- Доля роботов и её динамика (всплески по дням = бот-атака или скликивание).200- Визиты с нулевой длительностью / отказы > порога по источникам — подозрение на ботов или битую посадку.201- Домены входа (`ym:s:startURLDomain`) — чужие домены, тестовые стенды, локалхост → нужен фильтр.202- Самопереходы (свой домен в источниках-ссылках) — теряется реальный источник, ломается атрибуция (кросс-домен, платёжный шлюз).203- Доля «Прямых заходов» аномально высокая (> ~40% у сайта с рекламой) — признак потерянных меток/редиректов.204- Разрывы в динамике визитов (дни с нулём) — счётчик слетал.205206**Артефакт:** `02_data_quality.md` + сырьё в `raw/`.207208## Шаг 3. Цели209210**Прочти `audit-checklist.md` → «Цели» и `goals-design.md`.**211212```213yandex_metrika_goals_get({ counter_id, stats_days: 30 })214```215216Сохрани ответ в `raw/goals.json` и прогони:217218```219python -m scripts.goals_health --input metrika/<slug>/audit/raw/goals.json --visits <визиты за те же 30 дней> \220 --macro-ids <ID макро> --direct-goal-ids <ID целей стратегии Директа>221```222223Ищешь: мёртвые цели (0 достижений), шумные (конверсия неправдоподобно высокая — «любой клик», «2 страницы»), дубли условий, нет макро-цели, нет составной цели под воронку, нет ценности у макро-целей, хаос в названиях, автоцели вперемешку с ручными. Отдельно — **на какую цель оптимизируется Директ** (спроси или возьми из скоупа): если на шумную/мёртвую — это находка №1 по деньгам.224225**Артефакт:** `03_goals.md` + `03_goals.json`.226227**[GATE]** Покажи сводку целей (5–10 строк): «Живых 6, мёртвых 3, шумных 1 — Директ, похоже, учится на шумной. Дальше — источники и Директ?»228229## Шаг 4. Источники и разметка [форк `traffic-sources`]230231**Что готовит оркестратор:** `slug`, `counter_id`, период, `macro_goal_ids`.232233```234Запусти изолированного субагента (форк). Задача = полное содержимое235subagents/traffic-sources.md, аргументы:236 $0 = <slug> $1 = <counter_id> $2 = <date1..date2> $3 = <macro_goal_ids>237```238239Возвращает: сводку ≤20 строк (структура каналов, объём vs качество, разметка, мусорные источники) + `04_sources.md`, `04_utm_hygiene.json`, `04_findings.json`.240241## Шаг 5. Связка с Директом [форк `direct-bridge`]242243Пропусти, если Директ не используется (`direct_clients_get` пусто и пользователь подтвердил).244245```246Запусти изолированного субагента (форк). Задача = полное содержимое247subagents/direct-bridge.md, аргументы:248 $0 = <slug> $1 = <counter_id> $2 = <date1..date2> $3 = <macro_goal_ids> $4 = <direct_logins>249```250251Возвращает: сводку (потеря визитов клик→визит по кампаниям, расход и CPA по кампаниям по данным Метрики, кампании без конверсий, топ-фразы с отказами) + `05_direct.md`, `05_findings.json`.252253## Шаг 6. Поведение и воронки [форк `behavior-funnel`]254255```256Запусти изолированного субагента (форк). Задача = полное содержимое257subagents/behavior-funnel.md, аргументы:258 $0 = <slug> $1 = <counter_id> $2 = <date1..date2> $3 = <macro_goal_ids> $4 = <micro_goal_ids>259```260261Возвращает: сводку (страницы входа-утечки, устройства/регионы с провалом конверсии, где рвётся воронка, новые vs вернувшиеся) + `06_behavior.md`, `06_findings.json`, гипотезы для A/B.262263## Шаг 7. Отчёт264265**Прочти `references/report-template.md`.** Собери находки Шагов 1–6 в `findings.json` (образец — `assets/findings_example.json`) и:266267```268python -m scripts.render_report --input metrika/<slug>/audit/findings.json269# → АУДИТ_МЕТРИКИ_<slug>.html рядом270```271272Приоритет находок: **сначала то, что ломает данные и обучение Директа** (шумная цель в стратегии, потеря визитов, роботы, нет макро-цели), потом разметка, потом поведение и рост. Каждая карточка: диагноз (числа+период+объём) → что сделать → где → как перепроверить самому → ожидаемый эффект. Язык человеческий, без `ym:s:*` в тексте.273274В чат — топ-5 находок и ссылка на файл. Если есть находки по целям/сегментам — предложи: «Могу сразу переделать цели — перейдём в управление?»275276---277278# Режим АНАЛИЗ279280**Прочти `references/analysis-playbook.md` и `references/report-recipes.md`.**281282### Разовый вопрос2832841. Шаг 0 (скоуп можно сократить до счётчика и периода) → Шаг 0.5 санити-чек.2852. Переформулируй вопрос в **метрику + разрез + сравнение** («почему упали заявки» → `goal<макро>reaches` по `lastsignTrafficSource`, этот период vs прошлый, затем вглубь по дереву разрезов из playbook).2863. Тяни отчёты по рецептам. Сырые ответы → `analysis/raw/`, через `metrika_table.py` (с `--compare` для двух периодов) → таблица с дельтами.2874. Иди по дереву разрезов, пока не найдёшь сегмент, который **объясняет большую часть изменения** (вклад в дельту, а не просто «упал сильнее всех в %»).2885. Ответ: 1 строка вывода → 3–5 строк доказательства (числа, период, объём) → что сделать → чего не знаем. Таблицы — в файл `analysis/<дата>_<тема>.md` / `.csv`.2896. Если вывод требует изменений на сайте — оформи **ТЗ** (`analysis-playbook.md` → «ТЗ»); если спорный — **A/B-гипотезу** с критериями и длительностью через `ab_calc.py`.290291### Регулярный разбор (неделя / месяц)292293Регулярные отчёты показывают динамику, а не разовые всплески. Состояние живёт в `metrika/<slug>/pulse.md` (что смотрим, нормы, история), поэтому разбор переживает новые сессии.294295- **Первый запуск:** согласовать с человеком 5–8 ключевых метрик (визиты, доля рекламы, CR макро-цели, CPA по Директу, отказы на ключевых посадках, доля роботов), записать их нормы (среднее за 4–8 недель) в `pulse.md`. Нужна постоянная папка — попроси подключить папку проекта.296- **Каждый запуск:** период к прошлому + к норме → отклонения больше порога из `pulse.md` → разбор причин по дереву → 5–10 строк: что изменилось, почему, что делать. Дописать строку в историю `pulse.md`.297- Нет изменений за порогом — так и скажи одной строкой. Не высасывай находки.298- Если пользователь хочет, чтобы разбор шёл сам по расписанию — предложи создать запланированную задачу с промптом «продолжаем регулярный разбор Метрики <slug>».299300---301302# Режим УПРАВЛЕНИЕ (цели и сегменты)303304**Перед стартом прочти `references/write-safety.md` и `references/goals-design.md` целиком.**305306Требование: `permission` счётчика `own` или `edit` (см. Шаг 0). `view` → стоп, объясни, кто может выдать доступ.307308## Фаза A. Снимок309310`goals_get({ counter_id, stats_days: 30 })` + `segments_get({ counter_id })` → сохрани в `changes/<дата>/before.json`. Это и база для отката, и защита от дублей.311312## Фаза B. Проект изменений313314Из запроса пользователя, находок аудита и `goals-design.md` составь `changes/<дата>/proposed.json` — список операций. Для каждой:315316- `op` (`goal_add` / `goal_update` / `goal_delete` / `segment_add` / `segment_delete`), полное тело, зачем, класс (обратимая / необратимая);317- для **цели** — проверка, что её условие реально сработает (URL страницы «спасибо» существует в отчёте `ym:s:startURL`/страниц, JS-идентификатор есть на сайте или для него пишется ТЗ разработчику);318- для **удаления цели** — проверка, не используется ли она в Директе (стратегия/ключевые цели). По умолчанию **не удаляем**, а переименовываем с префиксом `[OFF] ` — удаление необратимо и рвёт обучение кампаний;319- для **сегмента** — условие проверено отчётом с тем же `filters` (покажи, сколько визитов/пользователей попадает: пустой сегмент бесполезен для ретаргетинга).320321## Фаза C. Dry-run и гейт322323Каждую операцию прогони с `dry_run: true` — покажи человеку **тело запроса** и что изменится. Список: обратимые отдельно, необратимые отдельно.324325**[GATE]** «Вот что создам/изменю в счётчике <id>. Применяем всё, частично или правим?» Необратимые (удаление цели/сегмента) — **отдельное подтверждение на каждую**.326327## Фаза D. Применение328329По одобренному, строго по `write-safety.md`: `changes_log.py record` (before) → боевой вызов → дописать after + ID. `goals_update` — только **полным объектом** (взятым из `goals_get` и изменённым), иначе Метрика сбросит пропущенные поля. Ошибка → статус `failed` в журнале, не молчи.330331## Фаза E. Проверка и передача332333- `goals_get` — новые цели на месте, ID записаны.334- Цели по JS-событиям — выдай **ТЗ разработчику** (`goals-design.md` → «ТЗ на JS-событие») с готовым кодом `ym(<counter_id>, 'reachGoal', '<id>')`.335- Цели не считают задним числом: попроси через 1–2 дня запустить «проверь новые цели» → `goals_get({ stats_days: 2 })`. Ноль достижений при живом трафике → условие не срабатывает, разбираем.336- Если цель для Директа — скажи, какой ID указать в стратегии/ключевых целях (это делается в Директе, не здесь).337- `changes/<дата>/change_report.md`: что сделано, ID, что ждём, как откатить.338339---340341# Стиль работы342343- **Один вопрос за раз**, скоуп — одним блоком с дефолтами.344- **Новая просьба важнее плана.** Сообщение пользователя посреди работы — сначала ответ на345 него, а не следующий шаг из `_state.json`. Просьбу, которую скилл выполнить не может,346 закрывает прямой отказ (раздел «Чего скилл не делает»), после него — стоп.347- **Гипотеза > пустой вопрос.**348- **В чат — 5–10 строк**, таблицы и сырьё — в файлы.349- **Числа с контекстом:** период, объём, сравнение, модель атрибуции словами.350- **Никаких `ym:s:*` и `lastsign` в текстах для человека** — «источник по последнему значимому переходу», «страница входа».351- **В аудите и анализе — только чтение.** Рука тянется поправить цель — стоп, это находка с предложением перейти в Управление.352- **В управлении — dry_run, гейт, журнал.** Ни одной записи без «ОК».353- **References обязательны:** «Прочти …» — требование.354355# Возобновление356357Только по просьбе продолжить; сообщение с другой просьбой — сначала ответ на неё.358359«Продолжаем» → найди `metrika/*/`, прочитай `_state.json` (`mode`, `current_step`) и продолжай с места. Отчёты за уже собранный период не перезапрашивай — они в `raw/`.360361# Карта артефактов362363```364metrika/<slug>/365 _state.json366 pulse.md ← регулярный разбор: метрики, нормы, история367 changes_log.jsonl ← все записи в счётчик (Управление)368 audit/369 01_passport.md370 02_data_quality.md371 03_goals.md 03_goals.json372 04_sources.md 04_utm_hygiene.json 04_findings.json [форк traffic-sources]373 05_direct.md 05_findings.json [форк direct-bridge]374 06_behavior.md 06_findings.json [форк behavior-funnel]375 findings.json ──(render_report.py)──→ АУДИТ_МЕТРИКИ_<slug>.html376 raw/ ← сырые ответы тулов377 analysis/378 <дата>_<тема>.md / .csv raw/379 changes/<дата>/380 before.json proposed.json applied.json change_report.md381```