lesson

name	lesson
description	Открыть очередное занятие из персонального руководства (daily/YYYY-MM-DD.md, fallback assignments/) и провести его в чате с пилотом. Используй когда пилот говорит «начнём занятие», «открой занятие», «давай заниматься», «/lesson» — или в личке утром после доставки. Парный скилл: /lesson-close — закрытие занятия с метаданными в workbook/.

/lesson — провести занятие из персонального руководства

⚡ Алгоритм, не диалог. Шаги 1-6 последовательно. Диалог только в шагах 4-5 (Урок→Вопрос→Задание). Без вопросов — не начинать.

Канал доставки SC.020 v2 (VS Code): альтернатива Telegram-боту. Пилот открывает personal-guide репо в VS Code → видит сегодняшний daily/YYYY-MM-DD.md → запускает Claude Code → /lesson → проходит занятие → /lesson-close → коммит в workbook/. Push webhook → Activity Hub → ЦД → Портной корректирует.

When to use

Открыть очередное занятие из персонального руководства (daily/YYYY-MM-DD.md, fallback assignments/) и провести его в чате с пилотом. Используй когда пилот говорит «начнём занятие», «открой занятие», «давай заниматься», «/lesson» — или в личке утром после доставки. Парный скилл: /lesson-close — закрытие занятия с метаданными в workbook/.

Контракт скилла

• Вход: репо personal-guide (плоское имя, под аккаунтом пилота) с файлом дневного задания. Портной (через /personal-guide-render или ИИ-агент-носитель WP-149 Block D) пишет в daily/YYYY-MM-DD.md (primary). Старая локация — assignments/YYYY-MM-DD.md — оставлена как fallback для обратной совместимости.
• Выход: проведённое занятие — три экрана в чате (Урок → Вопрос → Задание) + созданный/обновлённый workbook/YYYY-MM-DD.md со скелетом ответов. Сам коммит — в /lesson-close.
• Время: 15-30 мин (зависит от глубины задания).
• Не делает: не оценивает ответы (Оценщик R12 — отдельный РП), не пишет в ЦД (Activity Hub после webhook), не запускает по расписанию.

Algorithm

Шаг 1. Прочитать файл дневного задания

1. Определи дату: аргумент скилла или сегодня (date +%Y-%m-%d).
2. Поиск файла по приоритету:
   • (a) daily/YYYY-MM-DD.md — основная локация (что пишет /personal-guide-render)
   • (b) assignments/YYYY-MM-DD.md — fallback (legacy nomenclature по SC.020 v2 spec)
