Мой дэйли дайджест

одно техническое понятие в день

Мастер Claude · Блок 3. Субагенты

Урок 25 из 93 · ~10 мин чтения

Агент-аналитик: CSV → отчёт

Урок пока закрыт

Курс проходится последовательно.

К текущему уроку

Почему это важно именно вам

Каждую неделю у вас на столе появляются таблицы. Выгрузка из CRM с лидами за месяц. Отчёт по звонкам коллцентра. Сводка по рекламным расходам от подрядчика. Данные по застройщикам с Росреестра. Форматы разные, структура разная — но задача одна: взять числа и превратить их в понятную картину для принятия решений.

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

Агент-аналитик убирает вас из этого цикла. Вы один раз описываете, что значит «хороший отчёт» в вашем понимании: какая структура, какие акценты, какой уровень детализации. Агент запоминает эти правила и применяет их к любой таблице без дополнительных объяснений. Дальше — одна команда, результат в файле.

Что это такое

Субагент в Claude Code — это специализированный исполнитель с чётко заданной ролью. Он живёт в файле .claude/agents/имя.md, получает задачу от вас или от оркестратора, выполняет её и возвращает результат. На День 22 вы создали первого агента и поняли базовую структуру. На День 24 разобрались с ограничением инструментов — агент получает только то, что ему реально нужно.

Агент-аналитик — практическое применение этой архитектуры. Его задача: читать CSV-файл, понять структуру данных, найти закономерности и аномалии, написать управленческий отчёт в нужном формате. Ничего лишнего. Никаких отвлечений на другие задачи.

Аналогия из жизни компании: это как нанять хорошего аналитика на аутсорсе, который знает ваш стиль отчётности. Вы не объясняете ему каждый раз, как оформлять таблицы или что писать в executive summary. Он знает — потому что вы один раз прописали это в техническом задании. Просто передаёте файл и получаете готовый документ.

Технически агент работает с двумя инструментами: Read (читает содержимое файлов) и Glob (находит файлы по паттерну). Этого достаточно для анализа любой таблицы. Писать в файловую систему, запускать команды, обращаться к сети — ничего этого агенту не нужно, а значит, не даём.

Минимальные инструменты — предсказуемый агент

Агент с инструментами Read и Glob не может случайно удалить файл, отправить данные куда-то наружу или запустить системную команду. Чем меньше возможностей — тем безопаснее и предсказуемее поведение. Это не ограничение, это проектирование.

Как работает на практике

Шаг 1. Создайте папку агентов

Если папки .claude/agents/ ещё нет в вашей рабочей директории, создайте её:

mkdir -p .claude/agents

Проверьте структуру вашей рабочей папки:

рабочая-папка/
├── CLAUDE.md
├── .claude/
│   ├── agents/          ← сюда кладём агентов
│   └── rules/
├── Данные/              ← сюда кладём CSV-файлы
└── Отчёты/              ← сюда агент будет писать результаты

Шаг 2. Создайте файл агента

Создайте файл .claude/agents/data-analyst.md. Это и есть агент — весь его «мозг» описан в этом файле.

---
name: data-analyst
description: Анализирует CSV-файлы и пишет управленческие отчёты. Вызывать когда нужно превратить табличные данные в структурированный отчёт с выводами и рекомендациями.
model: opus
tools: Read, Glob
---

Ты аналитик данных, который пишет краткие управленческие отчёты для директора по развитию. Твоя задача — читать CSV-файлы, находить главное и формулировать выводы понятным языком, без технического жаргона.

## Как ты работаешь

1. Читаешь CSV-файл с помощью инструмента Read
2. Определяешь структуру: сколько строк, какие колонки, какой период охвачен
3. Находишь ключевые метрики: суммы, средние, максимумы, минимумы
4. Выявляешь аномалии: что сильно выбивается из общего ряда
5. Сравниваешь с предыдущим периодом, если данные позволяют
6. Пишешь отчёт строго по шаблону ниже

## Формат отчёта

Отчёт состоит из четырёх обязательных разделов:

**Ситуация (3-4 предложения)**
Что за данные, период, общий объём. Одна цифра-заголовок — самое важное число, которое нужно знать.

**Ключевые показатели**
Таблица с 4-6 метриками: название, значение, сравнение с прошлым периодом если есть, оценка (▲/▼/—).

**На что обратить внимание**
2-3 конкретных аномалии или тренда с цифрами. Не «есть рост», а «рост на 23% в сегменте X по сравнению с Y».

