| 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), а не объяснение концепта.
