Учебный тренер · команда `/ask-coach`

Функций в ai-study-kit много — тренажёр, курсы, карточки, разбор ошибок, подкасты, развёртывание, — и для учащегося это само по себе обуза: что именно делать сегодня? Команда /ask-coach отвечает ровно на этот вопрос. Это встроенный в репозиторий skill главного входа: установите его один раз, начинайте с него каждое занятие — он просканирует состояние, выдаст рекомендацию и проведёт вас через выполнение. Учить наизусть цепочку инструментов не нужно.

Имена команд — это меню — плагин ai-study-kit (имя навсегда) ставит пять команд: /ask-coach — главный вход (снимок состояния + рекомендация + ведение по шагам; остальное маршрутизируется отсюда), плюс четыре тонкие команды прямого входа — /study-coach сопровождающее обучение (F10), /study-doctor комплексная проверка, /study-recap разбор ошибок (F4), /study-podcast подкаст (F5). Полный состав команд и таблица маршрутизации намерений — в skills/ask-coach/SKILL.md.

Установка

После установки для повседневной учёбы достаточно пяти команд — главный вход /ask-coach плюс четыре тонкие команды прямого входа /study-*, всё вводится в чате; достаточно сказать, что вы хотите учить. pnpm ниже — это установка/дело контрибьюторов: понадобится один раз при установке (или пусть ваш агент выполнит это за вас); повседневная учёба их не касается, и запоминать ничего не нужно.

Исходники skills лежат в репозитории в skills/ (единственный источник истины: главный вход ask-coach + четыре тонкие команды study-coach / study-doctor / study-recap / study-podcast, делящие references/ главного входа). Два пути установки:

① Маркетплейс плагинов (zcode / Claude Code, рекомендуется): репозиторий поставляет собственный манифест маркетплейса (.claude-plugin/marketplace.json; scripts/sync-plugin.mjs генерирует из исходников plugins/ai-study-kit/). Добавьте в клиенте маркетплейс https://github.com/jerryjiao/ai-study-kit и установите плагин ai-study-kit — дальнейшие обновления skill приходят с обновлением маркетплейса, переустанавливать вручную не нужно (версии следуют за релизами репозитория). После обновления плагина открытие /ask-coach в старом проекте сообщит об отставании версии и проведёт через обновление F13 (данные в безопасности, разрывы закрываются — см. F13; снимок кита сам сообщает версию через kit-version.json). Имя плагина — ai-study-kit навсегда; команды — семейство ask-coach (переименовано из /ai-study-kit в v0.13, сентябрь 2026 — имена в маркетплейсе неизменяемы, поэтому имя плагина не трогаем).

② Ручная установка (любой клиент, понимающий ~/.agents/skills/):

# из корня репозитория ai-study-kit (ставит все пять skill; тонкие команды зависят от references/ главного входа)
pnpm run skill:install          # копирует в ~/.agents/skills/{ask-coach,study-coach,study-doctor,study-recap,study-podcast}
pnpm run skill:install -- --link   # вариант с символьной ссылкой (обновляется сам при git pull)

# другие клиенты: свой каталог назначения
bash scripts/install-skill.sh --dest ~/.claude/skills

# удаление
pnpm run skill:uninstall

После установки перезапустите CLI (или откройте новую сессию) и введите /ask-coach. Можно и без установки: просто попросите агента прочитать skills/ask-coach/SKILL.md и действовать по нему.

Как это работает

Каждый вызов проходит одни и те же три шага:

Зондирование состояния (только чтение, ≤1 минуты) — тема, объём вопросов/карточек/курсов/разборов, прогресс ответов, невыпущенные ошибки, карточки к повторению, пройденные уроки, слабые цели устного опроса (выводятся из журнала попыток), сессии сопровождения и дата экзамена, конфигурация ИИ, поднят ли бэкенд, дрейф версии кита (ваш проект против снимка плагина — отставание или неизвестная версия ведёт к обновлению F13, см. ниже); если передан путь к графу знаний — ещё и сигналы графа (четыре состояния узлов, отношения предпосылок — см. F12).
Отчёт + рекомендация — таблица-снимок состояния + одно рекомендованное действие с обоснованием + нумерованное меню.
Ведение через выполнение — после вашего выбора тренер шаг за шагом идёт по playbook соответствующего процесса из skills/ask-coach/references/, а в конце сверяет результат с «критериями готовности».

Если явного намерения нет, рекомендация берётся по первому сработавшему условию в порядке очереди: проверки окружения (дрейф версии) стоят раньше учебных строк — сначала выровняем функциональный слой; вашим данным ничего не грозит. Учебная «голова» читается как «карточки → отложенный ретест → спринт → возобновление сессии»: повторение — долг, набегающий каждый день (просроченные карточки освежают память; отложенный ретест заново проверяет то, что в прошлый раз вышло ошибкой, — встроен в открытие сессии с минимальным бюджетом); спринт — окно сбора за неделю до экзамена; сессию можно продолжить в любой момент. Полный список из 13 условий с обоснованием каждой строки — в разделе «алгоритм рекомендаций» файла skills/ask-coach/SKILL.md.

Тринадцать процессов

Тринадцать процессов сгруппированы в четыре линии, номера — это меню: преподавание F10 сопровождающее обучение · F11 предэкзаменационный спринт · F12 проекция графа знаний; подготовка к экзамену F3 ежедневная отработка · F4 разбор ошибок · F5 сделать подкаст; контент F2 новая тема · F6 сгенерировать/расширить курс · F7 правка контента; эксплуатация F1 инициализация проекта · F13 обновление · F8 проверка и выпуск · F9 развёртывание. Playbook каждого процесса (цель / предусловия / шаги / критерии готовности) лежит в skills/ask-coach/references/ — этот каталог и есть единственный источник истины по деталям F1–F13; страница даёт только обзор.

Плюс два эксплуатационных входа: проверка здоровья (/study-doctor — комплексная оркестрация четырёх ворот качества + зондов окружения, с отчётом «прошёл/красный» и порядком починки) и диагностика (прогресс не синхронизируется, курс отдаёт 404, CLI ругается на конфигурацию, scan что-то нашёл… — таблица «симптом → корень → действие»).

Замечания о дизайне

Маршрутизирующий skill, а не ещё один CLI: он не тащит нового рантайма — просто кодирует схему «прочитать состояние → порекомендовать → запустить существующие команды/процессы» в виде инструкций, которым агент может следовать. Все базовые возможности уже есть в репозитории (три AI CLI, скрипты синхронизации, пороги проверки).
Состояние прежде советов: тренеру запрещено рекомендовать по наитию — у каждого поля снимка есть команда зондирования (skills/references/state.md), а статистика прогресса считается ровно так же, как в apps/quiz-app/src/lib/progress.ts (фильтрация надгробий, случайная песочница не попадает в основной прогресс, пороги «выпуска» ошибок, наступление повторений SRS).
Методология вшита внутрь: порядок рекомендательного алгоритма — это исполняемая версия «программа → материалы → вопросы» из methodology.ru.md; процесс F2 требует сначала написать MISSION (с таблицей распределения пунктов) и RESOURCES и лишь потом разрешает генерировать курсы и вопросы — написание вопросов это не свободное сочинение JSON, а производство по пунктам из таблицы, закрытое тремя зелёными порогами (qa / scan / четырёхсторонняя выверка).

Расширение

Добавить новый процесс: допишите секцию (цель / предусловия / шаги / критерии готовности) в playbooks процессов под skills/ask-coach/references/ и добавьте строку в меню и таблицу маршрутизации намерений в SKILL.md. После правки запустите pnpm run sync:plugin для перегенерации артефактов плагина (пользователи ручной установки дополнительно прогоняют pnpm run skill:install для повторного распространения).

FAQ

В: Обязательно устанавливать? О: Нет, но тогда каждый раз придётся самому решать, «что дальше». С установленным skill — вход одной фразой.

В: Он не тронет мои данные? О: Шаги 1/2 строго read-only. Шаг 3 пишет файлы и запускает команды только для выбранного вами процесса, а в playbook помечены красные линии (артефакты синхронизации нельзя править вручную, файлы прогресса нельзя править вручную).

В: Переживёт ли skill смену AI-клиента? О: Да. Skill — это markdown-инструкции + справочные документы; его можно поставить в любой клиент с поддержкой соглашения о каталоге skills (--dest укажет путь).