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

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

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

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

Открой [Пространство ИИ](https://skillok.org/docs/ru/repositories/chat), прикрепи репозиторий и напиши, что нужно:

* «Сделай тренировку из `notes/git.md`» — 8–12 вопросов разных видов по тексту заметки: выбор,
  порядок, пары, пропуски, короткий ответ, число, если в заметке есть числа, и несколько
  карточек для терминов. Вопросы ложатся рядом с заметкой, в папку `.challenge`, одним этапом.
  Дальше они возвращаются по расписанию, см. [Тренировать](https://skillok.org/docs/ru/learning/training).
* «Сделай челлендж из `notes/git.md`» — 4–7 этапов: вводный этап с теорией, задания руками —
  конспект, разбор, расчёт, таблица, план или код на Python с тестами — и вопросы на понимание в
  конце. Дальше — как с любым челленджем, см. [Челленджи](https://skillok.org/docs/ru/learning/challenges).

Путь можно не знать: агент сам найдёт заметку по описанию. Так же работает внешний агент по
[MCP](https://skillok.org/docs/ru/account/mcp).

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

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

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

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

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

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

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

* почта не подтверждена;
* лимит модели SKILLOK по тарифу израсходован — выбери другую модель или подожди, см.
  [Лимит SKILLOK](https://skillok.org/docs/ru/account/ai-keys#лимит-skillok);
* уже идёт слишком много задач — дождись, пока они завершатся;
* рядом с заметкой уже есть папка `.challenge` — открой её или удали, чтобы собрать заново;
* материала слишком мало — даже вместе с заметками по ссылкам;
* в репозитории выключены «Учиться» или ИИ, или агенту разрешено меньше, чем всё.

## Где файлы

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

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

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

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

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

## Править

Это обычные файлы твоего репозитория: вопрос можно переписать, этап — удалить или добавить,
проверку — поменять. Формат — в [Формат челленджа](https://skillok.org/docs/ru/learning/challenge-format). У каждого вопроса в
заголовке стоит id в фигурных скобках — по нему живёт расписание повторений, поэтому текст
вопроса править можно, а id лучше не трогать.

Что видно о прохождении — в [Прогресс](https://skillok.org/docs/ru/learning/progress-and-achievements).

---

https://skillok.org/docs/ru/learning/from-a-note