update skill, add roadmap, reorganize project

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, и др.)

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: попросить пользователя ввести ответы текстом.

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** |