> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velesagent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Подготовка содержательных отчётов

> Как Велес строит связный читательский документ независимо от итогового формата и подключает дополнительные навыки только по необходимости.

# Подготовка содержательных отчётов

Навык `report-authoring` отвечает за содержание отчётов, книг, предложений, служебных записок, инструкций, регламентов и других читательских документов. Он не выбирает за пользователя DOCX, PDF, HTML или Markdown и не заменяет навыки сборки этих форматов.

Главная задача навыка — не допустить, чтобы итог превратился в краткое резюме, исследовательский журнал, набор списков или таблицу без объяснения.

## Место в процессе

Работа разделена на четыре слоя:

1. Исследование и предметный анализ собирают доказательства.
2. `report-authoring` строит читательскую логику, полные разделы и единую рукопись.
3. Навык утверждённого формата создаёт DOCX, PDF, HTML или другой файл.
4. Содержательная и форматная проверки подтверждают готовность результата.

Для любого читательского документа навык подготовки отчёта обязателен. Навыки формата и предметного анализа подключаются отдельно и только тогда, когда они действительно нужны.

## Динамический выбор дополнительных навыков

| Потребность | Когда подключается дополнительный навык |
| - | - |
| Новые или меняющиеся внешние сведения | Когда важные утверждения нужно найти или проверить по источникам. |
| Деловой анализ | Когда рекомендация зависит от рынка, продукта, клиентов, финансов или операционных предпосылок. |
| Проверка данных и расчётов | Когда выводы зависят от наборов данных, показателей, знаменателей, сверок или вычислений. |
| Диаграммы и графики | Когда связь, изменение, распределение, состав или сценарии заметно понятнее в наглядной форме. |
| Сборка формата | Только для форматов, утверждённых пользователем и планом. |

Наличие навыка в каталоге само по себе не является причиной загружать его в контекст. Исполнитель выбирает минимальный набор, который покрывает задачу этапа. Упоминание формата как предмета работы, например «парсер PDF», не означает запрос на итоговый PDF.

## Как строится документ

Сначала фиксируются читатель, его вопрос или решение, вид документа, охват, глубина, язык, правила источников и критерии готовности. Затем создаётся краткий смысловой каркас:

* вопрос или задача;
* основной ответ;
* путь доказательств;
* объяснение значения найденного;
* ограничения, способные изменить вывод;
* рекомендация, решение или следующий шаг.

Каждый крупный раздел получает отдельную задачу и границу. Для длинного документа разделы создаются в свежих контекстах, после чего редактор полностью читает все файлы, согласует термины, числа, переходы, повторы и противоречия. Краткие передачи между исполнителями используются как указатели, а не как замена полному тексту.

## Проверка глубины

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

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

## Связь с DOCX

Если среди утверждённых форматов есть DOCX, после подготовки рукописи подключается отдельный навык [Создание документов DOCX](/skills/documents_ru). Он отвечает за стили, оглавление, таблицы, доступность и машинную проверку структуры редактируемого файла. Если пользователь запросил другой формат, DOCX не создаётся вместо него.