3. Если файл не найден ни там, ни там:
   • Проверь репо: git remote -v содержит personal-guide? Если нет — сообщи пилоту: «Я не вижу репо personal-guide. Открой его в VS Code или выполни /personal-guide-start.»
   • Проверь вчерашний daily/<вчера>.md. Если есть — предложи: «На сегодня дневное задание ещё не сгенерировано. Портной не отработал утренний рендер. Откроем вчерашнее?»
   • Если и вчерашнего нет — предложи: «В репо нет ни одного daily/*.md. Запусти /personal-guide-render — Портной сгенерирует свежее под твой текущий профиль.»
4. Прочитай файл целиком (Read). Ожидаемая структура:

---
date: YYYY-MM-DD
stage: 2-5            # ступень ученика
bottleneck: W|M1|M2|M3|M4   # активный слот
theme: <название темы>
element_id: M-NNN | PRACTICE.NNN | METHOD.NNN
depth: 1-4            # для практики — степень
duration_min: 15-30
---

# Тема: ...

## Зачем сегодня
...

## Урок
...

## Вопрос
...

## Задание
...

Если структура отличается — работай по факту, не требуй идеала. Минимум: должна быть тема и хотя бы одна из секций Урок/Вопрос/Задание.

Шаг 2. Объявить занятие (роль Навигатора)

Открой одним сообщением:

📖 Занятие на <дата>
Тема: <theme>
Ступень: <stage> · Bottleneck: <bottleneck>
Время: ~<duration_min> мин

<Содержимое секции «Зачем сегодня» из assignment>

Готов? Скажи «давай» или «дальше» — пойдём по занятию.

Жди ответа пилота. Без ответа — не продолжать.

Шаг 3. Урок (теория)

Отправь содержимое секции ## Урок из assignment-файла. Не пересказывай — копируй как есть (Портной уже адаптировал под ступень и стиль). После урока — один вопрос:

«Понятно? Скажи "да" / задай вопрос / попроси пример. Когда готов — пойдём к вопросу».

Жди ответ. Если задан уточняющий вопрос — ответь, используя mcp__claude_ai_IWE__knowledge_search если нужно. Не выходи за рамки темы урока.

Шаг 4. Вопрос (понимание)

Отправь секцию ## Вопрос. Это проверка понимания, не задание. Жди свободный ответ пилота. После ответа:

• НЕ оценивай корректность развернуто (это работа Оценщика). Один акценный комментарий: «Понял. Услышал X — отметил.» или «Уточнение: <одна мысль>».
• Запомни ответ для шага 6 (записать в workbook).

Шаг 5. Задание (практика)

Отправь секцию ## Задание. Структура задания зависит от ступени:

• Ступень 2-3: конкретное действие на сегодня/неделю с критерием выполнено
• Ступень 4-5: моделирование (заполнить таблицу: роли / стейкхолдеры / целевые системы / РП)

После задания пилот может:

• выполнить сразу в чате — приму ответ, помечу в workbook
• отложить — пометить «to-do» в workbook со сроком из задания
• переформулировать — обсудить переформулировку, итог в workbook

Жди реплики пилота. Без неё — не закрывать.

Шаг 6. Подготовить workbook-скелет

Создай (или дополни) файл workbook/YYYY-MM-DD.md через Write со структурой:

---
date: YYYY-MM-DD
assignment_ref: daily/YYYY-MM-DD.md  # или assignments/ если файл взят из fallback
theme: <скопировать из assignment>
element_id: <скопировать из assignment>
stage: <скопировать>
bottleneck: <скопировать>
started_at: <ISO timestamp начала>
status: in_progress
---

# Workbook: <theme>

## Ответ на вопрос
<ответ пилота из шага 4>

## Задание
<копия задания из assignment>

### Ответ / прогресс
<ответ пилота из шага 5; если отложено — поле "to-do до <дата>">

## Заметки на полях
<если пилот говорил «запиши» / попроси одну фразу о том, что важно зафиксировать>

НЕ коммить сейчас. Финальный коммит = задача /lesson-close (запускается после того, как пилот скажет «закрываем», «всё», «закончили»).

Сообщи пилоту:

✅ Workbook-файл готов: workbook/<дата>.md (статус: in_progress). Когда захочешь закрыть занятие — скажи «закрываем», запущу /lesson-close — он зафиксирует metadata и сделает коммит.

Граничные случаи

Ситуация	Действие
Пилот хочет пропустить вопрос	Записать skipped: true в workbook, перейти к заданию
Пилот хочет пропустить задание	Записать skipped: true, занятие считается «прочитано, не сделано». В /lesson-close это передаётся в Activity Hub как lesson_partial
Пилот молчит >10 мин в середине	Не «толкать». Скажи: «Окей, пауза. Когда вернёшься — продолжим с шага N. Workbook сохранён частично.»
Файл assignment отсутствует и /personal-guide-render не помогает	Сообщи: «Сегодня assignment не сгенерирован, Портной не отработал. Это известная проблема — записал. Хочешь, разберём вчерашнее занятие?»
Пилот хочет поднять тему за пределами assignment	Не уходи в сторону. Скажи: «Это интересно, но не сегодняшнее занятие. Запишу как fleeting-note для Note-Review.» — и предложи использовать mcp__claude_ai_IWE__personal_write для записи.

Связь с другими механизмами

• /personal-guide-render — создаёт daily/<дата>.md (через personal_write MCP) до этого скилла. ИИ-агент-носитель Портного (WP-149 Block D, в будущем) будет писать туда же.
• /lesson-close — финальный коммит + триггер push в GitHub → webhook → Activity Hub → sync_one_user_to_dt (WP-301 Ф4).
• Оценщик (R12) — после push в workbook/ отдельно оценивает качество ответа против can-do; работает асинхронно.
• Канал-альтернатива: Telegram (engines/tailor/bot_adapter.py + splitting WP-301 Ф1) — для пилотов без VS Code.

Антипаттерны

• ❌ Не оценивать ответы развернуто — это работа R12 Оценщика
• ❌ Не уходить за рамки темы урока — даже если интересно
• ❌ Не «выпрашивать» ответ — если пилот молчит, дай паузу
• ❌ Не редактировать assignment-файл — он source-of-truth от Портного
• ❌ Не коммитить сразу — финальный коммит в /lesson-close после явного «закрываем»