Навык «Очистка базовой линии»: пишем методику один разThe "baseline cleaning" skill: write the method once

---
name: baseline-clean
description: Очистка базовой линии продаж по стране за месяц — склеить коды, убрать возвраты, промо и затаривание, вернуть часть OOS по методике rules.md. Пример запуска: /baseline-clean KAZ 2026-10
disable-model-invocation: true
argument-hint: [страна] [месяц ГГГГ-ММ]
allowed-tools: Read Bash(python *)
---
# Очистка базовой линии: $ARGUMENTS
Методика и параметры — в [rules.md](rules.md). Проверки — в [checks.md](checks.md).
Справочник событий — events.csv. Считает только скрипт; ты проверяешь и объясняешь.
## Шаг 1. Входы (остановись, если…)
1. В папке data/ есть выгрузка продаж по стране $0 за 24 месяца до $1 включительно.
   Нет файла или нет месяца — остановись и скажи мне.
2. Все коды из выгрузки есть в справочнике переключений codes_switch.csv
   или в справочнике SKU. Неизвестный код — остановись и покажи список.
3. В events.csv есть строки за $1 (хотя бы «событий нет»).
   Нет — остановись и спроси меня про промо, OOS и повышения цен.
## Шаг 2. Расчёт
4. Запусти: python ${CLAUDE_SKILL_DIR}/scripts/clean_baseline.py $ARGUMENTS
5. Цифры руками не меняй и в уме не пересчитывай. Скрипт упал — покажи ошибку
   и остановись.
6. Исходные файлы только читай. Результат — новый файл
   output/baseline_$0_$1.xlsx рядом с исходными.
## Шаг 3. Проверки (подробно — checks.md)
7. По каждой строке город × SKU × месяц: база − в т.ч. OOS + блоки = факт
   без возвратов, до литра. Не сошлось — остановись и покажи строки.
8. База не меньше нуля.
9. База больше 2× своей медианы за 12 месяцев, а события нет — в список «проверить».
10. Промо, упёршееся в предел promo_cap, — в список «проверить».
## Шаг 4. Отчёт мне
11. Пять строк: факт, база, в т.ч. OOS, блоки (тыс. л); сколько строк
    в «проверить»; что изменилось против прошлого месяца.
12. Правило не подходит к данным — не придумывай своё, спроси меня.

---
name: baseline-clean
description: Clean the sales baseline for a country and month — glue codes, drop returns, promo and stocking, add back part of OOS by the method in rules.md. Example: /baseline-clean KAZ 2026-10
disable-model-invocation: true
argument-hint: [country] [month YYYY-MM]
allowed-tools: Read Bash(python *)
---
# Baseline cleaning: $ARGUMENTS
Method and parameters — in [rules.md](rules.md). Checks — in [checks.md](checks.md).
Event register — events.csv. Only the script calculates; you check and explain.
## Step 1. Inputs (stop if…)
1. The data/ folder has the sales export for country $0, 24 months up to $1 inclusive.
   No file or no month — stop and tell me.
2. Every code in the export is in the code-switch register codes_switch.csv
   or in the SKU list. Unknown code — stop and show the list.
3. events.csv has rows for $1 (at least "no events").
   None — stop and ask me about promo, OOS and price rises.
## Step 2. Calculation
4. Run: python ${CLAUDE_SKILL_DIR}/scripts/clean_baseline.py $ARGUMENTS
5. Don't change numbers by hand or recalculate in your head. Script failed — show
   the error and stop.
6. Only read the source files. The result is a new file
   output/baseline_$0_$1.xlsx next to the sources.
## Step 3. Checks (details — checks.md)
7. For every city × SKU × month row: base − of which OOS + blocks = actual
   without returns, to the litre. No match — stop and show the rows.
8. The base is never below zero.
9. Base above 2× its 12-month median with no event — add to the "to check" list.
10. Promo that hit the promo_cap limit — add to the "to check" list.
## Step 4. Report to me
11. Five lines: actual, base, of which OOS, blocks (thousand L); how many rows
    are in "to check"; what changed vs last month.
12. A rule doesn't fit the data — don't invent your own, ask me.

# Методика очистки базовой линии · версия 1.0
Уровень расчёта: город × SKU × месяц, литры.
Порядок применения — строго сверху вниз.
## Параметры
| Параметр  | Значение | Смысл |
|-----------|----------|-------|
| window    | 3        | обычный уровень = среднее базы 3 предыдущих месяцев |
| oos_share | 0,5      | какую долю потерянного на OOS спроса возвращаем в базу |
| promo_cap | 1,6      | промо-блок не больше (promo_cap − 1) × обычный уровень |
| pair_split| поровну  | затаривание + провал: база каждого месяца = сумма пары / 2 |
| flag_x    | 2        | база выше 2× медианы 12 мес. без события — «проверить» |
## Правила
1. Склеить переключения кодов (старый → новый) по codes_switch.csv — до всех правил.
2. Убрать возвраты (строки с минусом).
3. OOS: в т.ч. OOS = (обычный − факт) × oos_share; база = факт + в т.ч. OOS.
   Показывать плюсом внутри базы, не строкой с минусом.
4. Промо: блок = факт − обычный, но не больше (promo_cap − 1) × обычный.
   Остаток — в базе, строка — в «проверить».
5. Затаривание перед повышением цены и провал после — одна пара: сумма сохраняется,
   база = сумма / 2 каждому месяцу, блок «перенос» +X и −X.
6. Праздники не чистим — это сезон.
7. Обычные скидки дистрибуторам остаются в базе.
8. Изменение числа точек не чистим — база идёт за покрытием.
## Тождество
база − в т.ч. OOS + блоки = факт без возвратов (до литра)
## Журнал изменений
| Дата       | Версия | Что поменяли    | Кто утвердил |
|------------|--------|-----------------|--------------|
| 2026-11-02 | 1.0    | первая версия   | планер       |

