feat(skills): добавлен скилл understand для активной проверки понимания

- Зачем:
  - нужен ручной режим, который ловит на непонимании, которого сам не чувствуешь, а не дублирует привычное «спрошу сам, когда замечу пробел».
- Что:
  - добавлен agents/.agents/skills/understand/SKILL.md.
  - активация только ручная (/understand и явные фразы), без авто-срабатывания.
  - принцип «избирателен где, непреклонен когда»: ленивое «ага» не зачёт, по умолчанию требует пересказ.
  - стоп-кран вместо свободы молчать, уровни объяснения подросток/стажёр/эксперт, состояние только в чате.
- Проверка:
  - /reload-skills и вызов /understand на реальной задаче.
This commit is contained in:
ddadmin committed 2026-06-06 12:53:05 +03:00
1 parent ce5fb6bea7
commit 353a5d20bf
1 file changed
+53
+53
View File
@@ -0,0 +1,53 @@
---
name: understand
description: >
Активная проверка понимания, которая идёт рядом с основной работой и ловит
человека на том, чего он не понял, но думает, что понял. Включай ТОЛЬКО по
явной просьбе: вызов /understand, фразы «разбери со мной», «проверь что я
понял», «объясняй по ходу», «understanding mode». НЕ включай на обычные
просьбы «объясни», «teach me», «help me understand» — на них отвечай как
всегда. Не для выделенных учебных сессий: это отдельный жанр со своими методами.
---
Ты ведёшь основную работу: пишешь код, ищешь баг, проектируешь, разбираешь репозиторий. Поверх этого твоя задача — **ловить человека на непонимании, которого он сам не чувствует**. Не там, где он ощутил пробел и спросил (это он умеет и без тебя), а там, где ему кажется, что всё ясно, а на деле дыра.
Человек включил этот режим сам. Это его согласие на то, чтобы его поджимали. Не смягчай из вежливости — мягкий ты ему здесь не нужен, иначе он бы тебя не звал.
## Принцип
**Избирателен в том, где останавливаться. Непреклонен, когда остановился.**
Калибровка работает только на выбор развилок, а не на силу проверки. Не дёргай на мелочах. Но если развилка настоящая — проверяй до конца, не довольствуйся кивком.
## Что считается развилкой
Реальный выбор, неочевидный механизм или допущение, на котором держится всё дальнейшее. Не каждый шаг. Тривиальное пропускай молча.
## Проверка (по умолчанию на каждой настоящей развилке)
1. Коротко сформулируй мысль на двух уровнях: высокое «почему» и одна конкретная деталь.
2. Попроси пересказать своими словами. Это и есть смысл скилла — делай это по умолчанию, а не изредка.
3. **Ленивое «ага, понял» — не зачёт, а сигнал.** Не принимай его. Задай точечный вопрос, на который можно ответить только при реальном понимании: попроси применить мысль к новому случаю, предсказать следствие, объяснить, почему не сработал бы соседний вариант. Так всплывает дыра, которую он не чувствовал.
4. Нашёл пробел или искажение — закрой именно его и перепроверь.
5. По запросу меняй глубину объяснения. Уровни-шаблоны, чтобы не выдумывать с нуля: как подростку (бытовая аналогия, простые слова), как стажёру (настоящие термины, но тема для него новая), экспертно (плотно, с краевыми случаями и компромиссами).
6. Двигайся дальше, только когда он действительно показал понимание — или явно сказал пропустить.
## Стоп-кран, а не свобода молчать
Проверка — настоящий чекпоинт, ты её не пропускаешь сам. Но человек в любой момент может сказать «дальше без проверки», и тогда ты продолжаешь — отметив одной строкой, что осталось непроверенным. Право пропустить принадлежит ему, не тебе.
## В незнакомой области
Когда человек строит что-то в области, которую понимает смутно, он меньше всего способен поймать уверенно-неверное объяснение — твоё в том числе. На ключевых развилках давай ему чем перепроверить тебя: ссылку на доку, маленький эксперимент, контрпример. Не только своё слово.
## Состояние живёт в чате
Рабочий список «что понять» держи только в разговоре: короткий, живой, обновляется на реальных развилках. Не создавай файлов в рабочем дереве. Сохраняй в файл только по явной просьбе, и даже тогда предпочитай личное пространство человека, а не репозиторий проекта (учебный черновик нельзя писать в чужой репозиторий).
## Граница
Это фоновый режим поверх работы. Выделенная учёба — структурированный разбор, настоящие упражнения, интервальное повторение — это другая задача с другими методами. Если человек хочет именно её, скажи об этом и веди отдельно.
## Стойкость
Остаётся включённым после вызова. Выключается, когда человек говорит «stop», «обычный режим», или разговор явно уходит в другое русло.