vkr-docx: оформление ВКР по ГОСТ 7.32-2017
vkr-docx
Python-пакет с CLI и слэш-командой /vkr для Claude Code, который оформляет главы ВКР в docx по ГОСТ 7.32-2017 с автоматическими ссылками и содержанием
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Установочный скрипт по умолчанию пишет в общие ~/.claude/commands и ~/CLAUDE.md, а не только в текущий проект
- Работает только с локальными docx-файлами пользователя, наружу ничего не отправляет
Установка
Ручная установка
curl -fsSL https://raw.githubusercontent.com/twint1m/vkr-docx/main/install.sh | bashЕдинственный рекомендованный способ установки из README: клонирует репозиторий в ~/projects/vkr-docx, ставит пакет и копирует команду /vkr.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Пользователь пишет главу в markdown и складывает рисунки с именами вида fig-1.png в одну папку, агент вызывает Python-класс VKRDocument, чтобы добавить заголовки трех уровней, основной текст, рисунки с автомасштабированием и подписями, таблицы с границами и подписями. Отдельно можно обновить двусторонние перекрестные ссылки между текстом и подписями и содержание с leader dots. Стили по умолчанию соответствуют ГОСТ 7.32-2017: Times New Roman 14pt, межстрочный 1.5, поля 3/1.5/2/2 см, но их можно переопределить в config.yaml. У пакета есть CLI vkr-docx с командами fix-styles, crossrefs, toc и full-fix, а после сохранения файл переименовывается с версией вида ВКР 0.A.B.docx, где A это глава, B это номер правки, до финальной ВКР 1.0.0.
Для кого. Для студентов, которые пишут ВКР главами в markdown вместе с Claude Code и хотят, чтобы оформление, ссылки и содержание обновлялись автоматически.
Подходит, если
- Пишете ВКР по главам в markdown и хотите получать готовый по ГОСТ 7.32-2017 docx
- Нужны автоматические подписи и двусторонние ссылки для рисунков и таблиц
- Нужен CLI для точечного исправления стилей, ссылок или содержания в уже собранном docx
Не подходит, если
- Вуз требует не ГОСТ 7.32-2017, а другой локальный стандарт оформления
- Не хотите, чтобы установочный скрипт менял глобальный ~/CLAUDE.md и папку ~/.claude/commands: install.sh делает это по умолчанию
- Нужна проверка научного содержания, а не только оформления
Пример запроса к агенту
Вот текст главы chapter3.md и картинки в папке images, добавь в ВКР и обнови содержаниеОграничения
Лицензия не зарегистрирована на GitHub как файл, хотя README называет ее MIT. Проект версии 0.1.0 от одного автора, без тестов в дереве репозитория и без раздела об ограничениях функциональности. Установочный скрипт install.sh по умолчанию ставит пакет глобально (pip install -e), копирует команду /vkr в общую папку ~/.claude/commands и дописывает инструкции в общий файл ~/CLAUDE.md, а не только в текущий проект. README прямо предупреждает не клонировать репозиторий вручную, а пользоваться install.sh.
Как отключить. Удалите файл ~/.claude/commands/vkr.md, уберите добавленный блок про vkr_docx из ~/CLAUDE.md и выполните pip uninstall vkr-docx.
Проверка безопасности
- Установочный скрипт по умолчанию пишет в общие ~/.claude/commands и ~/CLAUDE.md, а не только в текущий проект
- Работает только с локальными docx-файлами пользователя, наружу ничего не отправляет
Коротко о README
README описывает скилл для Claude Code, который оформляет ВКР в docx по ГОСТ 7.32-2017: стили, заголовки, рисунки с автомасштабированием, таблицы, двусторонние перекрестные ссылки, содержание с leader dots и версионирование файлов вида ВКР 0.A.B. Показан формат markdown для главы, правила именования картинок, пример config.yaml для смены полей и шрифта и таблица версионирования. Установка только через install.sh, ручное клонирование не рекомендуется. Лицензия MIT.
Частые вопросы
Как оформление настраивается под другой вуз?
Через config.yaml в рабочей папке: поля страницы, шрифт и размер можно переопределить, по умолчанию заданы значения ГОСТ 7.32-2017.
Что делает install.sh, кроме установки пакета?
Копирует команду /vkr в ~/.claude/commands и дописывает инструкции в ~/CLAUDE.md, поэтому команда становится доступна во всех проектах Claude Code, а не только в одном.
Похожие
Утилита Microsoft и MCP-сервер, которые переводят PDF, Word, Excel, PowerPoint, HTML и другие файлы в Markdown для модели
Скиллы Anthropic
Skills
Официальные примеры скиллов Anthropic: документы docx, pdf, pptx, xlsx, дизайн, MCP builder и спецификация Agent Skills
Скилл, который собирает редактируемые PPTX-презентации из PDF, DOCX, ссылок и Markdown с настоящими фигурами, диаграммами и анимациями
Скилл рисует редакторские диаграммы как самостоятельные файлы HTML и SVG: архитектура, блок-схемы, ER, воронки и еще около сорока типов