К основному содержанию
скилл CX Codex

cost-projection — скилл для Claude Code: прогноз расходов

Скилл cost-projection для Claude Code прогнозирует расходы по недавним сессиям. Показывает темп трат, суммы на заданные периоды и срок до достижения лимита.

MIT 249 установок ★ 82 234 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add ruvnet/ruflo --skill cost-projection -a claude-code
Открыть на GitHub

Что делает cost-projection

Скилл читает записи сессий из пространства cost-tracking, берёт данные за измерительное окно и рассчитывает средние расходы в долларах за день. По этому темпу он строит линейный прогноз на 7d, 30d, 90d и 365d; окно и горизонты можно задать флагами. Результат выводится таблицей или в JSON.

Если настроен бюджет через cost-budget set, скилл рассчитывает, через сколько дней будут достигнуты пороги 75%, 90% и 100%, и отмечает уже пройденные. Для работы используются записи session-* и инструмент Bash. Линейный прогноз предполагает, что темп расходов не меняется; после смены нагрузки его нужно пересчитать.

Какие задачи решает

  • спрогнозировать расходы на заданный период
  • оценить, через сколько дней будет достигнут бюджетный порог
  • передать прогноз расходов в бюджетную панель через JSON
  • проверить, приблизился ли расход к полному исчерпанию бюджета

Примеры запросов агенту

  • Рассчитай прогноз расходов на 30d по последним 7d и выведи JSON.
  • Покажи, через сколько дней будут достигнуты пороги бюджета 75%, 90% и 100%.
  • Спрогнозируй расходы на 7d, 30d и 90d в виде таблицы.

Как установить cost-projection

1Через Skills CLI (Vercel)

npx skills add ruvnet/ruflo --skill cost-projection -a claude-code

2Вручную: положить файлы

~/.claude/skills/cost-projection/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/cost-projection/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о cost-projection

Как установить cost-projection в Claude Code?

Выполни npx skills add ruvnet/ruflo --skill cost-projection -a claude-code, затем открой ~/.claude/skills/cost-projection/SKILL.md.

Что делает cost-projection?

Скилл рассчитывает дневной темп расходов по записям недавних сессий и экстраполирует его на выбранные периоды. Если настроен бюджет, он также показывает время до достижения порогов.

Как cost-projection учитывает изменение темпа расходов?

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

Исходный текст

SKILL.md · MIT
---
name: cost-projection
description: Forward-looking spend extrapolation. Computes a USD-per-day rate from the recent measurement window, projects to 7d/30d/90d/365d horizons, and surfaces "days until budget exhausted" when a budget is configured. Predictive counterpart to `cost-budget-check` (reactive).
argument-hint: "[--window 7d] [--horizons 7d,30d,90d,365d] [--format table|json]"
allowed-tools: Bash
disable-model-invocation: true
---

Forward-looking cost projection that pairs with `cost-budget-check`:

- **`cost-budget-check`** answers "have we crossed the line?" — reactive
- **`cost-projection`** answers "when will we cross the line?" — predictive

## Algorithm

1. Read all `session-*` records from the `cost-tracking` namespace (same source `cost-budget-check` uses).
2. Filter to a measurement window (default last 7 days on `capturedAt`/`startedAt`).
3. Compute the per-day burn rate: `windowSpend / windowDays`.
4. Linear-extrapolate to each requested horizon (default 7d/30d/90d/365d).
5. If a budget is configured (`budget-config` key set by `cost-budget set`):
   - Compute "days until 75% / 90% / 100% consumed" at the current rate.
   - Surface as a separate table block with `ALREADY REACHED` markers for thresholds already exceeded.

## Flags

  --window <duration>     Measurement window. `Nh|Nd|Nw|Nm`. Default `7d`.
  --horizons <csv>        Projection horizons. Default `7d,30d,90d,365d`.
  --format table|json     Default `table` (markdown).

Env: `PROJECTION_NAMESPACE` override (default `cost-tracking`), `PROJECTION_QUIET=1` (alias for `--format json`).

## Smoke transcript (3 sessions × $1 over 7d, $20 budget)

```
| Sessions in window | 3 |
| Window spend | $3.000000 |
| **USD per day** | **$0.428571** |
| All-time spend | $3.000000 across 3 sessions |

## Projected spend (linear extrapolation)
| Horizon | Days | Projected spend |
|---|---:|---:|
| 7d | 7 | $3.0000 |
| 30d | 30 | $12.8571 |

## Budget exhaustion ($20.00 configured)
| Threshold | Target | Remaining | Time at current rate |
|---|---:|---:|---|
| 75% | $15.00 | $12.00 | 28.0 days |
| 90% | $18.00 | $15.00 | 35.0 days |
| 100% | $20.00 | $17.00 | 39.7 days |
```

