Как находить устаревшие рецепты

О чём урок

Сканирует файлы cookbooks Mistral AI на предмет устаревшего содержимого — устаревших моделей, старых импортов SDK и изменённых методов API — и выводит приоритизированный список проблем со ссылками на источники.

Запускается, когда пользователь просит:

• Проверить, какие cookbooks устарели
• Найти cookbooks, использующие устаревшие модели, старые импорты SDK или старые методы API
• Провести аудит директории mistral/ перед релизом
• Запустить проверку на устаревшие данные локально перед открытием PR с исправлениями

Установите ваш API key Mistral для анализа с помощью LLM (необязательно, но рекомендуется):

Сканировать все cookbooks с анализом LLM (рекомендуется):

Сканировать один файл:

Режим только по шаблонам (без сетевых вызовов, API key не требуется):

Записать JSON-отчёт для дальнейшей обработки:

Получает актуальный список моделей из /v1/models и помечает любой ID модели Mistral, используемый в вызове API (model="..."), который отсутствует в этом списке, как unknown_model.

Отправляет содержимое кода каждого файла и выдержки из полученных справочных документов в mistral-medium-latest для более глубокого семантического анализа. Обнаруживает проблемы, которые пропускает сопоставление по шаблонам: переименованные параметры, изменённые структуры ответов, удалённые функции, устаревшие лучшие практики.

LLM явно проинструктирован:

• Методы с суффиксом _async (create_async, list_async, start_async и т.д.) являются действительными — никогда не помечайте их
• API для задач fine-tuning (client.fine_tuning) устарел
• Каждая помеченная проблема должна включать поле quote с текстом из источника, подтверждающим устаревание

Добавьте # stale-check: ignore в качестве комментария к любой строке исходного кода, чтобы пропустить её:

Это работает в файлах Python, code cells notebook и блоках кода в Markdown.

.github/workflows/check-stale-cookbooks.yml запускает этот скрипт автоматически:

• Еженедельно по понедельникам в 9:00 UTC
• Вручную через workflow_dispatch

Для каждого файла с проблемами создаётся GitHub issue (если такового ещё нет) с меткой stale-cookbook. Когда ранее устаревший файл становится чистым при следующем запуске, action комментирует и закрывает существующий issue.

Требуемый секрет в репозитории: MISTRAL_API_KEY.

• mistralai/platform-docs-public — уведомления об устаревании, документация по fine-tuning, changelogs
• mistralai…

План урока

1. Когда использовать этот навык
2. Предварительные требования
3. Команды
4. Все флаги
5. Коды завершения
6. Что проверяется
7. Статические проверки по шаблонам (выполняются всегда)
8. Динамическая проверка моделей (требует сеть, пропускается с --no-fetch)