VibeusLoadingЗагрузка
Vibeus

Loading is taking longer than usual.Загрузка занимает больше времени, чем обычно.

The full page couldn't load.Не удалось полностью загрузить страницу.

You can read the available content below or try loading the page again.Вы можете читать доступный контент ниже или повторить загрузку страницы.

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 не входят.