grill-zvit-and-shodennik

name: grill-zvit-and-shodennik description: Rigorously audit a generated pre-diploma practice report (звіт з практики) and practice diary (щоденник практики) against the Odesa Polytechnic rules in docs/diploma-rules/references/ZVIT-RULES.md and SHODENNYK-RULES.md (text formatting per docs/diploma-rules/RULES.md), and cross-check their content for consistency with the thesis. Use when the user asks to check, verify, validate, "grill", or review a practice report / diary (звіт / щоденник практики) for compliance.

Grill Звіт + Щоденник — аудит звіту і щоденника практики проти правил

Перевіряє звіт з практики (zvit.pdf) проти ZVIT-RULES.md (+ текстові константи RULES.md) і щоденник практики (shodennyk.pdf) проти SHODENNYK-RULES.md, а також звіряє їхній зміст між собою і з роботою thesis/. Мета — не «переглянути», а прискіпливо знайти кожне порушення й дати конкретний фікс із посиланням на пункт правил.

Вхід

Аргументи:

тека практики — типово thesis/practice/ (містить zvit.pdf, shodennyk.pdf, zvit-*.md, shodennyk-data.md);
тека роботи для звірки — типово thesis/ (необов'язково).

Якщо файлів немає за замовчуванням — запитати у користувача, не вгадувати.

Процедура

1. Завантажити еталони

Прочитати docs/diploma-rules/references/ZVIT-RULES.md і SHODENNYK-RULES.md повністю.
Прочитати docs/diploma-rules/RULES.md як базу текстових констант звіту; за потреби — docs/diploma-rules/pravyla-raw.txt.

2. Витягнути документи

Відкрити zvit.pdf / shodennyk.pdf (через pdfminer/pdf-mcp) і додатково читати zvit-*.md та shodennyk-data.md напряму — точніше для перевірки структури й патернів.
Зафіксувати, що піддається машинній перевірці (структура, порядок елементів, заголовки, наявність таблиць/рисунків/сценаріїв, наявність блоків форми, дослівна звірка, крос-консистентність) і що ні (поля в мм, кеглі, візуальна якість розкладки) — останнє в «Потребує ручної перевірки».

3. Чек-лист звіту (кожна категорія = окремий прохід) → `GRILL-ZVIT-REPORT.md`

A. Текстове оформлення (делеговано до RULES.md §1–§12): загальні параметри (TNR 14, інтервал 1,5, поля, абзац 1,25 см), структура, титул, заголовки, зміст, нумерація сторінок, рисунки, таблиці, сценарії/лістинги, переліки, формули, посилання, список джерел.

B. Звіт-специфічне (ZVIT-RULES.md):

Структура — порядок 8 елементів (§1); кожен з нової сторінки; структурні заголовки ВЕЛИКИМИ по центру.
ВСТУП — актуальність / мета і завдання / об'єкт / предмет (§3).
ХАРАКТЕРИСТИКА ПІДПРИЄМСТВА — присутня; назва == титул == щоденник (§4).
Розділ 1 — підрозділи 1.1–1.5; таблиця аналогів зі стовпцем «Власна розробка», ≥3 аналоги; діаграма use-case + ≥1 сценарій у форматі §6 (§5).
Розділ 2 — архітектура, БД (ER + опис), специфікації класів/структура даних (§7).
Посилання — на кожен рисунок/таблицю/сценарій є посилання в тексті до появи.
Список джерел — у порядку першої згадки, ДСТУ 8302:2015 (§9).

4. Чек-лист щоденника (повнота форми + крос) → `GRILL-SHODENNYK-REPORT.md`

За SHODENNYK-RULES.md §5–§6:

Повнота форми — усі 8 блоків і порядок (§1); титульний блок повний; прибуття/вибуття + клітинки М.П.; індивідуальне завдання; Календарний графік — 7 стовпців/тижні 1–4/≥1 рядок (§2); робочі записи — датовані діапазони, покривають період без розривів (§3); відгук підприємства + підпис/М.П.; відгук керівника від університету + висновок; блок оцінки (національна + ECTS) — бланки.
Крос-консистентність (§6) — ПІБ/група/спеціальність/ОПП == zvit-00-tytul == thesis/00; підприємство == zvit-03-harakterystyka; період == zvit-00-tytul і всі робочі записи ⊆ період; роботи Календарного графіку ↔ розділи звіту. Без теки роботи — позначити «потребує ручної перевірки».

5. Звіти

Вивести два файли — thesis/practice/GRILL-ZVIT-REPORT.md і thesis/practice/GRILL-SHODENNYK-REPORT.md (і коротке зведене резюме обох вердиктів у чат) у форматі:

# Grill <Звіт|Щоденник> Report — <файл> — <дата ISO>

## Підсумок
Перевірено категорій: N. Порушень: X (BLOCKER: a, MAJOR: b, MINOR: c).
Вердикт: PASS | PASS WITH FIXES | FAIL

## Порушення
### [BLOCKER] <короткий заголовок>
- Правило: <ZVIT-RULES.md|SHODENNYK-RULES.md|RULES.md> §<розділ>
- Знайдено: <файл:рядок / стор. PDF / цитата>
- Очікувано: <вимога правила>
- Фікс: <конкретна дія>

### [MAJOR] ...
### [MINOR] ...

## Потребує ручної перевірки
- <поля в мм, кеглі, візуальна якість — формат не дає перевірити>

## Чисті категорії
- §<n> <назва> — без зауважень

Класифікація:

BLOCKER — відсутній обов'язковий структурний елемент звіту або блок щоденника; порушено порядок; відсутня таблиця аналогів; відсутній use-case рисунок/сценарії; крос-розбіжність ПІБ/підприємства/періоду між щоденником і звітом/thesis; робочі записи з розривами або поза періодом.
MAJOR — порушені текстові константи RULES.md; неправильні заголовки/нумерація/ підписи; Календарний графік без потрібних стовпців/тижнів; немає стовпця «Власна розробка».
MINOR — формулювання заголовків, регістр, дрібні стилістичні відхилення.

Принципи

Прискіпливість понад увічливість. Мовчання = пропущена помилка. Кожна категорія має або порушення, або явний запис «без зауважень».
Завжди цитувати конкретний пункт правил і конкретну локацію (файл:рядок або стор. PDF).
Не вигадувати вимог, яких немає в правилах.
Те, що формат не дає перевірити, — не «PASS», а в розділ «Потребує ручної перевірки».
Не редагувати документи автоматично без запиту; за згодою користувача — застосувати фікси (через /generate-zvit-and-shodennik) і перезапустити аудит.

Local Codex adaptation for this project

The upstream skill was written for a repository that stores generated work under thesis/. In this project, use these local paths instead:

Diploma artifact folder: docs/generated-diploma/.
Latest generated DOCX/PDF files: docs/generated-diploma/dyplomna-robota-team-task-manager-fixed_v4.docx and docs/generated-diploma/dyplomna-robota-team-task-manager-fixed_v4.pdf, unless the user points to another file.
Extracted/restored figures and screenshots: docs/generated-diploma/assets/; fallback working copies may also exist in work/restored-figures/.
Diploma builder: tools/build_diploma_docx.py.
Diploma rules and references stay at docs/diploma-rules/.

When this skill says thesis/, resolve it to docs/generated-diploma/ for this repository. When it asks for markdown chapter sources that are not present locally, derive content from the current generated DOCX/PDF and ask the user before inventing missing facts. Put new presentation or practice outputs under docs/generated-diploma/, for example docs/generated-diploma/presentation.pptx and docs/generated-diploma/practice/.