## When to use

- **Finance / SRE planning**: hand the JSON output to a budget dashboard for "are we on track for the quarter?".
- **CI gates**: `cost-projection --format json | jq '.budget.exhaustion[2].daysUntilReached < 7'` → fail builds when 100% exhaustion is < 1 week away.
- **Post-workload-shift sanity check**: after a big feature lands, re-run to verify the rate hasn't accelerated past expectations.

## Stationarity assumption

Linear extrapolation assumes the current rate holds. The footer reminds operators to re-run after workload shifts. For drift detection over MULTIPLE windows, pair with `cost-trend` (which already covers benchmark-drift).

© ruvnet · MIT · ruvnet/ruflo

Похожие скиллы

Все скиллы по теме «Финансы и бизнес» →
ccam-cost-guard Son Nguyen Хук ccam-cost-guard отслеживает расходы на Claude Code и отправляет данные о завершении сессий в дашборд Agent Monitor. CX Codex ★ 1 198звёзд репо forecast Son Nguyen Команда forecast считает, сколько вы потратите к концу недели или месяца: берёт счётчики сессий и стоимость из дашборда на localhost:4820 и достраивает прогноз по средней цене сессии. CX Codex +1 ★ 1 198звёзд репо change-order-processor datadrivenconstruction Скилл change-order-processor для Claude Code, Codex, Cursor, GitHub Copilot и других агентов, который ведёт журнал изменений строительного контракта: стоимость, статус согласования, сдвиг сроков. CX Codex +1 123установок Agent Cost Report thedotmack Скилл Agent Cost Report для Claude Code и Codex формирует отчёт о расходах агентов за выбранный период. Запускается при оценке затрат на сессии и поиске потерь от переделок или зацикливаний. CX Codex +1 816установок cost-accrual-tracker curiositech Скилл cost-accrual-tracker для Claude Code и пяти других платформ, который считает расходы на API в режиме реального времени во время выполнения LLM-запросов. Фиксирует частичные затраты даже при прерванных запросах. CX Codex +1 175установок cwicr-cost-calculator datadrivenconstruction Скилл cwicr-cost-calculator для Claude Code рассчитывает стоимость строительных работ по методологии CWICR, разбивая затраты на труд, материалы и оборудование с прозрачными расчётами. CX Codex +1 138установок

Из того же набора155

Весь набор →
gaia-debugging Скилл gaia-debugging разбирает, почему задача из бенчмарка GAIA провалилась: достаёт трейс, классифицирует ошибку и предлагает исправление. Запускается, когда gaia-bench run вернул failed или неверный ответ для task_id. CX Codex +1 436установок gaia-architecture-comparison Скилл gaia-architecture-comparison для Claude Code, Codex, Cursor, Copilot и Gemini CLI, который сравнивает harness ruflo с эталонной реализацией HAL от Princeton по девяти параметрам — от покрытия вопросов до исполнения кода. CX Codex +1 433установок nested-subagents Скилл nested-subagents для Claude Code строит дерево субагентов, где каждый ребёнок может породить своих детей. Разносит промежуточное состояние, не помещающееся в контекст одного агента. CX Codex +1 317установок cost-session Скилл cost-session для Claude Code детализирует затраты на каждое сообщение внутри сессии, показывая дорогие запросы. CX Codex +1 249установок cost-health Скилл cost-health гоняет четыре проверки расходов параллельно и отдаёт один статус: бюджет, ускорение трат, аномалии сессий и прогноз исчерпания. CX Codex +1 249установок cost-counterfactual Скилл cost-counterfactual сравнивает реальные траты на сессии с гипотетическими сценариями always-haiku, always-sonnet и always-opus. Помогает понять, окупается ли роутер моделей. CX Codex +1 249установок cost-diff Скилл cost-diff для Claude Code сравнивает два JSON-снимка расходов. Запускается, чтобы проверить, увеличила ли PR-ветка затраты относительно базового снимка. CX Codex +1 248установок cost-burn Скилл cost-burn для Claude Code и других платформ, анализирующий ускорение трат на продакшене. Запускается в CI для проверки, не вышла ли скорость расходования средств за пределы среднего значения. CX Codex +1 248установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой