Курс как код

Курс можно править на экранах платформы, а можно держать в репозитории рядом с материалами и присылать документом. Тогда история изменений, ревью и ваш агент работают как с обычным кодом.

Откуда берётся содержание

Блок «Откуда берётся содержание» на экране курса. Три способа:

• «Правлю здесь» — курс правится только на платформе. Так курс заводится по умолчанию.
• «Подтягиваю с адреса» — сайт курса отдаёт документ курса. Платформа читает его по кнопке «Подтянуть сейчас».
• «Присылаю из репозитория» — документ присылает CLI или ваш агент.

Способы совместимы: правка на платформе сильнее подтяжки. Строку, поправленную на экранах, источник молча не перезапишет — она помечается «правлено здесь».

Документ курса

Документ — JSON с ролями и работами. Можно прислать часть: чего нет в документе, то не меняется.

{
  "roles": [{ "key": "product", "title": "Продукт" }],
  "works": [
    {
      "number": 1,
      "title": "Бриф продукта",
      "points": 10,
      "criteria": [
        {
          "key": "metric",
          "text": "Описана метрика успеха и способ её подсчёта",
          "role": "product",
          "check": {
            "type": "llm",
            "find": "метрика успеха",
            "good": "измерима, указан способ подсчёта",
            "bad": "общие слова"
          },
          "ask": "Почему эта метрика?",
          "expect": "Связь метрики с задачей пользователя"
        }
      ]
    }
  ]
}

Работы сверяются по номеру, роли и критерии — по ключу. Поля — те же, что в карточке работы. Шаги пишутся только здесь. Полное описание полей — схема courseDocument в описании API.

Прислать документ

Из терминала — CLI disputa:

disputa content courses                                  # курсы, которые вы правите
disputa content submit <courseId> --data @course.json    # прислать документ
disputa content check <courseId>                         # что мешает опубликовать
disputa content publish <courseId>                       # опубликовать версию

Своему агенту — попросите его прислать курс из репозитория: после disputa skills add он знает эти команды.

Вставкой — «Вставить документ курса ▾» на экране курса и «Разобрать».

Разобрать пришедшее

Пришедший документ курс не меняет. На экране курса появится плашка «Пришла подтяжка — курс не изменится, пока вы её не разберёте», у организатора — строка в «Решениях».

«Посмотреть, что изменилось» открывает разбор:

• Изменилось в источнике — у каждой строки видно, какие поля поменялись;
• Новое;
• Задевает вашу правку — строка, которую вы правили на платформе. Хотите, чтобы она снова бралась из источника, — «Отказаться от правки»;
• Исчезло из источника — остаётся в курсе; убрать можно в карточке работы.

Отметьте нужные строки и нажмите «Применить выбранное» или «Применить всё». Применённое попадает в черновик версии — дальше публикация как обычно.

Откатить последнее применение можно в течение суток и до публикации — кнопкой в плашке «Применено строк: N».