cash-flow-snapshot · ilyautov — Claude Code skill for cash-flow forecasts

---
name: cash-flow-snapshot
description: >
  Берёт дебиторку и кредиторку, историю сроков поступления денег и известные
  постоянные расходы из бухгалтерии (1С, МойСклад) и платёжных сервисов
  (ЮKassa, Тинькофф, банк-выписка) — или из выгрузки CSV — и строит прогноз
  денежного потока на 30/60/90 дней с доверительными коридорами по проценту
  отклонения и поимёнными флагами рисков. На выходе — сводка в чат и XLSX для
  скачивания. Триггеры: «посчитай денежный поток», «спрогнозируй кэшфлоу»,
  «хватит ли на зарплату», «на сколько хватит денег», «запас прочности»,
  «кассовый разрыв», «хватит ли на налоги». В выплаты ВКЛЮЧАЕТ предстоящие налоги и взносы (из навыка tax-calendar-proactive) — именно они чаще всего создают кассовый разрыв. Если коннектор не подключён — переходит на выгрузку CSV или грубый режим по средним.
compatibility: "Нужен хотя бы один из: коннектор ~~бухгалтерия (1С/МойСклад), коннектор ~~платежи (ЮKassa/Тинькофф/банк-выписка), загрузка файла (fallback на CSV). Вывод использует skill xlsx."
---

<!-- Производное от Anthropic knowledge-work-plugins / small-business (Apache-2.0, (c) Anthropic). Локализовано под РФ, файл изменён. См. /NOTICE и /LICENSE. -->

# Прогноз денежного потока

Кассовый разрыв не сваливается как снег на голову — он виден за недели, если
кто-то держит перед глазами календарь платежей. Чаще всего рвут кассу именно
налоги и взносы, про которые забыли. Этот скилл смотрит за вас: на 30/60/90
дней вперёд, с поимёнными флагами «вот тут не хватит и вот почему».

Результат в двух частях: краткая сводка в чат и XLSX-книга для скачивания —
с доверительными коридорами по проценту отклонения.

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

> «Хватит ли мне денег на зарплату в следующем месяце?»

Claude подтягивает дебиторку/кредиторку и постоянные расходы из подключённых
источников, считает ожидаемые поступления и выплаты в окнах 30, 60 и 90 дней,
накладывает доверительные коридоры на основе исторического разброса сроков
оплаты по каждому клиенту и помечает конкретные риски по имени.

---

## Рабочий процесс

### Шаг 1 — Определить доступные источники данных

Проверь, какие коннекторы подключены. Пробуй в таком порядке:

1. `~~бухгалтерия` (например, 1С:Бухгалтерия или МойСклад) — основной источник
   по дебиторке (нам должны), кредиторке (мы должны) и постоянным расходам
2. `~~платежи` (например, ЮKassa, Тинькофф Касса, СБП) — история операций и
   сроки зачисления
3. Банк-клиент (выписка) — поступления и списания по расчётному счёту
4. Загрузка CSV — fallback, если ни один коннектор не подключён

Если ни один коннектор не подключён и файл не приложен, попроси собственника
либо подключить источник, либо выгрузить CSV (таблица доходов/расходов в любом
разумном формате). Отметь в выводе, какие источники использованы — это влияет
на ширину доверительного коридора.

**Грубый режим (zero-prompt, когда данных нет вообще):** если собственник не
готов выгружать файл — спроси 4 числа простыми словами: «сколько сейчас на
счету», «сколько в среднем приходит в месяц», «сколько в среднем уходит в
месяц», «кто и сколько должен с примерным сроком». Этого хватает на грубый
прогноз с широким коридором (±40–50%) и пометкой «оценка по средним, без
детализации». Лучше грубый прогноз сегодня, чем точный никогда.

### Шаг 2 — Подтянуть данные

**Из `~~бухгалтерия` (1С / МойСклад):**
- Дебиторская задолженность с разбивкой по срокам: клиент, сумма счёта, дата
  счёта, срок оплаты, дней просрочки
- Кредиторская задолженность: поставщик, сумма к оплате, срок оплаты
- Регулярные постоянные расходы: аренда, зарплата, подписки (искать
  повторяющиеся операции)

**Из `~~платежи` (ЮKassa / Тинькофф / банк-выписка):**
- История зачислений: дата операции, сумма, дата фактического поступления
  на счёт
- По задержке зачисления (дата операции → дата поступления) считай средний и
  разброс задержки оплаты по каждому источнику

**Из выгрузки CSV:**
- Парсить как таблицу доходов/расходов
- Нужные столбцы (названия гибкие): дата, сумма, тип (доход или расход),
  описание
- Если столбцы неоднозначны — покажи строку заголовка и попроси собственника
  подтвердить разметку

**Налоговые обязательства (обязательный отток — часто забывают):**
- Запусти логику навыка `tax-calendar-proactive`: по профилю бизнеса (форма,
  режим, оборот) определи предстоящие в окнах 30/60/90 налоги и взносы —
  авансы УСН (28.04/28.07/28.10), фикс. взносы ИП (28.12), доп. 1% (01.07),
  НДФЛ/взносы за сотрудников (ЕНП, 28 числа).
- Каждый такой платёж добавь как запланированную выплату на его дату с суммой
  из канона (`RULES.md` раздел 4). Это не «постоянный расход» —
  это разовые крупные оттоки, которые рвут кассу именно потому, что про них
  забывают.

### Шаг 3 — Посчитать исторические сроки оплаты

Для каждого клиента-должника (или источника дохода из CSV) посчитай:
- **Средняя задержка оплаты** — среднее число дней от даты счёта/операции до
  поступления денег
- **Разброс оплаты** — стандартное отклонение задержки по последним 6–12
  платежам
- Используй разброс для ширины доверительного коридора (см. Шаг 4)

Если по клиенту меньше 3 платежей — бери среднее по всей базе как точечную
оценку и применяй коридор по умолчанию ±30%. Когда данных по CSV достаточно
(≥3 платежей на источник), считай коридор из фактического разброса — не
подставляй ±30% автоматически.

### Шаг 4 — Построить прогноз на 30/60/90 дней

Сделай три временных окна: 0–30 дней, 31–60 дней, 61–90 дней.

Для каждого окна посчитай:

| Строка | Метод |
|---|---|
| Ожидаемые поступления | Дебиторка со сроком в окне, скорректированная на среднюю задержку оплаты |
| Ожидаемые выплаты | Кредиторка со сроком в окне + постоянные расходы, попадающие в окно |
| Чистая денежная позиция | Поступления − Выплаты |
| Доверительный коридор | ± средневзвешенный разброс оплаты как % от ожидаемых поступлений |

Формула доверительного коридора:
```
коридор_% = средневзв_стд_отклонение_дней / средняя_задержка_дней
низ  = чистый_поток × (1 − коридор_%)
верх = чистый_поток × (1 + коридор_%)
```

Округляй коридор_% до одного знака после запятой. Ограничивай ±50% — больший
разброс означает, что данных слишком мало для модели; вместо этого помечай это
флагом (см. Шаг 5).

### Шаг 5 — Пометить риски поимённо

Найди условия, при которых нижняя граница коридора уходит в минус или
возникает кассовый разрыв. Для каждого риска дай однострочный флаг:

- **Риск просрочки:** «Клиент X исторически платит на 18 дней позже срока;
  это сдвигает его счёт на 84 000 ₽ из окна 30 дней на 48-й день.»
- **Кассовый разрыв на зарплату:** «Зарплата (220 000 ₽) выпадает на 15.04.
  Деньги на счёте по нижней границе на 14.04: 192 000 ₽. Риск нехватки:
  28 000 ₽.»
- **Налоговый кассовый разрыв:** «28.07 — аванс УСН (≈150 000 ₽) и 01.07 —
  доп. взнос 1% (77 000 ₽). Суммарно 227 000 ₽ за две недели. Деньги по нижней
  границе на 28.07: 180 000 ₽. Риск нехватки: 47 000 ₽. Совет: придержать
  выплату поставщику X или ускорить оплату от клиента Y.»
- **Предупреждение о нехватке данных:** «По клиенту Y всего 2 платежа в
  истории — коридор выставлен по умолчанию ±30%.»
- **Предупреждение об отсутствии коннектора:** «Считаем только по данным CSV —
  нет данных по кредиторке и регулярным расходам в реальном времени.
  Доверительные коридоры шире обычного.»

Ограничься топ-5 рисками по серьёзности (сначала наибольшие по сумме в рублях).

### Шаг 6 — Выдать результат

**Сводка в чат** (всегда):
```
Прогноз денежного потока — [диапазон дат]
Источник(и): [использованные коннекторы]

              Ожидаемо    Низ       Верх
30 дней нетто: X XXX ₽    X XXX ₽   X XXX ₽
60 дней нетто: X XXX ₽    X XXX ₽   X XXX ₽
90 дней нетто: X XXX ₽    X XXX ₽   X XXX ₽

⚠ Помечено рисков: [количество]
  • [риск 1]
  • [риск 2]
  ...
```

**XLSX-книга** (всегда):
Перед генерацией прочитай `xlsx/SKILL.md`. Сделай книгу из трёх листов:

1. **Сводка** — таблица прогноза 30/60/90 с доверительными коридорами. Под
   строкой каждого окна разверни подстроки с отдельными операциями, из которых
   складываются поступления (зелёным) и выплаты (красным). Так оценку можно
   проверить, не уходя с листа «Сводка».

2. **Детализация** — все операции, сгруппированные по окнам, отсортированные по
   дате внутри группы. Включи столбец с нарастающим итогом (накопленные
   поступления минус выплаты внутри окна) и строку-итог внизу каждого окна с
   суммой поступлений, выплат и нетто. Прошедшие операции вынеси серым в
   отдельный раздел внизу для справки. Проследи, чтобы у всех трёх окон были
   строки, даже если одно пустое — покажи строку-заглушку «В этом окне операций
   нет».

3. **Риски** — помеченные риски с суммой в рублях и затронутым окном.

Сохрани как `cash-flow-snapshot-[ГГГГ-ММ-ДД].xlsx`.

---

## Точки подтверждения (approval gates)

Необратимых действий нет — скилл работает только на чтение. Подтверждение перед
построением прогноза не требуется.

Напомни собственнику после выдачи:
> «Этот прогноз построен на основе [перечисленные источники]. Подготовлено для
> проверки вашим бухгалтером. Не является налоговой или финансовой
> консультацией — сверьтесь с бухгалтером, прежде чем принимать решения о
> привлечении финансирования.»

---

## Reference-файлы

| Файл | Когда загружать |
|---|---|
| `reference/gotchas.md` | Когда коннектор вернул неожиданные данные или разброс экстремальный |
| `reference/examples/worked-example.md` | Когда нужен образец формата вывода для нового вида данных |