jev-lint — плагин
jev-lint ищет то, что пропускают линтеры: имена, комментарии и тесты, расходящиеся с кодом. Вердикт выносит модель.
- 131 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Исходный код проверяемых файлов отправляется во внешний API платного сервиса.
- Хуки pre-commit и pre-push запускаются при каждом коммите и пуше.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/jev-lintОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Исходный код проверяемых файлов отправляется во внешний API платного сервиса.
- Хуки pre-commit и pre-push запускаются при каждом коммите и пуше.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
`jev-lint` выбирает код через матчеры ast-grep и задает модели вопрос из одной фразы, например: комментарий над функцией утверждает то, чего код не делает. Модель отвечает вероятностью, а выше порога правила находка попадает в отчет. В комплекте 99 правил: имя против реализации, комментарий против тела функции, тест против заявленного поведения, молчаливо проглоченная ошибка, поведение shell-скрипта, качество Markdown и сообщение коммита против диффа. Плагин для Claude Code добавляет команды `/jev-lint:review`, `/jev-lint:commits`, `/jev-lint:prose` и `/jev-lint:new-rule`.
Для кого. Командам, где агенты пишут много кода, комментариев и тестов, а ревьюеру не хватает времени сверять их с реализацией.
Подходит, если
- Агент переписал функцию, а комментарий над ней остался прежним.
- В PR есть тест, который проходит и при сломанном заявленном поведении.
- Сообщение коммита обещает одно, а дифф делает другое.
- Свое правило проверки хочется описать одной фразой, не пиша плагин для ESLint.
Не подходит, если
- Нужно то, что уже решает компилятор, проверка типов или ESLint.
- Код нельзя отправлять во внешний API.
- Результат хотят использовать как строгий детерминированный гейт.
Пример запроса к агенту
Проверь изменения текущей ветки командой `/jev-lint:review` и разбери каждую находку по коду: какие реальны, какие ложные.Ограничения
Проверенный код уходит в API Typesafe, ключ задают переменной `TYPESAFE_API_KEY`, запросы платные. Режим `--dry-run` оценивает стоимость без запросов. Автор сообщает, что примерно одна находка из пяти ошибочна, а оценка у порога меняется между запусками, поэтому читайте находку как кандидата для человека. Нужны Node 24 или новее и `npx`. Правила точнее всего откалиброваны для TypeScript и Rust, остальные языки подтянуты к той же планке, но не обещаны. Результат нестрогий: один и тот же код может дать немного разные оценки, а вердикты кешируются по содержимому правила и кода.
Как отключить. Удалите плагин командой `/plugin` или пакет из devDependencies, уберите `.jev-lint.yaml` и хуки, созданные через `jev-lint init --pre-commit` и `--pre-push`.
Частые вопросы
Как проверить правила без ключа и затрат?
`npx jev-lint check src --dry-run` показывает, какие вопросы будут заданы и сколько это стоит. Команда `jev-lint rules` выводит список правил, а CI может читать готовый кеш без ключа.
Откуда берется ключ?
Из переменной окружения `TYPESAFE_API_KEY` или `TYPESAFEAI_API_KEY`. В конфиг ключ не кладут: файл `.jev-lint.yaml` хранится в репозитории.
Как подключить проверку в CI?
Команда `review --base "$GITHUB_BASE_REF" --format github` оставляет аннотации в pull request. Хуки создают `jev-lint init --pre-commit` и `--pre-push`, но блокировать коммит они начинают только после `severity: error`.
Как написать свое правило?
Опишите матчер ast-grep и поле `ask` с одной фразой, например про проглоченную ошибку в блоке `catch`. Руководство лежит в `docs/writing-rules.md`.
Чем плагин отличается от скилла?
Скилл `jev-lint` объясняет агенту запуск и написание правил, плагин для Claude Code дополнительно ставит четыре команды. Скилл `jev-lint-repo` относится к разработке самого инструмента.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныПроверяет diff и переписку с агентом: ловит ошибки в коде и расхождения между вашей просьбой и тем, что агент сделал. CLI, скилл и GitHub Action
Статический линтер инструкций агента: находит двусмысленные описания инструментов и пробелы в схемах до запуска, без модели и сети
Плагин Claude Code заставляет агента проверять код вокруг правки и доказывать работу тестом и независимым ревью до слова «готово»
Проверка кода, сгенерированного ИИ: пустые функции, несуществующие импорты и документация, которая преувеличивает.
Плагины для Claude Code: визуальная регрессия по Figma, ревью тестов и кода, заметки проекта и разбор сессий в HTML-отчет
Скилл evidence-code-review для Codex и Claude Code: ревью изменений по доказательствам, с уровнями MUST, SHOULD, BETTER и NITS
Коротко о README
README объясняет идею, перечисляет типы проверок и прямо описывает слабые места: недетерминированность и долю ложных находок. Есть отдельные руководства по стоимости, хукам и написанию правил.