Челлендж или вопросы из своей заметки

Из любой markdown-заметки в твоём репозитории можно сделать вопросы для тренировки или челлендж с заданиями. Файлы появляются рядом с заметкой одним коммитом, их можно поправить руками.

Кому доступно Собрать может тот, кто пишет в репозиторий, где включены «Учиться» и ИИ, а агенту разрешено всё. Генерация открывается после подтверждения почты; на модели SKILLOK расходует лимит тарифа.

Обновлено Скопировать как Markdown
В этой статье

Попроси агента#

Открой Пространство ИИ, прикрепи репозиторий и напиши, что нужно:

  • «Сделай тренировку из notes/git.md» — 8–12 вопросов разных видов по тексту заметки: выбор, порядок, пары, пропуски, короткий ответ, число, если в заметке есть числа, и несколько карточек для терминов. Вопросы ложатся рядом с заметкой, в папку .challenge, одним этапом. Дальше они возвращаются по расписанию, см. Тренировать.
  • «Сделай челлендж из notes/git.md» — 4–7 этапов: вводный этап с теорией, задания руками — конспект, разбор, расчёт, таблица, план или код на Python с тестами — и вопросы на понимание в конце. Дальше — как с любым челленджем, см. Челленджи.

Путь можно не знать: агент сам найдёт заметку по описанию. Так же работает внешний агент по MCP.

Из нескольких заметок#

Вопросы и челлендж собираются не только из самой заметки, но и из заметок, на которые она ссылается. Сделай заметку-оглавление со ссылками на нужные файлы — [Ряды](ryady.md), [Интегралы](../obshchee/integraly.md) — и попроси собрать из неё: материал соберётся из всех.

  • Берутся ссылки на .md этого же репозитория, записанные относительно заметки.
  • Один уровень: ссылки внутри добавленных заметок уже не открываются.
  • Не больше 10 заметок по ссылкам и не больше 40 000 знаков всего — остальное отбрасывается.
  • Папка челленджа появляется рядом с заметкой-оглавлением.

Вместе со связанными заметками материала должно быть хотя бы на несколько абзацев, иначе собирать не из чего.

Пока собирается#

В ленте появляется карточка Обучение собирается — она ведёт на вкладку Учиться репозитория с полосой «Собираю — это займёт минуту-другую…». Когда готово, оттуда сразу открывается тренировка или челлендж. Страницу можно закрыть — задача идёт дальше, её видно в Процессах как «Вопросы по заметке» или «Челлендж из заметки».

Если не получилось — «Не получилось собрать. Попробуй ещё раз позже.» — попроси агента ещё раз: неудачная попытка файлов не оставляет, повтор начинается заново. Агент сразу скажет об отказе, без генерации, когда:

  • почта не подтверждена;
  • лимит модели SKILLOK по тарифу израсходован — выбери другую модель или подожди, см. Лимит SKILLOK;
  • уже идёт слишком много задач — дождись, пока они завершатся;
  • рядом с заметкой уже есть папка .challenge — открой её или удали, чтобы собрать заново;
  • материала слишком мало — даже вместе с заметками по ссылкам;
  • в репозитории выключены «Учиться» или ИИ, или агенту разрешено меньше, чем всё.

Где файлы#

Когда готово, рядом с заметкой появляется папка: для notes/git.md это notes/git.challenge/. В её challenge.md стоит source: ../git.md — на странице челленджа это ссылка «Материал, из которого он сделан». Коммит один, от твоего имени.

После этого на странице заметки появляются кнопки:

  • у заметки — Тренировать и Открыть челлендж;
  • у файла этапа stages/…md — Открыть этап: этап во вкладке Учиться;
  • у challenge.md — Открыть челлендж.

Что проверяется до того, как ты увидишь#

  • Файлы проходят ту же проверку формата, что и написанные руками. Вопрос, который не собрался, выбрасывается, а не ломает челлендж. Если у тренировки собралось меньше трёх вопросов или собранный челлендж не прошёл проверку, генерация считается неудачной и ничего не коммитит.
  • Тесты кодовых этапов запускаются дважды: на эталонном решении они обязаны пройти, на заготовке — упасть. Эталонное решение в репозиторий не попадает.
  • Если тесты этой проверки не прошли, проверка тестами с этапа снимается. Этап остаётся с проверкой файлов и пунктом самопроверки «Решение работает на примерах из задания», а в тексте этапа написано, что автотесты не прошли проверку и что решение нужно проверить самому.

Править#

Это обычные файлы твоего репозитория: вопрос можно переписать, этап — удалить или добавить, проверку — поменять. Формат — в Формат челленджа. У каждого вопроса в заголовке стоит id в фигурных скобках — по нему живёт расписание повторений, поэтому текст вопроса править можно, а id лучше не трогать.

Что видно о прохождении — в Прогресс.

Было полезно?