> ## 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.

# Создание документов DOCX

> Как Велес создаёт редактируемые документы DOCX и проверяет их структуру, содержание и доступность.

# Создание документов DOCX

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

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

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

## Чем этот навык отличается от простого преобразования

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

Последовательность выглядит так:

1. Фиксируются читатель, задача документа, охват, глубина, язык, правила источников и образец оформления.
2. Для действительно большого или независимо делимого материала главы либо разделы могут поручаться отдельным исполнителям; короткий связный документ не делится искусственно.
3. Редактор полностью читает подготовленные части, устраняет повторы и противоречия, выравнивает термины, числа и переходы.
4. Из исходной рукописи создаётся DOCX со стилями, оглавлением, нумерацией, таблицами, ссылками и колонтитулами.
5. Машинная проверка ищет незаполненные места, чрезмерное количество списков, слишком широкие таблицы, нарушения структуры и признаки проблем доступности.
6. После любого исправления DOCX проверка выполняется заново.

## Проверка без Microsoft Word

Велес не открывает Microsoft Word и не управляет рабочим столом. Проверка выполняется непосредственно по структуре DOCX через `python-docx` и содержимое архива Word.

Для готового DOCX должны существовать:

* итоговый редактируемый файл DOCX;
* отчёт `docx-audit.json` с `kind: veles-docx-audit` и успешным результатом;
* необходимые отчёты проверки фактов, ссылок и расчётов, если они требуются проекту.

Отчёт `docx-audit.json` содержит SHA-256 текущего DOCX. Если файл изменён, заменён или перемещён после проверки, отчёт считается устаревшим и создаётся заново. Самостоятельно составленный JSON не заменяет машинную проверку.

Если файл не открывается или проверка обнаружила блокирующий дефект, проект не сообщает о готовности документа.

## Как Велес борется с документами из одних списков

Для поясняющего отчёта или книги обычный текст считается основной формой. Списки подходят для коротких наборов условий и действий, а таблицы — для строк с одинаковыми полями.

Проверка обращает внимание на:

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

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

## Исходная рукопись и итоговый файл

Markdown остаётся удобным исходным форматом: главы можно хранить отдельно, сравнивать и повторно собирать. Но если утверждён итоговый DOCX, именно DOCX является результатом для пользователя. Последний утверждённый этап создаёт или исправляет его, выполняет проверку и готовит сообщение со ссылкой на фактический файл. Координатор завершает проект по самому файлу и машинному отчёту без дополнительных служебных сборок.

Если пользователь явно запросил Markdown как итоговый формат, проект сохраняет Markdown как самостоятельный результат и не создаёт DOCX вместо него.