VibeusL10n Token Guard — подстановки в переводах
Бесплатный skill и локальный Python-чекер для JSON-переводов: потерянные ключи, имена и число подстановок, порядок printf. 16 проверок, примеры и MIT; сложный ICU требует ручного разбора.
Оригинальный AI-assisted skill для проверки JSON-словарей локализации. Сравнивает отсутствующие и дополнительные ключи, имена и число вхождений {name}/{{name}}, последовательность простых printf %s/%d/%f и индекс/тип позиционных %1$s. Перестановка именованных и позиционных токенов допустима; изменение повторов, вида скобок или порядка обычного printf отражается в отчёте.
В архиве полноценный SKILL.md, локальный scripts/check_tokens.py, четыре JSON-примера, русская инструкция и справочник ожидаемых результатов. Вложенные ключи выводятся по JSON Pointer; одинаково написанные a/b и вложенный a → b различаются. Дубли JSON-ключей и нестроковые листья отклоняются. Скрипт читает два выбранных файла, ничего не изменяет и не использует сеть.
Нужен Python 3.9+ со стандартной библиотекой. Коды 0/1/2 различают совпадение поддерживаемого синтаксиса, расхождения и необходимость ручного разбора. ICU plural/select, сложный printf, экранирование конкретного фреймворка, качество перевода, HTML и работа интерфейса не проверяются. Неизвестные скобки/проценты и смешанный printf консервативно отмечаются для ручной проверки; одиночный буквальный % также требует разбора. Пустые объекты не участвуют в сравнении строк.
Локально прошли 16 проверок, включая реальные CLI-запуски с кодами 0, 1 и 2; список и версия Python сохранены в VALIDATION.json. Структура skill проверена локальным валидатором. Прогоны внешней моделью и интеграция в IDE не проводились. Если используете платного агента или модель, их подписка/API оплачиваются отдельно; самому скрипту внешние API не нужны.
Полный MIT License, сведения о происхождении, версия 1.0.0 и SHA-256 файлов включены. Материал создан для Vibeus с помощью AI; чужих платных файлов и обязательных загрузок зависимостей нет.
SKILL.md — назначение, порядок проверки и границы
scripts/check_tokens.py — локальный read-only Python-чекер
examples/en.json и ru-good.json — допустимый перевод с перестановками
examples/ru-broken.json — четыре вида регрессий и ключи
examples/icu.json — обязательный ручной разбор ICU
references/examples.md — команды и ожидаемые результаты
README-RU.md — установка, зависимости и ограничения
VALIDATION.json — 16 локальных проверок и версия Python
LICENSE — полный MIT License
SOURCE.json — происхождение, версия и SHA-256
1. Распакуйте ZIP: внутри папка l10n-token-guard.
2. Поместите её в каталог skills совместимого агента либо откройте SKILL.md как инструкцию; автоматической установки нет.
3. Для отдельной проверки нужен Python 3.9+. Из этой папки запустите: python scripts/check_tokens.py examples/en.json examples/ru-good.json
4. Затем укажите пути к своим исходному и переведённому JSON. Скрипт только читает эти файлы и выводит JSON в stdout.
5. Код 0 означает совпадение поддерживаемого синтаксиса; 1 — расхождения; 2 — ошибка входа или ручной разбор. Примеры и ограничения в references/examples.md.
6. Не считайте чистый отчёт проверкой грамматики, ICU или работы приложения. Перед любыми правками согласуйте политику лишних ключей и точную систему подстановок.
MIT License. Разрешены личное и коммерческое использование, изменение, копирование и распространение материалов при сохранении уведомления об авторстве и полного текста MIT License из LICENSE в архиве. Предоставляется как есть, без гарантий. Оригинальный AI-assisted материал для Vibeus.