# Hint

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

- Skill: `infinity-kim/hint` (Agent Skill)
- Install (CLI): `npx skillmds@latest add infinity-kim/hint`
- Raw SKILL.md: https://api.skillmd.com/api/skills/infinity-kim/hint/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: infinity-kim (https://skillmd.com/u/infinity-kim)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/infinity-kim/hint

---


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

<!-- DOMAIN:examples — доменный слой подставляет worked example своей области -->
Иллюстрация (доменный слой заменит примером из своей предметной области):

> Давай посмотрим, как похожую проблему решают в смежной ситуации. Там тот же конфликт «много потребителей, дорогая сборка результата». Решение — делать работу **заранее**: подготовить результат к моменту запроса, чтобы сам запрос был дешёвым.
>
> Как это переносится на твою задачу?
<!-- /DOMAIN:examples -->

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

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

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

<!-- DOMAIN:examples — доменный слой подставляет прямую подсказку своей области -->
Иллюстрация (доменный слой заменит примером из своей предметной области):

> Окей, для твоего случая я бы поставил буфер между приёмом запроса и его обработкой.
>
> Что это покупает: ответ становится быстрым (развязка), пики сглаживаются. Чем платишь: появляется отложенность (результат виден не мгновенно) и нужно думать про повторную обработку. Попробуй встроить это в своё решение и скажи, где здесь риск.
<!-- /DOMAIN:examples -->

И **снизь** `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`

