diff --git a/ege-checker-roadmap.docx b/ege-checker-roadmap.docx new file mode 100644 index 0000000..b9936db Binary files /dev/null and b/ege-checker-roadmap.docx differ diff --git a/ege-checker/SKILL.md b/ege-checker/SKILL.md new file mode 100644 index 0000000..5b3ad58 --- /dev/null +++ b/ege-checker/SKILL.md @@ -0,0 +1,151 @@ +--- +name: ege-checker +description: > + Проверка заданий ЕГЭ с выставлением баллов по официальным критериям ФИПИ. + Используй этот скилл когда пользователь: + - Загружает фото/скан рукописного сочинения ЕГЭ по русскому языку + - Просит проверить сочинение ЕГЭ, выставить баллы, оценить работу + - Загружает аудиозапись или текст ответов по разделу "Аудирование" ЕГЭ по английскому + - Упоминает "ЕГЭ", "сочинение", "критерии К1-К12", "аудирование английский" + - Просит разобрать ошибки в сочинении по критериям ФИПИ + Скилл умеет: OCR рукописного текста через vision (multimodal), оценку по критериям, подробные комментарии. Работает с любой multimodal LLM (Qwen, GPT-4o и др.). +--- + +# ЕГЭ-Checker + +## Обзор возможностей + +| Модуль | Статус | Вход | Выход | +|--------|--------|------|-------| +| Сочинение (русский) | ✅ MVP | Фото рукописи или текст | Баллы К1–К12 + комментарии | +| Аудирование (английский) | ✅ MVP | Аудиофайл + ключи | Баллы по заданиям | + +--- + +## Модуль 1: Сочинение ЕГЭ по русскому языку + +### Что получает агент от проверяющего +Проверяющий присылает в одном сообщении: +1. **Сканы бланков** — фото рукописного сочинения (один или несколько листов) +2. **Исходный текст задания** — публицистический/художественный текст, по которому написано сочинение +3. **Тему/формулировку задания** — если есть отдельно (иногда тема вытекает из текста) + +Без исходного текста невозможно проверить К1, К2, К3 и К12. Если текст не прислан — попроси его перед началом проверки. + +### Шаг 1 — Получить текст сочинения + +**Если загружено фото/скан:** +1. Внимательно рассмотри все изображения — бланки могут быть на нескольких листах +2. Распознай рукописный текст максимально точно, сохраняя абзацное деление +3. Выведи распознанный текст и попроси подтвердить: *"Вот что распознано. Если есть неточности — поправьте перед проверкой."* +4. Дождись подтверждения или правок + +**Если текст вставлен напрямую:** +Переходи к Шагу 2 без распознавания. + +### Шаг 2 — Загрузить критерии + +Прочитай файл `references/russian-essay-criteria.md` — там полные критерии К1–К12 с баллами и примерами. + +### Шаг 3 — Оценить по каждому критерию + +Пройдись по всем критериям К1–К12 **последовательно**. Для каждого: +- Процитируй конкретный фрагмент из сочинения (если уместно) +- Объясни своё решение +- Выставь балл + +**Важные правила:** +- Если К1 = 0 (нет формулировки проблемы) → К2, К3, К4 автоматически = 0 +- Если работа ≤ 70 слов → все баллы = 0, только К10 может быть ненулевым +- Считай слова перед проверкой (служебные части речи считаются) + +### Шаг 4 — Итоговый вывод + +Используй этот формат вывода: + +``` +## Результаты проверки сочинения ЕГЭ + +### Распознанный текст +[текст если было фото, иначе пропусти] + +### Количество слов: XX + +--- + +### Оценка по критериям + +| Критерий | Название | Балл | Макс | +|----------|----------|------|------| +| К1 | Формулировка проблем исходного текста | X | 1 | +| К2 | Комментарий к проблеме | X | 6 | +| К3 | Отражение позиции автора | X | 1 | +| К4 | Отношение к позиции автора | X | 1 | +| К5 | Смысловая цельность, связность | X | 2 | +| К6 | Точность и выразительность речи | X | 2 | +| К7 | Орфография | X | 3 | +| К8 | Пунктуация | X | 3 | +| К9 | Языковые нормы | X | 2 | +| К10 | Речевые нормы | X | 2 | +| К11 | Этические нормы | X | 1 | +| К12 | Фактическая точность | X | 1 | +| **ИТОГО** | | **XX** | **25** | + +--- + +### Подробные комментарии + +**К1 — [балл/1]** +[объяснение] + +**К2 — [балл/6]** +[объяснение с цитатами из текста] + +... и так далее по каждому критерию ... + +--- + +### Главные рекомендации +1. [самое важное для улучшения] +2. ... +``` + +--- + +## Модуль 2: Аудирование ЕГЭ по английскому + +### Что получает агент от проверяющего +Проверяющий присылает в одном сообщении: +1. **Аудиозапись** — файл с устными ответами ученика (MP3, WAV, M4A и т.д.) +2. **Правильные ответы (ключи)** — текстом или фото бланка с ключами + +### Шаг 1 — Распознать аудио +Транскрибируй аудиофайл. Из транскрипта извлеки ответы ученика по каждому заданию: +- Задание 1 (соответствие A-F): какую цифру 1-7 назвал ученик для каждого высказывания +- Задания 2-9 (True/False/Not Stated): цифру 1, 2 или 3 +- Задания 10-18 (выбор): цифру 1, 2 или 3 + +Если ответ нечеткий или не прозвучал — отметь как "?" и засчитай как неверный. +Выведи распознанные ответы таблицей и попроси проверяющего подтвердить перед проверкой. + +### Шаг 2 — Получить и распознать ключи +Если ключи пришли текстом — использовать напрямую. +Если пришло фото бланка с ключами — распознать через vision. + +### Шаг 3 — Сверить и выставить баллы +Читай `references/english-listening-criteria.md` для деталей по каждому блоку заданий. +Сверяй ответ ученика с ключом: 1 балл за совпадение, 0 за несовпадение. + +### Шаг 4 — Вывести результат в формате таблицы +Три блока (Задание 1 / Задания 2-9 / Задания 10-18) с колонками: задание, ответ ученика, ключ, результат. +Итог: сумма баллов по каждому блоку + общий итог из 23. + +--- + +## Общие принципы проверки + +- **Актуальность**: Критерии соответствуют демоверсии ФИПИ 2024–2025 +- **Строгость**: Придерживайся формулировок критериев, не занижай и не завышай +- **Пограничные случаи**: При сомнении между баллами — объясни оба варианта и выбери более обоснованный +- **Тон**: Конструктивный, поддерживающий. Это учебный инструмент, не карательный +- **Совместимость**: Скилл написан без привязки к конкретной модели. Работает с любым multimodal агентом, поддерживающим vision и аудио (Qwen3, GPT-4o, и др.) diff --git a/ege-checker/references/english-listening-criteria.md b/ege-checker/references/english-listening-criteria.md new file mode 100644 index 0000000..33d29b3 --- /dev/null +++ b/ege-checker/references/english-listening-criteria.md @@ -0,0 +1,30 @@ +# Критерии оценивания раздела "Аудирование" ЕГЭ по английскому языку +## Статус: заглушка — будет заполнено в следующей итерации + +### Структура раздела (ЕГЭ 2024–2025) + +**Задание 1** (B1) — установление соответствия: 6 высказываний → 7 утверждений +- 1 балл за каждое верное соответствие +- Максимум: 6 баллов + +**Задания 2–9** (B2) — верно/неверно/не сказано (True/False/Not Stated) +- 1 балл за каждый верный ответ +- Максимум: 8 баллов + +**Задания 10–18** — краткий ответ/выбор из нескольких вариантов +- 1 балл за каждый верный ответ +- Максимум: 9 баллов + +**Итого по разделу "Аудирование": 20 первичных баллов** + +--- + +## STT интеграция (планируется) + +Для обработки аудиозаписей потребуется: +- OpenAI Whisper API (рекомендуется для русской и английской речи) +- Или Deepgram (альтернатива) +- Эндпоинт: `https://api.openai.com/v1/audio/transcriptions` +- Модель: `whisper-1` + +Временное решение для MVP: попросить пользователя ввести ответы текстом. diff --git a/ege-checker/references/russian-essay-criteria.md b/ege-checker/references/russian-essay-criteria.md new file mode 100644 index 0000000..d3317b5 --- /dev/null +++ b/ege-checker/references/russian-essay-criteria.md @@ -0,0 +1,206 @@ +# Критерии оценивания сочинения ЕГЭ по русскому языку +## Источник: ФИПИ, демоверсия 2024–2025 + +--- + +## Предварительные проверки + +### Подсчёт слов +- Считаются все слова, включая служебные (предлоги, союзы, частицы) +- Если слов **меньше 70** → все критерии = 0 (кроме К10) +- Если слов **70–149** → рекомендуемый объём не выдержан, но работа проверяется +- Рекомендуемый объём: **150–300 слов** + +### Правило нулевого К1 +Если К1 = 0 (проблема не сформулирована или сформулирована неверно): +→ К2 = 0, К3 = 0, К4 = 0 **автоматически** + +--- + +## К1 — Формулировка проблем исходного текста (0–1 балл) + +**1 балл**: Экзаменуемый (в той или иной форме) верно сформулировал одну из проблем исходного текста. Фактических ошибок, связанных с пониманием и формулировкой проблемы, нет. + +**0 баллов**: Экзаменуемый не смог верно сформулировать ни одну из проблем исходного текста. + +**Подсказки для проверки:** +- Проблема должна быть сформулирована как вопрос или тезис +- Она должна соответствовать содержанию исходного текста +- Допустимы разные формулировки одной и той же проблемы + +--- + +## К2 — Комментарий к сформулированной проблеме исходного текста (0–6 баллов) + +Структура: **2 примера-иллюстрации** из текста + **смысловая связь** между ними. + +| Баллы | Условия | +|-------|---------| +| 6 | Оба примера с пояснениями + связь с анализом | +| 5 | Оба примера с пояснениями + связь без анализа | +| 4 | Оба примера с пояснениями, связь не указана | +| 3 | Один пример с пояснением + связь | +| 2 | Оба примера без пояснений + связь | +| 1 | Один пример без пояснения | +| 0 | Примеры отсутствуют или текст пересказан | + +**Важно:** +- Пример-иллюстрация = конкретный фрагмент/факт из текста с объяснением его роли +- Смысловая связь: сравнение, противопоставление, причина-следствие, вывод и т.д. +- Пересказ без анализа = 0 баллов +- Фактические ошибки в комментарии снижают балл (−1 за каждую, но не более −2) + +--- + +## К3 — Отражение позиции автора исходного текста (0–1 балл) + +**1 балл**: Позиция автора верно сформулирована. Фактических ошибок нет. + +**0 баллов**: Позиция автора не сформулирована или сформулирована неверно. + +**Подсказки:** +- Позиция = ответ автора на поставленную проблему +- Должна быть явно выражена, не просто угадана +- Можно цитировать или пересказывать + +--- + +## К4 — Отношение к позиции автора по проблеме исходного текста (0–1 балл) + +**1 балл**: Экзаменуемый выразил своё отношение к позиции автора и обосновал его. + +**0 баллов**: Экзаменуемый не выразил своё отношение или оно не обосновано. + +**Подсказки:** +- Формальное согласие/несогласие без обоснования = 0 +- Обоснование: личный опыт, примеры из жизни/литературы, логические доводы +- Фраза "я согласен с автором" без аргумента = 0 + +--- + +## К5 — Смысловая цельность, речевая связность и последовательность изложения (0–2 балла) + +**2 балла**: Работа характеризуется смысловой цельностью, речевой связностью и последовательностью изложения. Логических ошибок нет. Абзацное членение присутствует. + +**1 балл**: 1–2 логические ошибки ИЛИ нарушено абзацное членение. + +**0 баллов**: 3+ логические ошибки ИЛИ отсутствует абзацное членение. + +**Типичные логические ошибки:** +- Нарушение последовательности мысли +- Отсутствие связи между абзацами +- Повтор одной мысли разными словами +- Противоречия в тексте + +--- + +## К6 — Точность и выразительность речи (0–2 балла) + +**2 балла**: Работа характеризуется точностью выражения мысли, разнообразием грамматического строя речи. + +**1 балл**: Работа характеризуется точностью выражения мысли, но однообразием грамматического строя речи ИЛИ выразительностью, но использованием неточных слов. + +**0 баллов**: Точность и выразительность речи существенно снижены. + +**Примечание:** К6 не может быть выше К10. Если К10 = 0, то К6 = 0. + +--- + +## К7 — Соблюдение орфографических норм (0–3 балла) + +| Баллы | Количество ошибок | +|-------|-------------------| +| 3 | 0 ошибок | +| 2 | 1 ошибка | +| 1 | 2–3 ошибки | +| 0 | 4+ ошибки | + +**Что считается ошибкой:** +- Неверное написание слова +- Слитное/раздельное/дефисное написание +- Прописные/строчные буквы + +**Что НЕ считается ошибкой:** +- Описки (если исправлены) +- Перенос слова + +--- + +## К8 — Соблюдение пунктуационных норм (0–3 балла) + +| Баллы | Количество ошибок | +|-------|-------------------| +| 3 | 0 ошибок | +| 2 | 1–2 ошибки | +| 1 | 3–4 ошибки | +| 0 | 5+ ошибок | + +**Типичные ошибки:** +- Пропуск запятой при однородных членах +- Ошибки в сложных предложениях +- Неверное оформление прямой речи + +--- + +## К9 — Соблюдение языковых норм (грамматика) (0–2 балла) + +| Баллы | Количество ошибок | +|-------|-------------------| +| 2 | 0 ошибок | +| 1 | 1–2 ошибки | +| 0 | 3+ ошибки | + +**Типичные грамматические ошибки:** +- Ошибки в согласовании (управлении) +- Неправильное образование форм слова +- Нарушение синтаксических норм + +--- + +## К10 — Соблюдение речевых норм (0–2 балла) + +| Баллы | Количество ошибок | +|-------|-------------------| +| 2 | 0–1 ошибка | +| 1 | 2–3 ошибки | +| 0 | 4+ ошибки | + +**Типичные речевые ошибки:** +- Тавтология (повтор одного слова/однокоренных слов) +- Плеоназм (масло масляное) +- Неуместное употребление слова +- Употребление слова в несвойственном значении + +--- + +## К11 — Соблюдение этических норм (0–1 балл) + +**1 балл**: Этические ошибки отсутствуют. + +**0 баллов**: Допущена 1+ этическая ошибка. + +**Этические ошибки:** +- Грубость, оскорбления в адрес кого-либо +- Национальная/религиозная нетерпимость +- Речевая агрессия + +--- + +## К12 — Соблюдение фактологической точности (0–1 балл) + +**1 балл**: Фактические ошибки отсутствуют. + +**0 баллов**: Допущена 1+ фактическая ошибка. + +**Фактические ошибки:** +- Неверные имена, даты, названия произведений +- Искажение содержания упомянутых текстов +- Неверные факты о реальных событиях/людях + +--- + +## Таблица максимальных баллов + +| К1 | К2 | К3 | К4 | К5 | К6 | К7 | К8 | К9 | К10 | К11 | К12 | Итого | +|----|----|----|----|----|----|----|----|----|-----|-----|-----|-------| +| 1 | 6 | 1 | 1 | 2 | 2 | 3 | 3 | 2 | 2 | 1 | 1 | **25** | diff --git a/ege.skill b/ege.skill deleted file mode 100644 index 2d6c976..0000000 Binary files a/ege.skill and /dev/null differ diff --git a/english-listening-checker.html b/english-listening-checker.html new file mode 100644 index 0000000..d886a8c --- /dev/null +++ b/english-listening-checker.html @@ -0,0 +1,563 @@ + + + + + +ЕГЭ Английский — Аудирование + + + +
+ +