**Рекомендации**
1-2 конкретных действия. Не советы в стиле «стоит рассмотреть», а чёткие формулировки: «проверить», «уточнить у», «запустить», «остановить».

## Правила

- Числа всегда с единицами измерения и разделением тысяч: 1 234 567 ₽, не 1234567
- Проценты округлять до одного знака после запятой
- Если данные не позволяют сделать вывод — написать «данных недостаточно», не придумывать
- Не включать сырые данные в отчёт — только интерпретацию
- Отчёт должен умещаться в один экран — максимум 300 слов
- Язык: русский, деловой, без пассивного залога и канцелярита

Шаг 3. Разберём frontmatter агента

Frontmatter — блок между --- в начале файла. Он определяет поведение агента:

Почему в description пишем «когда вызывать»

Claude Code использует description для автоматического делегирования. Когда вы пишете оркестратору «проанализируй этот файл с данными» — оркестратор читает описания всех агентов и выбирает подходящего. Чем точнее описан сценарий использования, тем меньше ошибок делегирования.

Шаг 4. Передайте файл агенту

Допустим, у вас есть файл Данные/звонки_май_2026.csv. Запустите Claude Code и передайте задачу:

claude -p "Используй агента data-analyst. Проанализируй файл Данные/звонки_май_2026.csv" > Отчёты/звонки_май_2026_отчёт.md

Что происходит внутри: Claude Code читает описание агента data-analyst, понимает, что это правильный инструмент для задачи, передаёт ему путь к файлу. Агент вызывает Read для чтения CSV, анализирует содержимое согласно своему промту, формирует отчёт по шаблону. Основная сессия печатает результат в stdout, а перенаправление > сохраняет его в файл.

Можно также явно делегировать через диалог внутри сессии:

Use the data-analyst subagent to analyze Данные/лиды_июнь.csv

Шаг 5. Пример вывода

Вот как выглядит типичный результат работы агента на файле с данными коллцентра:

## Отчёт по звонкам: май 2026

**Ситуация**
Выгрузка звонков коллцентра за май 2026: 1 847 записей, период 1–31 мая.
Ключевое число: конверсия звонок → квалифицированный лид составила 18,3% —
снижение на 4,1 п.п. относительно апреля.

**Ключевые показатели**

| Метрика             | Май 2026  | Апрель 2026 | Динамика |
|---------------------|-----------|-------------|----------|
| Всего звонков       | 1 847     | 1 623       | ▲ +13,8% |
| Квал. лиды          | 338       | 361         | ▼ −6,4%  |
| Конверсия           | 18,3%     | 22,4%       | ▼ −4,1 п.п. |
| Средняя длительность| 4 мин 12 с| 3 мин 58 с  | ▲ +5,9%  |
| Звонков до 30 сек   | 412       | 298         | ▲ +38,3% |

**На что обратить внимание**

Рост коротких звонков (до 30 секунд) на 38,3% — с 298 до 412. При среднем росте трафика на 13,8% это непропорциональный всплеск. Вероятно, изменилось качество трафика или скрипт первых секунд разговора перестал удерживать.

Конверсия падает при росте объёма: больше звонков, меньше лидов в процентах. Это сигнал не про операторов, а про источники трафика — либо пришла менее целевая аудитория.

**Рекомендации**

Проверить источники трафика за май — какие каналы дали прирост 224 звонков и почему они хуже конвертируются. Запросить у коллцентра сравнение скриптов апрель/май — возможно, было изменение в первых секундах разговора.

Отчёт без ваших слов — это не магия, это промт

Структура, которую вы видите выше, полностью определяется промтом агента. Если вам нужен другой формат — измените раздел «Формат отчёта» в файле агента. Агент — это текстовый файл, который вы контролируете.

Шаг 6. Проверьте, что Glob тоже работает

Glob полезен, когда нужно найти файлы перед чтением. Попробуйте задачу, которая требует сначала найти все CSV за период:

claude -p "Используй агента data-analyst. Найди все CSV-файлы в папке Данные/ за май 2026 и подготовь сводный отчёт по каждому."

