О чём урок
Проведите рецензирование файла Cookbook Mistral AI на предмет качества содержимого, структурной полноты и стиля изложения. Составьте приоритизированный список проблем и предлагаемых решений.
Запускайте, когда пользователь просит:
- Рецензировать, проводить аудит или вычитывать файл Cookbook
- Проверить, соответствует ли Cookbook стандартному формату
- Получить обратную связь по черновику Cookbook
- Проверить Cookbook перед слиянием
- Полностью прочитайте целевой файл с помощью инструмента Read.
- Оцените его по контрольному списку структуры и контрольному списку стиля изложения ниже.
- Выдайте структурированную рецензию в формате, указанном в конце этого документа.
Каждый файл Cookbook должен включать эти разделы в следующем порядке:
Заголовки шагов имеют уровень H2 и могут быть нумерованными или ненумерованными — обе формы приемлемы:
- ## 1. Create the connector
- ## Create the connector
Каждый раздел шага должен начинаться как минимум с одного предложения перед любым блоком кода, таблицей или списком (см. стандарт содержимого раздела ниже).
Раздел ## Prerequisites должен содержать только предложение "Для выполнения этого Cookbook вам потребуется:", за которым следует маркированный список. Элементы списка должны располагаться в следующем порядке:
- Среда выполнения языка и инструментарий (например, "Python 3.9 или новее", "Node.js и менеджер пакетов")
- Учетная запись Mistral и API key (почти всегда требуются)
- Любые другие учетные записи, токены или внешние сервисы, которые могут потребоваться
Отметьте как Критическое, если ## Prerequisites содержит инструкции по установке, настройке переменных среды или блоки кода — они должны находиться в ## Environment setup.
Раздел ## Environment setup содержит все, что необходимо читателю для запуска кода: установка пакетов, настройка API key и (для автономных скриптов) команда запуска. Точные формулировки см. в стандарте настройки API key ниже.
Раздел ## Summary должен быть последним разделом в файле — за ним не может следовать никакого содержимого, заголовков или разделов. Он должен содержать:
- Обзор в 1–2 предложениях того, что было рассмотрено в Cookbook и что было создано или продемонстрировано.
- Что вы создали (или Что охватывает этот Cookbook) — маркированный список.
- Используемые функции Mistral — маркированный список API, продуктов и…
План урока
- Когда использовать этот навык
- Как провести рецензирование
- Шаблон структуры Cookbook
- Обязательные разделы (должны присутствовать)
- Необязательные разделы (включайте при необходимости)
- Стандарт содержимого раздела
- Стандарт настройки API key
- Получение ключа
Урок входит в полный доступ. Полный текст и видео открываются после оплаты. Первые уроки каждого курса бесплатны.