Code Review Skills
Скилл evidence-code-review для Codex и Claude Code: ревью изменений по доказательствам, с уровнями MUST, SHOULD, BETTER и NITS
- 89 ★ репозитория
- Последний коммит
Минимальный доступ
Почему такой уровень
- Скилл читает репозиторий и пишет текст замечаний, при этом файлы остаются нетронутыми, а права агента прежними.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/code-review-skillsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Скилл читает репозиторий и пишет текст замечаний, при этом файлы остаются нетронутыми, а права агента прежними.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл `evidence-code-review` проводит ревью изменений как цепочку доказательств. Агент сначала определяет границы задачи и правила репозитория, затем прослеживает измененное поведение по всем затронутым путям кода, включая те, где строки не менялись. Проверки охватывают корректность, интерфейсы, дизайн, безопасность, надежность, тесты и документацию, глубина зависит от масштаба изменения. Каждое замечание начинается с уровня и точки зрения. `MUST` означает доказанную проблему, которую нужно исправить до слияния, `SHOULD` обозначает конкретную угрозу, `BETTER` дает необязательную альтернативу, `NITS` отмечает мелочь. Точка зрения вроде `Functionality`, `Test`, `Simplicity` или `Document` объясняет суть. Автор опирается на идеи японской книги о ревью кода и адаптирует их независимо. Файлы проект не меняет, пока вы не попросите отдельно.
Для кого. Разработчикам и тимлидам, которые отдают первый проход ревью ветки Codex или Claude Code и хотят замечаний с местом в коде и доказательством.
Подходит, если
- Ветка готова к слиянию, и нужен первый проход ревью с указанием файла и строки у каждой находки
- Изменение затрагивает контракты между модулями, и важно проследить влияние за пределами измененных строк
- Команда договаривается о едином формате замечаний с уровнями важности и точками зрения
- Перед сдачей проверяют тесты и документацию к изменению вместе с кодом
Не подходит, если
- Нужна автоматическая правка найденных проблем: скилл по умолчанию ничего не меняет
- Нужна гарантия, что найдены все дефекты: автор прямо предупреждает, что ее нет
- Репозиторий без правил и тестов, а ревью требуется без участия человека
Пример запроса к агенту
/evidence-code-review Проверь изменения этой ветки относительно main: корректность, регрессии и тесты. Файлы не меняй.Ограничения
Результат зависит от модели, версии агента, доступных инструментов, объема ревью и сведений о проекте. Сильная модель помогает, но полноту проверки гарантировать не может. Скилл работает вместе с тестами и ревью человеком. Правила проекта лучше записать в `AGENTS.md` или `CLAUDE.md` репозитория, потому что установленный пакет при обновлении перезаписывается. Большие изменения расходуют много токенов. Скилл не выдает агенту новых прав: доступ к файлам задают настройки хозяина.
Как отключить. Удалите папку `evidence-code-review` из `~/.codex/skills` или `~/.claude/skills`. Подробности удаления есть в `docs/INSTALLATION.md`.
Частые вопросы
Как установить скилл в Claude Code?
Выполните `git clone --depth 1 --branch v1.0.0 https://github.com/akkie76/code-review-skills.git`, затем `mkdir -p ~/.claude/skills` и `cp -R dist/claude-code/evidence-code-review ~/.claude/skills/`. Запустите новую сессию.
Что означают MUST, SHOULD, BETTER и NITS?
`MUST` обозначает доказанную проблему, которую решают до слияния. `SHOULD` отмечает конкретную угрозу, ее можно отложить явным решением. `BETTER` дает необязательную альтернативу с понятной выгодой. `NITS` помечает мелкую правку без блокировки.
Правит ли скилл код во время ревью?
Нет, ревью идет без изменения файлов, пока вы не попросите править отдельно. В примере запроса из README есть фраза «Do not modify files».
Где хранить правила проекта?
В `AGENTS.md`, `CLAUDE.md` или документе, на который они ссылаются: версии, правила жизненного цикла и потоков, архитектурные соглашения, команды проверки. В установленный пакет их класть нельзя.
Чем он отличается от code-review-skill?
Этот скилл строит замечания по схеме «уровень, точка зрения, место, доказательство» и закреплен за релизом с описанным форматом вывода.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыДва навыка для Codex и Claude Code: аудит репозитория без записи и цикл экспериментов с базовыми замерами.
Одиннадцать навыков проверки кода после ИИ: радиус изменений, дефекты, ревью-отчет, тест-кейсы и повтор сценария в браузере
Скилл, который один раз читает репозиторий и ставит проверки: правила кода становятся шлюзами, которые ломают коммит или CI.
Команда /pr-review гонит pull request через пять независимых проверяющих, сверяет находки и собирает один отчет.
CLI и MCP для проверки скиллов: повторяемые тесты на YAML, сравнение отчетов, поиск регрессий и процесс skilled-improve
Скилл состязательного аудита кода: Hunter ищет ошибки, Skeptic их оспаривает, Referee выносит вердикт, а правки без вашего разрешения не вносятся
Коротко о README
В README разобраны установка по тегу релиза для Codex и Claude Code, формат замечаний с уровнями, хранение контекста проекта и ограничения. Оценка в репозитории построена на небольшой синтетической выборке.