Агент вызовет Glob с паттерном Данные/*май_2026*.csv, получит список файлов, затем прочитает каждый через Read и напишет отчёт по каждому или сводный — в зависимости от того, как вы сформулировали задачу.

Частые ошибки

Ошибка 1. Промт без конкретного формата вывода

Если в промте агента написать только «анализируй данные и пиши отчёты» — каждый запуск будет давать разный результат. Иногда список, иногда сплошной текст, иногда таблица. Формат вывода нужно прописать явно: какие разделы, в каком порядке, сколько пунктов. Это не ограничение, это стандарт, который делает отчёты сравнимыми между собой.

Ошибка 2. Агент с инструментом Write

Если добавить Write в список инструментов агента, он начнёт самостоятельно создавать файлы — туда, куда сочтёт нужным. Это неудобно и непредсказуемо. Пусть агент возвращает отчёт как текст, а сохранение файла оркестратор или вы берёте под контроль явной командой. Разделение ответственности: агент анализирует, вы решаете куда.

Ошибка 3. CSV с нестандартным разделителем или кодировкой

Claude Code читает файлы как текст. Если CSV использует точку с запятой вместо запятой (распространённый формат выгрузок на русских локалях Excel), агент это поймёт сам — модель достаточно умна для этого. Но если файл сохранён в Windows-1251 вместо UTF-8 — будет нечитаемая каша. Перед передачей агенту убедитесь, что файл в UTF-8. Самый простой способ: открыть в текстовом редакторе (TextEdit на Mac) и пересохранить как UTF-8.

Ошибка 4. Слишком детальный промт, который противоречит сам себе

Попытка предусмотреть все случаи в одном промте ведёт к противоречиям. «Пиши кратко» и «включай все детали» — не уживаются. «Максимум 300 слов» и «анализируй каждую колонку подробно» — тоже. Выберите приоритет. Управленческий отчёт — это краткость и выводы. Детальный анализ — отдельный агент с другим промтом.

Агент не заменяет ваше суждение

Агент находит то, что есть в данных. Контекст — почему цифры именно такие — он не знает. «Конверсия упала на 4%» — это факт. Почему упала: сезонность, изменение канала, проблема в скрипте, случайность — это ваш вопрос, не его ответ. Используйте отчёт как отправную точку, а не финальный вердикт.

Когда нужно / когда нет

Агент-аналитик нужен, когда у вас есть повторяющийся поток однотипных файлов и каждый раз нужен отчёт в одном формате. Еженедельная выгрузка по звонкам, ежемесячный отчёт по рекламным расходам, квартальная сводка по источникам лидов. Один раз настроил — дальше только передаёшь файл.

Также стоит создать агента, когда вы замечаете, что объясняете Claude одно и то же в разных диалогах: «пиши executive summary в начале», «сравнивай с прошлым периодом», «выделяй аномалии». Это знак, что правила пора зафиксировать в агенте, а не держать в голове.

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

Также не стоит создавать одного «универсального аналитика» для всего подряд: звонки, финансы, Росреестр, рекламные бюджеты. Промт такого агента станет слишком общим и качество упадёт. Лучше три узкоспециализированных агента с точными промтами, чем один многорукий с размытым.

Один файл — один агент

Хорошая эвристика: если вы не можете написать промт агента в 10-15 строк, значит задача слишком размытая. Сузьте область ответственности до конкретного типа данных и конкретного формата отчёта — и промт напишется сам.

Связь с другими уроками

День 22 — первый субагент: здесь вы создали базовую структуру .claude/agents/имя.md и поняли, как Claude Code находит агентов. День 25 — прямое применение той же механики к конкретной задаче.

День 24 — ограничение инструментов: принцип «минимальный набор инструментов» из того урока — это основа агента-аналитика. Read и Glob — именно тот минимум, который нужен для чтения данных без побочных эффектов.

День 28 — оркестратор: когда у вас будет несколько агентов — аналитик, редактор, аналитик по другому типу данных — оркестратор начнёт координировать их работу. Агент-аналитик из этого урока станет одним из узлов в системе: оркестратор передаёт ему файл, получает отчёт, передаёт редактору на финальную полировку.

Задание на сегодня

Возьмите любой CSV-файл, который у вас есть прямо сейчас — выгрузка из CRM, отчёт из рекламного кабинета, таблица с данными от подрядчика. Создайте агент data-analyst по шаблону из этого урока и запустите на этом файле одной командой.

Критерий «выполнено»: файл .claude/agents/data-analyst.md существует, агент прочитал ваш CSV и вернул текстовый отчёт с четырьмя разделами — «Ситуация», «Ключевые показатели», «На что обратить внимание», «Рекомендации».

Резюме

Следующий урок откроется после отметки.