code-reviewer

Code Reviewer — официальный навык Gemini CLI для последовательного анализа изменений в коде. Его назначение — помочь провести ревью локального состояния проекта или удалённого pull request по понятной схеме, а затем выдать замечания, которые можно проверить и расставить по приоритету. Источник прямо разделяет два режима работы. Удалённый режим выбирают, когда задан номер или URL pull request: сначала определяется целевой PR, затем его можно получить через GitHub CLI командой gh pr checkout, выполнить стандартную предварительную проверку npm run preflight и прочитать описание PR вместе с существующими комментариями. Это даёт ревьюеру контекст цели, историю обсуждения и результаты автоматических проверок до детального чтения diff. Локальный режим применяется, если конкретный PR не задан или нужно проверить текущие изменения пользователя. В этом случае навык предлагает начать с git status, а затем отдельно посмотреть рабочий diff и staged diff, чтобы не потерять различие между уже подготовленными и ещё неиндексированными изменениями. Для крупных локальных изменений предварительный npm run preflight указан как необязательный шаг: перед его запуском следует уточнить у пользователя, нужен ли такой прогон. Основной анализ строится вокруг нескольких независимых вопросов. Сначала проверяется корректность: действительно ли изменение выполняет заявленную задачу и нет ли логических ошибок. Затем оценивается поддерживаемость — насколько решение остаётся понятным и пригодным для дальнейшего изменения. Отдельно рассматривается читаемость, включая уместность комментариев и единообразие стиля проекта. Проверка эффективности ищет очевидные узкие места и лишние расходы ресурсов, появившиеся вместе с изменением. В контур анализа также входит безопасность: нужно отметить потенциальные уязвимости и небезопасные практики, если они следуют из diff. Для граничных случаев и обработки ошибок проверяется поведение при неожиданных входных данных, отказах и других неблагоприятных состояниях. Наконец, оценивается тестируемость: даже успешное прохождение preflight не заменяет предложения по тестам, которые могут закрыть важные непроверенные ветви. Результат ревью должен быть конкретным и удобным для действия. В разделе Summary фиксируется общий вывод о проверенных изменениях. В Findings замечания разделяются на Critical для ошибок, проблем безопасности и ломающих изменений, Improvements для улучшений качества или производительности и, при необходимости, Nitpicks для мелких вопросов форматирования. Для каждого замечания важно объяснить причину и ожидаемое влияние, сохраняя конструктивный профессиональный тон. В заключении навык предлагает ясную рекомендацию Approved или Request Changes, чтобы автор понимал состояние ревью без расшифровки разрозненных комментариев. Если проверялся удалённый PR, после завершения анализа навык отдельно предлагает спросить пользователя, нужно ли вернуться на исходную ветку, а не менять состояние репозитория молча. Поэтому карточка описывает не универсальную оценку качества проекта и не security-аудит, а воспроизводимый процесс ревью конкретного diff или pull request с подготовкой, проверкой рисков, структурой замечаний и аккуратным завершением.