# Baseline cleaning method · version 1.0
Level: city × SKU × month, litres.
Apply strictly top to bottom.
## Parameters
| Parameter | Value  | Meaning |
|-----------|--------|---------|
| window    | 3      | ordinary level = average base of the 3 previous months |
| oos_share | 0.5    | share of demand lost to OOS that we add back to the base |
| promo_cap | 1.6    | promo block at most (promo_cap − 1) × ordinary level |
| pair_split| equal  | stocking + dip: each month's base = pair total / 2 |
| flag_x    | 2      | base above 2× the 12-month median with no event — "to check" |
## Rules
1. Glue code switches (old → new) by codes_switch.csv — before all other rules.
2. Drop returns (minus rows).
3. OOS: of which OOS = (ordinary − actual) × oos_share; base = actual + of which OOS.
   Show it as a positive inside the base, not as a minus row.
4. Promo: block = actual − ordinary, but no more than (promo_cap − 1) × ordinary.
   The rest stays in the base, the row goes to "to check".
5. Stocking before a price rise and the dip after it are one pair: the total is kept,
   base = total / 2 for each month, a "transfer" block +X and −X.
6. Holidays are not cleaned — it is seasonality.
7. Regular distributor discounts stay in the base.
8. A change in the number of outlets is not cleaned — the base follows coverage.
## Identity
base − of which OOS + blocks = actual without returns (to the litre)
## Change log
| Date       | Version | What changed   | Approved by |
|------------|---------|----------------|-------------|
| 2026-11-02 | 1.0     | first version  | planner     |

Напиши скрипт .claude/skills/baseline-clean/scripts/clean_baseline.py строго по методике rules.md — ничего не добавляй от себя. Вход: выгрузка продаж из data/, events.csv, codes_switch.csv. Аргументы: страна и месяц. Выход: новый файл output/baseline_<страна>_<месяц>.xlsx — по строке на город × SKU × месяц: факт, возвраты, база, в т.ч. OOS, промо, перенос, флаг «проверить» и причина флага. Числа — числами, без заливок и объединённых ячеек. Исходные файлы не менять, без абсолютных путей. Сначала покажи план. Потом проверим на трёх SKU, которые я посчитаю руками: я дам цифры, а ты покажешь, совпало ли до литра.

Write the script .claude/skills/baseline-clean/scripts/clean_baseline.py strictly by the method in rules.md — add nothing of your own. Input: the sales export from data/, events.csv, codes_switch.csv. Arguments: country and month. Output: a new file output/baseline_<country>_<month>.xlsx — one row per city × SKU × month: actual, returns, base, of which OOS, promo, transfer, a "to check" flag and the flag reason. Numbers as numbers, no fills or merged cells. Don't change source files, no absolute paths. Show me the plan first. Then we'll test on three SKUs I calculate by hand: I'll give you the numbers and you show whether they match to the litre.

Я планер. Хочу навык проекта .claude/skills/baseline-clean, который каждый месяц очищает базовую линию продаж. Возьми у меня интервью: задавай вопросы по одному и жди ответа. Спроси: на каком уровне считаем, откуда данные, как отмечены промо, OOS, затаривание, возвраты, переключения кодов; что считать обычным уровнем; что делать с праздниками, скидками и точками; какие проверки обязательны и когда останавливаться. Потом покажи мне rules.md (методика, параметры таблицей, журнал изменений) и SKILL.md (шапка: name, description, disable-model-invocation: true, argument-hint; шаги со «остановись, если…»). Ничего не сохраняй, пока я не скажу «сохраняй».

I am a planner. I want a project skill .claude/skills/baseline-clean that cleans the sales baseline every month. Interview me: ask questions one at a time and wait for the answer. Ask: what level we calculate at, where the data comes from, how promo, OOS, stocking, returns and code switches are marked; what counts as the ordinary level; what to do with holidays, discounts and outlets; which checks are mandatory and when to stop. Then show me rules.md (method, parameters as a table, change log) and SKILL.md (header: name, description, disable-model-invocation: true, argument-hint; steps with "stop if…"). Don't save anything until I say "save".

# Проверки результата очистки
1. Тождество по каждой строке: база − в т.ч. OOS + блоки = факт без возвратов (до литра).
2. Сумма по стране за месяц: факт в результате = факт в исходной выгрузке без возвратов.
3. База ≥ 0 во всех строках.
4. Блоки «перенос» по каждой паре в сумме дают 0.
5. Промо-блок ≤ (promo_cap − 1) × обычный уровень.
6. База > 2× медианы 12 мес. без события — в список «проверить».
7. Число строк город × SKU после склейки = числу живых SKU в справочнике.

# Result checks for cleaning
1. Identity on every row: base − of which OOS + blocks = actual without returns (to the litre).
2. Country total for the month: actual in the result = actual in the source export without returns.
3. Base ≥ 0 on every row.
4. "Transfer" blocks sum to 0 for every pair.
5. Promo block ≤ (promo_cap − 1) × ordinary level.
6. Base > 2× the 12-month median with no event — to the "to check" list.
7. Number of city × SKU rows after gluing = number of live SKUs in the register.

---
name: baseline-clean
description: Очистка базовой линии продаж по приложенному файлу — склеить коды, убрать возвраты, промо и затаривание, вернуть часть OOS по методике rules.md.
---

---
name: baseline-clean
description: Clean the sales baseline from the attached file — glue codes, drop returns, promo and stocking, add back part of OOS by the method in rules.md.
---