# add-report

Руководство по разработке карточек отчётов для ClaudeBar. Помогает рассчитывать дельты расходов и токенов по дням по методологии TDD.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 1557
- Автор: tddworks
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/tddworks/ClaudeBar/tree/HEAD/.claude/skills/add-report/SKILL.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/skills/add-report

## Что делает

Скилл задаёт регламент добавления аналитических карточек в ClaudeBar. Он рассчитан на визуализацию истории использования (токены или затраты) со сравнением периодов, например недели к прошлой неделе. Архитектура требует вычислять отчёт строго поверх дней, уже полученных через `account.usageHistory?.days(in:)`. Дополнительный код для чтения файлов не создаётся.

Разработка делится на фазы. Сначала оформляется макет в каталоге `design-concept/` и согласовывается с пользователем через `AskUserQuestion`. Затем создаётся структура отчёта в модуле `Quotas` строго по TDD с именованием тестов по шаблону `should <outcome> [when <situation>]`. Карточка в интерфейсе `App` только отображает вычисленные дельты и проценты.

В ClaudeBar запрещены фоновые вычисления: генерация отчёта запускается только при открытии всплывающего окна. Менять `UsageSnapshot` напрямую или добавлять парсеры в `Sources/Infrastructure` нельзя — для новых форматов логов пишутся отдельные ридеры в модуле `Modules/DataSources`.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add tddworks/ClaudeBar --skill add-report -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add tddworks/ClaudeBar --skill add-report -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add tddworks/ClaudeBar --skill add-report -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install tddworks/ClaudeBar add-report
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add tddworks/ClaudeBar --skill add-report -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/tddworks/ClaudeBar --path .claude/skills/add-report
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add tddworks/ClaudeBar --skill add-report -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/tddworks/ClaudeBar/tree/HEAD/.claude/skills/add-report/SKILL.md

## Когда брать
- добавить карточку сравнения расходов за текущую и прошлую недели
- рассчитать дельту потребления токенов без прямого чтения логов с диска
- согласовать макет аналитического отчёта перед написанием Swift-кода
- написать тесты для структуры отчёта в модуле Quotas по TDD

## Примеры запросов агенту
- Добавь в ClaudeBar карточку сравнения расходов за эту и прошлую недели по скиллу add-report
- Спроектируй отчёт по токенам моделей за последние 30 дней для активного аккаунта
- Создай структуру MonthlyReport в модуле Quotas и напиши для неё тесты

## Похожие
- [setup-matt-pocock-skills](https://affpapa.org/nevibecode/skills/setup-matt-pocock-skills.md) — скилл · 1052851 установка
- [ask-matt](https://affpapa.org/nevibecode/skills/ask-matt.md) — скилл · 766587 установок
- [to-tickets](https://affpapa.org/nevibecode/skills/to-tickets.md) — скилл · 711230 установок
- [writing-plans](https://affpapa.org/nevibecode/skills/writing-plans.md) — скилл · 282859 установок
- [caveman-review](https://affpapa.org/nevibecode/skills/caveman-review.md) — скилл · 411800 установок
- [caveman-compress](https://affpapa.org/nevibecode/skills/caveman-compress.md) — скилл · 411500 установок

Из того же набора: [tddworks/claudebar](https://affpapa.org/nevibecode/by/tddworks/claudebar.md) — 6 карточек

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

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