# spend-forecast

Считает, во сколько обойдётся работа к концу недели или месяца, по дневному тренду сессий на дашборде Agent Monitor.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 1121
- Автор: hoangsonww
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/hoangsonww/Claude-Code-Agent-Monitor/tree/HEAD/plugins/ccam-cost-guard/skills/spend-forecast/SKILL.md
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/skills/spend-forecast

## Что делает

Скилл берёт данные с эндпоинтов Agent Monitor: `GET /api/analytics` отдаёт `daily_sessions` за 365 дней, `GET /api/pricing/cost` — потраченную сумму и разбивку по моделям, `GET /api/sessions?limit=200` — список сессий с полем `cost` и временем старта. Отдельного поля «расход за день» нет, поэтому скилл строит дневной ряд сам: либо умножает число сессий на среднюю стоимость одной, либо суммирует `cost` по датам старта — второй способ точнее.

Дальше считается средний дневной расход за последние 7 дней и за 14 дней, чтобы понять, растёт темп или падает. Прогноз — это средний дневной расход, умноженный на число оставшихся дней, плюс уже потраченное за текущий период. Если тренд захватывает больше одного периода, потраченное ограничивают сессиями текущей недели или месяца, иначе цифра раздувается за счёт старых трат.

Горизонт задаётся аргументом: `"week"`, `"month"` или конкретная дата. Без аргумента берётся календарный конец месяца, и скилл пишет, какой горизонт использовал. Если назвать бюджет, он покажет разницу и дату, когда бюджет будет пройден. Прогноз исходит из того, что недавний темп сохранится, а при малом числе активных дней точность падает — меньше 7 активных дней он отмечает сам.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill spend-forecast -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/spend-forecast/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/spend-forecast/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill spend-forecast -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/spend-forecast/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill spend-forecast -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/spend-forecast/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install hoangsonww/Claude-Code-Agent-Monitor spend-forecast
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/spend-forecast/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill spend-forecast -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/hoangsonww/Claude-Code-Agent-Monitor --path plugins/ccam-cost-guard/skills/spend-forecast
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/spend-forecast/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill spend-forecast -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/hoangsonww/Claude-Code-Agent-Monitor/tree/HEAD/plugins/ccam-cost-guard/skills/spend-forecast/SKILL.md

## Когда брать
- спрогнозировать расход к концу месяца по текущему темпу
- понять, растёт дневная трата или падает
- узнать, когда будет пройден заданный бюджет
- сравнить средний расход за 7 и 14 дней
- построить дневную кривую стоимости по сессиям

## Примеры запросов агенту
- Спрогнозируй расход до конца месяца
- Где окажется мой spend к концу недели?
- Бюджет 200 долларов — когда я его пройду?

## Похожие
- [sales-forecast-diagnostic](https://affpapa.org/nevibecode/skills/sales-forecast-diagnostic.md) — скилл · 21200 установок
- [forecast](https://affpapa.org/nevibecode/skills/forecast.md) — скилл · 3000 установок
- [earth2studio-deterministic-forecast](https://affpapa.org/nevibecode/skills/earth2studio-deterministic-forecast.md) — скилл · 1900 установок
- [sales-forecast-builder](https://affpapa.org/nevibecode/skills/sales-forecast-builder.md) — скилл · 342 установки
- [ad-spend-allocation](https://affpapa.org/nevibecode/skills/ad-spend-allocation.md) — скилл · 20600 установок
- [cost-budget-check](https://affpapa.org/nevibecode/skills/cost-budget-check.md) — скилл · 692 установки

Из того же набора: [hoangsonww/claude-code-agent-monitor](https://affpapa.org/nevibecode/by/hoangsonww/claude-code-agent-monitor.md) — 20 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md