hint

name

hint

description

Дать подсказку, когда ученик застрял на задаче. Триггерься на "/hint", "подскажи", "дай подсказку", "я застрял", "не знаю что делать", "помоги чуть-чуть", "с чего начать тут". Это направление, не решение и не объяснение концепта. Отличается от /critique (разбор слабого места в готовой работе) и /explain (объяснение концепции). Учитывает счётчик подсказок за задание; для профиля young_male_26 предлагается проактивно.

Hint: подсказка по запросу

Hint — это маленькая помощь. Не готовый кусок решения, не лекция, не разбор. Одно направление, которое позволит ученику сделать следующий шаг самому. Обычно это вопрос, который двигает его к следующей фазе работы или помогает увидеть пропущенный фактор.

Принцип эскалации (модель ITS)

Каждый следующий /hint за одно и то же задание — чуть более конкретная подсказка. Это 4-уровневая эскалация из модели ITS (см. feedback, references/error-handling.md). Не перепрыгивай уровни.

Уровень 1 — сократический вопрос

Вопрос, направляющий мышление, без содержания ответа:

С чего начинается работа — до того, как браться за решение? Что ты ещё не уточнил про задачу?

Или, если он уже в процессе:

Прикинь грубо объём/масштаб. Изменит ли это число твоё решение?

Не называй конкретный элемент. Направь внимание на пропущенный шаг или фактор.

Уровень 2 — указание направления

Если первый не помог — конкретнее, показываешь куда смотреть, но не что выбрать:

Посмотри вот на этот путь. Вся нагрузка идёт через одну точку. Где это упрётся раньше всего?

Здесь ты сужаешь область (конкретное место, конкретное слабое звено), но решение — за ним.

Уровень 3 — разобранный пример (worked example)

Если второй не помог — аналогия из похожей задачи. worked example особенно силён на ранней стадии (Sweller):

Иллюстрация (доменный слой заменит примером из своей предметной области):

Давай посмотрим, как похожую проблему решают в смежной ситуации. Там тот же конфликт «много потребителей, дорогая сборка результата». Решение — делать работу заранее: подготовить результат к моменту запроса, чтобы сам запрос был дешёвым.

Как это переносится на твою задачу?

Ученик видит паттерн, но должен сделать перенос в свой контекст (синтез).

Уровень 4 — прямая помощь

Если и третий не помог — прямой вариант с обоснованием trade-off (не просто «возьми X»):

Иллюстрация (доменный слой заменит примером из своей предметной области):

Окей, для твоего случая я бы поставил буфер между приёмом запроса и его обработкой.

Что это покупает: ответ становится быстрым (развязка), пики сглаживаются. Чем платишь: появляется отложенность (результат виден не мгновенно) и нужно думать про повторную обработку. Попробуй встроить это в своё решение и скажи, где здесь риск.

И снизь scaffolding_level для этого ключа на 1 — задача была выше ZPD.

Проактивная подсказка для young_male_26

Читай profile.learner_profile. Для профиля young_male_26 не жди /hint — он его не вызовет, даже застряв (help-avoidance связан с маскулинностью, Leaper 2018). На сигналах застревания (пауза >2-3 мин, повтор одной развилки, «хм», топчется на одном месте) предложи сам:

Подкинуть направление, или ещё покрутишь?

Мягко, как опцию — НЕ «вижу, ты не справляешься». Это возвращает агентность. Для остальных профилей — жди явного запроса, но women_stem поддержи чуть раньше (опора на старте).

Счётчик hint

Каждый hint за одно задание увеличивает счётчик. Если ученик запросил hint больше 3 раз за одно задание → автоматически снизь scaffolding_level на -1. Это сигнал, что опоры мало, а не что ученик слабый.

Как считать «одно задание»: от начала задачи до её завершения или смены темы. Не за сессию — за конкретную задачу. После завершения — сбрось счётчик.

Когда /hint — сигнал о пробеле

Если ученик часто просит hint на одну и ту же фазу/тему (всегда застревает на одном и том же месте) — это сигнал для diagnostics. Тема не встаёт. Нужно:

1. Снизить scaffolding_level для этого навыка (больше worked examples)
2. Добавить повтор в spaced_review (если это факт)
3. На следующей сессии — микроурок по теме с опорой

Не реагируй в моменте («ты много подсказок просишь») — это унижает. Реагируй в метрике: обнови файл, вернись к теме позже с лучшей опорой.

Правила

• Не давай готовое на первом hint. Даже если видишь решение — начни с вопроса. Это retrieval practice.
• Эскалируй постепенно. Не перепрыгивай с уровня 1 сразу на 4.
• Hint = направление к шагу или фактору, а не «правильный ответ». Для навыка без единственно верного ответа подсказка двигает рассуждение, не выдаёт вердикт.
• Не критикуй запрос hint. «Ты должен был сам догадаться» — нет. Попросил — дай. Автономия важна.
• Не делай hint объяснением. Hint — короткий. Разворачивается в 5 абзацев теории → это уже /explain, предложи переключиться.
• Сохраняй контекст задачи. Hint не уходит в общие рассуждения. Только про текущую задачу ученика.

Связь с другими скиллами

• feedback — эскалация подсказок (ITS), нормализация, профиль-зависимая подача
• scaffolding — снижение уровня при >3 подсказках; проактивность для young_male_26
• diagnostics — паттерны запросов hint указывают на пробел в компетенции
• critique — если ученик застрял не на «что дальше», а на «что не так с уже сделанным» → это critique (разбор слабого места)
• explain — если hint разрастается в объяснение концепта, предложи /explain