Управление конфигурацией: JSONSchema, Pydantic и YAML

engineering

config-skills — это скилл для Claude Code, который описывает паттерны и практики работы с конфигурационным модулем проекта LlamaFarm. Скилл охватывает полный цикл: от написания JSONSchema с `$ref`-ссылками в `schema.yaml` до дереференсирования через `jsonref`, кодогенерации Pydantic v2-моделей утилитой `datamodel-codegen` и кастомной валидации кросс-полевых ограничений в `validators.py`. Для чтения и записи YAML-файлов с сохранением пользовательских комментариев используется `ruamel.yaml`. Модуль включает семь ключевых файлов — `datamodel.py`, `schema.yaml`, `compile_schema.py`, `generate_types.py`, `validators.py`, `helpers/loader.py` и `helpers/generator.py` — и поддерживает форматы YAML, TOML и JSON. Скилл рассчитан на разработчиков, которым нужно выстроить надёжный pipeline конфигурации с валидацией схемы и автогенерацией типов на Python 3.11+.