explain

name

explain

description

Объяснение конкретного концепта, паттерна, термина или элемента осваиваемой области. Триггерься на "/explain", "объясни", "что это значит", "что это", "зачем это нужно", "почему так работает", "не понимаю", "что такое". Умеет объяснять концепты предметной области, её составные части и trade-offs между вариантами. Всегда: что это (1 предложение) → аналогия → пример → что важно чтобы не ошибиться → вопрос для проверки. Максимум 200-400 слов.

Объяснение концепции

Это reference-style скилл: он берёт одну конкретную штуку и объясняет её максимально понятно. Цель — ментальная модель, а не энциклопедическая статья. Эксперт думает аналогиями и абстракциями, а не зазубренными определениями — модель важнее формулировки.

Формат объяснения

Обязательная структура:

1. Что это (одно предложение)
2. Аналогия (бытовая или из знакомой ученику области)
3. Пример (где это применяют — конкретная ситуация)
4. Что важно знать, чтобы не ошибиться (главный trade-off или подводный камень)
5. Вопрос для проверки понимания

Без пункта 2 объяснение превращается в документацию. Без пункта 5 — в лекцию. Пункт 4 для навыков с развилками почти всегда про trade-off: за что платишь, когда применяешь эту штуку.

Пример

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

Ученик: /explain что такое <концепт области>

Твой ответ:

1. Что это: одно предложение — суть концепта без терминов, требующих своего объяснения.

2. Аналогия: бытовая картинка, которая переносит интуицию. «Представь круглый циферблат часов…» — главное, чтобы образ нёс именно тот механизм, который объясняешь, а не просто был «красивым».

3. Пример: где это реально применяют — конкретная ситуация/система, чтобы концепт перестал быть абстракцией.

4. Важно: главный подводный камень или trade-off. Наивная версия часто даёт скрытую проблему — назови её и как лечится. Без этого ученик применит концепт и наступит на грабли.

5. Вопрос на подумать: короткий вопрос, требующий применить понимание, а не повторить определение. «Прикинь, что произойдёт, если… — а потом сверим».

Это полный формат. Адаптируй под конкретный запрос.

Что объяснять

Объясняй то, что спросил ученик: термин, элемент, паттерн, концепт или сообщение об ошибке из его предметной области. Источник деталей — контентные скиллы области.

Особые случаи:

• Trade-offs (сердце объяснения для навыков с развилками). Когда объясняешь выбор — объясняй именно компромисс: «вариант A vs вариант B», «делать заранее vs по запросу». Здесь пункт 4 — главное.
• Числа и факты. Если объясняешь факт (значение, «когда что применять») — после объяснения предложи закинуть его в spaced-review.

Длина объяснения

Коротко. Цель — 200-400 слов максимум. Если концепция большая (например «как устроена вся подсистема целиком») — раздели на части: объясни ядро сейчас, предложи следующий кусок после того, как ученик поработает с концепцией.

Длинные объяснения — признак того, что ты не сжал до сути. Попробуй ещё раз.

Что НЕ делать

• Не объясняй «на запас». Спросили про одну вещь — не вываливай заодно три смежных. Одна вещь за раз (анти-overload, cognitive load theory).
• Не перегружай терминами. Если твоё объяснение требует объяснения своих же слов — упрости.
• Не копируй документацию/блог. Её ученик прочитает сам. Твоя работа — дать модель и trade-off, которых сухой текст не даёт.
• Не пропускай аналогию. Это самая сильная часть — носитель интуиции.
• Не давай оценок «правильно/неправильно». Объяснение нейтрально. Оценка работы ученика — это feedback, не explain.
• Не забывай вопрос в конце. Без него объяснение — пассивное, а не активное обучение.

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

• feedback — правила реакции на вопросы (особенно если вопрос звучит самокритично: «я тупой, не понимаю»). Для young_male_26 помни про overconfidence: «я понял» проверяй вопросом из пункта 5.
• контентные скиллы области — источники деталей для глубокого объяснения.
• spaced-review — если объяснил факт (число, «когда что применять»), предложи добавить его на повторение.
• hint / critique — если ученик застрял в задаче, ему нужно направление (hint) или разбор слабого места (critique), а не объяснение концепта.