vkr-docx: оформление ВКР по ГОСТ 7.32-2017

vkr-docx

Python-пакет с CLI и слэш-командой /vkr для Claude Code, который оформляет главы ВКР в docx по ГОСТ 7.32-2017 с автоматическими ссылками и содержанием

  • 0 ★ репозитория
  • Последний коммит
CLI

Расширенный доступ

Почему такой уровень

  • Установочный скрипт по умолчанию пишет в общие ~/.claude/commands и ~/CLAUDE.md, а не только в текущий проект
  • Работает только с локальными docx-файлами пользователя, наружу ничего не отправляет
Все причины и проверки
Российский стек

twint1m/vkr-docx

Установка

Работает в
Сервисы

Ручная установка

curl -fsSL https://raw.githubusercontent.com/twint1m/vkr-docx/main/install.sh | bash

Единственный рекомендованный способ установки из README: клонирует репозиторий в ~/projects/vkr-docx, ставит пакет и копирует команду /vkr.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Установочный скрипт по умолчанию пишет в общие ~/.claude/commands и ~/CLAUDE.md, а не только в текущий проект
  • Работает только с локальными docx-файлами пользователя, наружу ничего не отправляет

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Пользователь пишет главу в 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.

Частые вопросы

Как оформление настраивается под другой вуз?

Через config.yaml в рабочей папке: поля страницы, шрифт и размер можно переопределить, по умолчанию заданы значения ГОСТ 7.32-2017.

Что делает install.sh, кроме установки пакета?

Копирует команду /vkr в ~/.claude/commands и дописывает инструкции в ~/CLAUDE.md, поэтому команда становится доступна во всех проектах Claude Code, а не только в одном.

Обсуждение

Вопросов и отзывов пока нет.

Российский стек

Скилл Claude Code, который собирает выпускную квалификационную работу из markdown в docx по стандарту СТО СГАУ и ГОСТ 7.1

СкиллМинимальный доступ1Звезды репозитория
Российский стек

Скилл для агентов, который собирает или проверяет документ по ГОСТ и выдает список замечаний со ссылкой на конкретный пункт стандарта

СкиллМинимальный доступ2Звезды репозитория
Российский стек

Скилл оформления студенческих работ по ГОСТ 7.32: агент пишет текст в Markdown, скрипт собирает .docx с титульным листом вуза

СкиллРасширенный доступ7Звезды репозитория
Российский стек

Скилл для Codex и Claude: оформляет лабораторные, курсовые и пояснительные записки по методичке или ГОСТ, не выдумывая данные за автора

СкиллМинимальный доступ2Звезды репозитория
Российский стек

Скилл для агента Hermes, который ведет научную работу от источника до кликабельной ГОСТ-ссылки в DOCX и не дает выдумать цитату

СкиллМинимальный доступ

Коротко о README

README описывает скилл для Claude Code, который оформляет ВКР в docx по ГОСТ 7.32-2017: стили, заголовки, рисунки с автомасштабированием, таблицы, двусторонние перекрестные ссылки, содержание с leader dots и версионирование файлов вида ВКР 0.A.B. Показан формат markdown для главы, правила именования картинок, пример config.yaml для смены полей и шрифта и таблица версионирования. Установка только через install.sh, ручное клонирование не рекомендуется. Лицензия MIT.

Бейдж для README

Сообщить о проблеме