From e8c68ad398a530cd409899cbc451c8e41323751d Mon Sep 17 00:00:00 2001 From: Dmitry Dementev Date: Sat, 6 Jun 2026 12:58:08 +0300 Subject: [PATCH] =?UTF-8?q?docs(understand):=20=D1=83=D1=82=D0=BE=D1=87?= =?UTF-8?q?=D0=BD=D1=91=D0=BD=20=D1=80=D0=B5=D0=B6=D0=B8=D0=BC=20=D0=BF?= =?UTF-8?q?=D1=80=D0=BE=D0=B2=D0=B5=D1=80=D0=BA=D0=B8=20=D0=BF=D0=BE=D0=BD?= =?UTF-8?q?=D0=B8=D0=BC=D0=B0=D0=BD=D0=B8=D1=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Зачем: - нужен ручной режим, который проверяет понимание без лишнего торможения обычной работы. - Что: - уточнены условия opt-in и работа режима в пределах текущей сессии. - добавлены правила языка сессии, явного пропуска и обхода проверки как отсутствия сигнала. - описана соразмерная проверка и варианты форматов ответа. - Проверка: - просмотрен staged diff: git diff --cached -- agents/.agents/skills/understand/SKILL.md. --- agents/.agents/skills/understand/SKILL.md | 25 ++++++++++++----------- 1 file changed, 13 insertions(+), 12 deletions(-) diff --git a/agents/.agents/skills/understand/SKILL.md b/agents/.agents/skills/understand/SKILL.md index d0eb3cd..10b6e7b 100644 --- a/agents/.agents/skills/understand/SKILL.md +++ b/agents/.agents/skills/understand/SKILL.md @@ -2,16 +2,15 @@ name: understand description: > Активная проверка понимания, которая идёт рядом с основной работой и ловит - человека на том, чего он не понял, но думает, что понял. Включай ТОЛЬКО по - явной просьбе: вызов /understand, фразы «разбери со мной», «проверь что я - понял», «объясняй по ходу», «understanding mode». НЕ включай на обычные - просьбы «объясни», «teach me», «help me understand» — на них отвечай как - всегда. Не для выделенных учебных сессий: это отдельный жанр со своими методами. + человека на том, чего он не понял, но думает, что понял. Используй только + после явного opt-in: /understand, «разбери со мной», «проверь что я понял», + «объясняй по ходу», «understanding mode». Не включай на обычные просьбы + объяснить, подсказать, починить, исследовать или реализовать. --- Ты ведёшь основную работу: пишешь код, ищешь баг, проектируешь, разбираешь репозиторий. Поверх этого твоя задача — **ловить человека на непонимании, которого он сам не чувствует**. Не там, где он ощутил пробел и спросил (это он умеет и без тебя), а там, где ему кажется, что всё ясно, а на деле дыра. -Человек включил этот режим сам. Это его согласие на то, чтобы его поджимали. Не смягчай из вежливости — мягкий ты ему здесь не нужен, иначе он бы тебя не звал. +Человек включил этот режим сам. Будь жёстким к критерию понимания, не к человеку. Твоя задача — получить сигнал понимания или явный пропуск. ## Принцип @@ -26,11 +25,13 @@ description: > ## Проверка (по умолчанию на каждой настоящей развилке) 1. Коротко сформулируй мысль на двух уровнях: высокое «почему» и одна конкретная деталь. -2. Попроси пересказать своими словами. Это и есть смысл скилла — делай это по умолчанию, а не изредка. -3. **Ленивое «ага, понял» — не зачёт, а сигнал.** Не принимай его. Задай точечный вопрос, на который можно ответить только при реальном понимании: попроси применить мысль к новому случаю, предсказать следствие, объяснить, почему не сработал бы соседний вариант. Так всплывает дыра, которую он не чувствовал. -4. Нашёл пробел или искажение — закрой именно его и перепроверь. -5. По запросу меняй глубину объяснения. Уровни-шаблоны, чтобы не выдумывать с нуля: как подростку (бытовая аналогия, простые слова), как стажёру (настоящие термины, но тема для него новая), экспертно (плотно, с краевыми случаями и компромиссами). -6. Двигайся дальше, только когда он действительно показал понимание — или явно сказал пропустить. +2. Объясняй на языке сессии. Не мешай языки и транслитерацию без необходимости: код, команды, API, идентификаторы, ошибки и устоявшиеся термины оставляй как есть, а смысл поясняй на языке сессии. Одно понятие называй одним именем. +3. Попроси пересказать своими словами. Это и есть смысл скилла — делай это по умолчанию, а не изредка. +4. Проверка должна быть соразмерна развилке: ровно настолько подробной, чтобы получить сигнал понимания, и не больше. Формат выбирай по ситуации: пересказ, применение к новому случаю, предсказание следствия, объяснение отличия соседнего варианта, выбор с коротким обоснованием. +5. **Ленивое «ага, понял» — не зачёт, а отсутствие сигнала.** Обход проверки — не провал и не доказательство непонимания, но и не признак понимания. Повтори вопрос короче и прямо назови выход: «Ответь своими словами или скажи "пропустить"». +6. Нашёл пробел или искажение — закрой именно его и перепроверь. +7. По запросу меняй глубину объяснения. Уровни-шаблоны, чтобы не выдумывать с нуля: как подростку (бытовая аналогия, простые слова), как стажёру (настоящие термины, но тема для него новая), экспертно (плотно, с краевыми случаями и компромиссами). +8. Двигайся дальше, только когда он действительно показал понимание — или явно сказал пропустить. ## Стоп-кран, а не свобода молчать @@ -50,4 +51,4 @@ description: > ## Стойкость -Остаётся включённым после вызова. Выключается, когда человек говорит «stop», «обычный режим», или разговор явно уходит в другое русло. +После явного включения веди текущую сессию как understanding mode, пока человек не скажет «stop», «обычный режим» или явно не сменит задачу. Не требуй повторного `/understand` на каждом сообщении внутри той же сессии.