orchestrator

name	orchestrator
description	Оркестратор субагентов для анализа данных и кода. Паттерн "менеджер + работники" — агент-аналитик данных + агент-аналитик кода работают параллельно, менеджер собирает результаты и формирует ТЗ. Используй когда нужно проанализировать файл данных (CSV, XML, JSON, Excel) и одновременно найти точки входа в коде, а затем получить готовое техническое задание на доработку.
allowed-tools	Agent, Read, AskUserQuestion
argument-hint	[путь_к_файлу_данных] [модуль_или_обработка]

Оркестратор: анализ данных + анализ кода -> ТЗ

Скилл для параллельного анализа файлов данных и исходного кода с автоматическим формированием технического задания.

Когда использовать

• Нужно загрузить/обработать файл данных (CSV, XML, JSON, Excel, DBF) в программе
• Нужно понять структуру входных данных И найти где в коде их обрабатывать
• Нужно сформировать ТЗ на доработку обработки/загрузки/выгрузки
• Задача затрагивает и данные и код одновременно

Когда НЕ использовать

• Задача только про код без внешних данных — используй обычный анализ
• Задача только про данные без изменений в коде — просто проанализируй файл
• Простая правка в одном месте — субагенты избыточны

---

Архитектура

МЕНЕДЖЕР (ты)
  |
  |-- параллельно -->  СУБАГЕНТ 1: Аналитик данных
  |                    СУБАГЕНТ 2: Аналитик кода
  |
  |<-- результаты --
  |
  +--> СИНТЕЗ --> ТЗ --> пользователь

---

Протокол работы

Шаг 0: Получить задачу

Извлеки из описания пользователя (или из $ARGUMENTS):

Параметр	Что выяснить	Пример
Файл данных	Путь к файлу с данными	/data/prices.csv
Код/модуль	Где искать точки входа	Обработка ЗагрузкаЦен, модуль РаботаСФайлами
Цель	Что нужно получить в итоге	Загрузить цены в справочник Номенклатура
Ограничения	Особые требования	Не трогать существующие цены, только добавлять новые

Если чего-то не хватает — спросить пользователя через AskUserQuestion до запуска субагентов.

Шаг 1: Запустить субагентов параллельно

Запустить оба субагента одновременно через инструмент Agent (два вызова Agent в одном сообщении).

Субагент 1: Аналитик данных

Используй subagent_type: "general-purpose". Задание:

Проанализируй файл данных: {путь_к_файлу}

Контекст задачи: {цель пользователя}

Выполни анализ и верни результат строго в следующем формате:

## Структура файла
- Формат: (CSV/XML/JSON/Excel/DBF)
- Кодировка: (UTF-8/Windows-1251/CP866/...)
- Разделитель: (для CSV — запятая, точка с запятой, табуляция)
- Количество записей: N
- Размер файла: N КБ/МБ

## Колонки/поля
| # | Имя поля | Тип данных | Пример значения | Пустых значений | Примечание |
|---|----------|-----------|-----------------|-----------------|------------|
| 1 | ...      | ...       | ...             | N из M          | ...        |

## Особенности данных
- Уникальные ключи: какие поля могут служить идентификатором
- Связи: какие поля ссылаются на внешние справочники
- Аномалии: дубликаты, пустые обязательные поля, некорректные форматы
- Диапазоны: мин/макс значений числовых и дат

## Готовность к загрузке
- Что нужно преобразовать (формат дат, разделители, кодировка)
- Какие поля нужно маппить на справочники
- Потенциальные проблемы при загрузке

Субагент 2: Аналитик кода

Используй subagent_type: "Explore". Задание:

Проанализируй код для задачи: {цель пользователя}

Где искать: {модуль/обработка/файл}

Выполни анализ и верни результат строго в следующем формате:

## Точки входа
Для каждой точки входа:
- Файл и строка: путь:номер_строки
- Сигнатура: первая строка функции/процедуры
- Назначение: одна фраза что делает

## Цепочки вызовов
От каждой точки входа — вглубь:
- функция1 -> функция2 -> функция3
- с указанием файлов и строк

## Модели данных
- Какие структуры/объекты/таблицы задействованы
- Поля и типы
- Связи между объектами

## Текущая логика обработки
- Как сейчас работает загрузка/обработка (если есть)
- Какие проверки выполняются
- Как обрабатываются ошибки

## Точки расширения
- Где именно нужно вносить изменения
- Какие функции затрагиваются
- Какие зависимости нужно учесть

Шаг 2: Собрать результаты

Дождаться завершения обоих субагентов. Прочитать оба отчёта.

Шаг 3: Синтезировать ТЗ

На основе обоих отчётов сформировать техническое задание:

# Техническое задание: {название задачи}

## Исходные данные

### Файл данных
{Краткая выжимка из отчёта Субагента 1}
- формат, объём, ключевые поля
- особенности и аномалии

### Текущий код
{Краткая выжимка из отчёта Субагента 2}
- точки входа
- текущая логика

## Маппинг: данные -> код

| Поле в файле | Куда загружается | Преобразование | Примечание |
|-------------|------------------|----------------|------------|
| ...         | ...              | ...            | ...        |

## Что нужно сделать

### Изменения в коде
Для каждого изменения:
1. **Где**: файл:строка, функция
2. **Что**: описание изменения
3. **Почему**: зачем это нужно
4. **Зависимости**: от чего зависит это изменение

### Новый код (если нужен)
- Какие новые функции/модули создать
- Что они должны делать

### Порядок реализации
1. Фаза 1: ...
2. Фаза 2: ...

## Проверка
- Как убедиться что всё работает
- Тестовые сценарии
- Граничные случаи

## Риски и ограничения
- Что может пойти не так
- На что обратить внимание

Шаг 4: Показать пользователю

Показать готовое ТЗ и спросить:

• Всё ли учтено?
• Нужно ли что-то добавить/убрать?
• Можно ли приступать к реализации?

Не начинать реализацию без одобрения пользователя.

---

Правила менеджера

1. Не делать работу субагентов — менеджер только координирует и синтезирует
2. Параллельность — всё что можно запустить одновременно, запускать одновременно
3. Только факты — в ТЗ только то что нашли субагенты, никаких домыслов
4. Спрашивать — если данных недостаточно, спросить пользователя
5. Минимальное ТЗ — описывать только необходимые изменения, без "заодно улучшим"
6. Полные отчёты субагентов — сохранять оригинальные отчёты, не терять детали при синтезе