ЕГЭ — Аудирование (Английский язык)

+

Загрузи аудиозапись ответов ученика → получи транскрипт → сверь с ключами → баллы

+ + +
+
Настройки API
+
+
+ + +
+
+ + +
+
+
+
+ + +
+
+ + +
+
+
+ + +
+
+ + +
+
+
1
+
+
Загрузи аудиозапись ответов ученика
+
+
🎤
+
Нажми или перетащи аудиофайл
+
MP3, WAV, M4A, OGG, WEBM — до 25 МБ
+ +
+ +
+
+
+ + +
+
+
2
+
+
Введи правильные ответы (ключи)
+

Заполни ключи для заданий, которые есть в варианте. Пустые задания игнорируются.

+ +
+ ЗаданиеКлюч (верный)— пусто — +
+ +
Задание 1 — Соответствие (A–F → цифра 1–7)
+
+ +
+ +
Задания 2–9 — True(1) / False(2) / Not Stated(3)
+
+ +
+ +
Задания 10–18 — Выбор из 3 вариантов (1/2/3)
+
+ +
+
+
+
+ + +
+ + +
+ + + + + +
+ +
+
Транскрипт ответов ученика
+
+
+
Распознанные ответы
+
+
+
+ +
+
Детальная проверка
+ +
+

Задание 1 — Установление соответствия

+ + + +
ВысказываниеОтвет ученикаКлючРезультат
+
+ +
+ +
+

Задания 2–9 — True / False / Not Stated

+ + + +
ЗаданиеОтвет ученикаКлючРезультат
+
+ +
+ +
+

Задания 10–18 — Выбор ответа

+ + + +
ЗаданиеОтвет ученикаКлючРезультат
+
+
+ +
+
+
Итоговый балл
+
—
+
из 23 первичных баллов
+
+
+
Ошибки
+
+
+
+ +
+ +
+ + + + diff --git a/ege_tester.html b/russian-writing-checker.html similarity index 100% rename from ege_tester.html rename to russian-writing-checker.html diff --git a/tests/test-1/skan-1.jpg b/tests/russian/test1/skan-1.jpg similarity index 100% rename from tests/test-1/skan-1.jpg rename to tests/russian/test1/skan-1.jpg diff --git a/tests/test-1/skan-2.jpg b/tests/russian/test1/skan-2.jpg similarity index 100% rename from tests/test-1/skan-2.jpg rename to tests/russian/test1/skan-2.jpg