DOCX по ГОСТ: агент пишет семантический JSON, а детерминированный компилятор собирает документ из проверенного шаблона
Вопрос (сокращенно):
«Для документов по ГОСТ 7.32 или ЕСПД я использую Typst + расширение и Claude. Могу ли я сделать то же самое с DOCX, чтобы агент сразу писал по ГОСТ? Найди лучшее решение».
Разбор опирается на 11 инструментов и проектов (возможности, ограничения, лицензии) и 15 выдержек из требований и статусов стандартов серии ГОСТ 19 (ЕСПД) — это иллюстративная выборка, а не полный перечень ЕСПД. Всего 26 строк данных с 18 независимых хостов; ни один URL не дает более одной строки.
Главная схема: конвейер «Claude → JSON → профиль → шаблон → DOCX → PDF → проверки»
агент (недетерминированно)
детерминированный компилятор
проверки и рендер
Ошибка валидации схемы или автопроверки структуры возвращается агенту как машиночитаемый отчет — агент правит только JSON, никогда не DOCX напрямую. MCP-редактирование Word допустимо как вспомогательный интерфейс, но не как ядро: много низкоуровневых операций повышают недетерминизм.
Сравнительная матрица: кто какую роль играет в стеке
Ключевые выводы
«По ЕСПД» — не один стиль: ГОСТ 19.101-2024 введен 30 января 2025 г. взамен ГОСТ 19.101-77, поэтому набор применимых редакций фиксируется в профиле проекта, а не зашивается универсально —
docs.cntd.ru,
meganorm.ruГОСТ 19.106-78 задает правила печатных программных документов, но прямо не распространяется на документ «Текст программы» — обязательная проверка области действия в профиле —
russiangost.comГОСТ 19.104-78 требует лист утверждения на каждый программный документ на А4 и задает состав основных надписей вплоть до подписи нормоконтролера — это аргумент за шаблоны, а не за свободное форматирование агентом —
docs.cntd.ru,
allgosts.ruГотовые решения — лишь паттерны: gostdoc — постформатирование под ГОСТ 7.32-2017, а не архитектура генерации; taraved/gost-report-skill опирается на устаревший для нового проекта ГОСТ 7.32-2001 и помечен beta; Technical_writer_automation (2021) подтверждает схему «шаблон + python-docx» для одного документа ЕСПД —
github.com,
skillfoxx.ru,
habr.com
Минимальный контракт JSON (сущности)
doc_typeвид документа и код по профилю
standard_profileГОСТ 7.32-2017 или набор ГОСТ 19 с редакциями
requisitesреквизиты, основные надписи, обозначение
approval_sheetлист утверждения, подписи, нормоконтролер
title_pageтитульный лист
sectionsдерево разделов с уровнями
paragraphsабзацы с семантическими ролями
tables / figuresподписи и сквозная нумерация
Структура репозитория
- schemas/ — JSON Schema контракта, версии
- profiles/ — ГОСТ 7.32-2017; по профилю на вид документа ЕСПД
- templates/ — проверенные .docx/.dotx со стилями и секциями
- render/ — docxtpl, python-docx, обновление полей, PDF
- validators/ — проверки структуры готового DOCX
- tests/golden/ — эталонные DOCX/PDF, сравнение в CI
Пошаговый план MVP
- Шаблон ГОСТ 7.32-2017: стили, секции, колонтитулы, поля, оглавление.
- JSON Schema контракта и валидатор; агент выдает только JSON.
- Сборка docxtpl, точечные правки python-docx/OOXML для недостающих полей.
- Обновление полей и PDF-превью (Word, Aspose либо LibreOffice headless).
- Автопроверки структуры + golden-тесты; затем первый профиль ЕСПД.
- Опционально: Pandoc + reference.docx как быстрый MVP для простых отчетов 7.32 — не единственный движок для сложной ЕСПД-разметки, рамок и секций.
Acceptance-критерии
- Весь текст — именованными стилями Word; ручного форматирования агентом нет
- Секции, колонтитулы и номера страниц соответствуют профилю
- Оглавление и поля документа обновляются автоматически
- Подписи рисунков и таблиц, сквозная нумерация — по правилам профиля
- Лист утверждения и титульный лист собираются из реквизитов
- Golden DOCX/PDF-тесты проходят в CI без ручных правок
Важное разграничение. Конвейер гарантирует «соответствие структуре и правилам профиля». Юридически и организационно подтвержденное «соответствие ГОСТ» — отдельный статус: он требует нормоконтроля и фиксации применимых редакций стандартов в проекте или договоре.
Все 11 инструментов: данные источников
| Решение | Роль в стеке | Стандарт | Ограничение / зрелость | Лицензия | Источник |
|---|
Выдержки ГОСТ 19 / ЕСПД: почему нужен профиль стандартов
15 строк из разных источников — иллюстрация разнородности требований и статусов, не полный перечень ЕСПД.
Метод: 26 строк из 18 независимых хостов (максимум одна строка с URL, доля ≤ 3,8%): 11 строк — инструменты и проекты (возможности, ограничения, лицензии), 15 строк — требования и статусы ГОСТ 19/ЕСПД. Сведения взяты из документации и каталогов по состоянию на даты публикаций источников; длинные формулировки возможностей сокращены для верстки, роли в стеке — рекомендация отчета, а не атрибут источника.