JSON Contract Check — проверка API-фикстур
Локальная проверка JSON по явному контракту: обязательные поля, типы, enum, границы и вложенные массивы. Python-скрипт с отчётом по JSON Pointer и 33 проверенными сценариями.
Оригинальный AI-assisted комплект для разработчиков, которым нужно проверить JSON-фикстуру перед импортом, демонстрацией API или изменением интеграции. Skill помогает отделить реальные нарушения согласованного контракта от догадок о требованиях.
В поставке полноценный SKILL.md, два Python-скрипта, описание небольшого формата контракта, корректная и ошибочная фикстуры, русский порядок установки и полная MIT License. Проверяющий скрипт поддерживает объекты, массивы, строки, целые и дробные числа, boolean/null, обязательные и дополнительные поля, enum и границы. Boolean не принимается за integer; отсутствие поля отличается от null. Отчёт содержит JSON Pointer и код нарушения без значений полей.
Это собственный ограниченный формат, не реализация JSON Schema/OpenAPI. Неизвестные ключи и повреждённые JSON, включая дубли ключей и NaN/Infinity, не проходят молча. Лимиты: 10 МиБ на файл, глубина 64, 100000 узлов и 100 находок; неполная проверка имеет отдельный exit 2 и не выдаётся за успех. Бизнес-правила, email/даты, денежная точность и реальный сервер автоматически не проверяются.
Нужен Python 3.9+, сторонних пакетов, API-ключей и сети нет. Проверяющий скрипт только читает файлы. Отдельный self_test создаёт и удаляет свою папку с вымышленными примерами внутри комплекта. Пройдено 33 синтетических проверки скрипта, исходные фикстуры и контракты не изменились. Структура skill проверена штатным валидатором; модельные прогоны в Codex не выполнялись.
700 Vibe — за готовый комплект с проверенным скриптом, примерами и документацией; AI-модель или подписка Codex не включены. Материал подготовлен для Vibeus, версия 1.0.0. MIT допускает личное и коммерческое использование и распространение с сохранением лицензии. Эксклюзивность идеи и гарантированная пригодность для вашего API не заявляются.
json-contract-check/SKILL.md — инструкции агента
scripts/check_json.py — локальный проверяющий скрипт
scripts/self_test.py — 33 воспроизводимые проверки
references/contract.md — полный формат и ограничения
examples/ — контракт и две вымышленные фикстуры
README-RU.md, VALIDATION.json, SOURCE.json, LICENSE
Распакуйте папку json-contract-check и подключите её в поддерживаемом вашей средой каталоге skills, например ~/.codex/skills/. Нужен Python 3.9+. Для самостоятельного запуска из папки комплекта: python scripts/check_json.py examples/valid.json --contract examples/contract.json. Перед проверкой своих данных согласуйте контракт по references/contract.md. Exit 0 — полная проверка пройдена, 1 — нарушения, 2 — проверка не завершена. Подробности и повторение 33 проверок — README-RU.md.
MIT License. Copyright (c) 2026 Vibeus. Разрешены личное и коммерческое использование, копирование, изменение и распространение с сохранением copyright и полного текста MIT из LICENSE. Неэксклюзивно, AS IS, без гарантий. Цена — за готовую поставку; подписка AI-модели/Codex и внешние API не входят.