orchestrator-skill

name	orchestrator-skill
description	Оркестратор субагентов для анализа данных и кода. Паттерн "менеджер + работники": агент-аналитик данных + агент-аналитик кода работают параллельно, менеджер собирает результаты и формирует ТЗ. Используй когда нужно проанализировать файл данных (CSV, XML, JSON, Excel) и одновременно найти точки входа в коде, а затем получить готовое техническое задание на доработку.

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

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

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

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

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

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

---

Архитектура

┌──────────────────────────────────────────────────┐
│              МЕНЕДЖЕР (основной агент)            │
│                                                  │
│  1. Принимает задачу от пользователя             │
│  2. Формулирует задания для субагентов            │
│  3. Запускает субагентов ПАРАЛЛЕЛЬНО              │
│  4. Собирает результаты                          │
│  5. Формирует итоговое ТЗ                        │
│                                                  │
│  ┌────────────────┐    ┌────────────────┐        │
│  │  СУБАГЕНТ 1    │    │  СУБАГЕНТ 2    │        │
│  │  Аналитик      │    │  Аналитик      │        │
│  │  данных        │    │  кода          │        │
│  │                │    │                │        │
│  │  - структура   │    │  - точки входа │        │
│  │  - типы полей  │    │  - цепочки     │        │
│  │  - аномалии    │    │    вызовов     │        │
│  │  - объём       │    │  - модели      │        │
│  │  - кодировка   │    │    данных      │        │
│  └───────┬────────┘    └───────┬────────┘        │
│          │                     │                  │
│          └─────────┬───────────┘                  │
│                    ▼                              │
│           СИНТЕЗ И ФОРМИРОВАНИЕ ТЗ               │
└──────────────────────────────────────────────────┘

---

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

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

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

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

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

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

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

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

Задание для субагента:

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

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

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

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

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

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

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

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

Задание для субагента:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

### Порядок реализации
1. Фаза 1: ... (от основания к верхушке)
2. Фаза 2: ...
3. ...

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

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

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

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

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

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

---

Расширение: дополнительные субагенты

При необходимости менеджер может запустить дополнительных субагентов:

Субагент	Когда нужен	Что делает
Аналитик БД	Данные грузятся в базу	Анализирует схему таблиц, индексы, ограничения
Аналитик зависимостей	Много связанных модулей	Строит граф зависимостей, находит побочные эффекты
Валидатор	Критичные данные	Проверяет данные на соответствие бизнес-правилам
Тестировщик	После реализации	Генерирует тестовые данные и проверяет результат

Дополнительные субагенты запускаются параллельно с основными если это возможно.

---

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

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

---

Пример использования

Пользователь: "Вот CSV с ценами поставщиков /data/prices.csv. Нужно загрузить их в 1С в справочник Номенклатура, обновив закупочные цены."

Менеджер:

1. Извлекает: файл = /data/prices.csv, код = обработка загрузки цен в 1С, цель = обновить закупочные цены в Номенклатуре
2. Запускает параллельно:
   • Субагент 1 → анализирует CSV (колонки, типы, кодировка, аномалии)
   • Субагент 2 → через MCP ищет обработку загрузки цен, точки входа, текущую логику маппинга
3. Получает оба отчёта
4. Формирует ТЗ: маппинг полей CSV → реквизиты Номенклатуры, какие функции менять, порядок реализации
5. Показывает пользователю для одобрения