Code Review Bot FAQ

1. Как зарегистрироваться

Откройте личный чат с ботом в Compass (не групповой чат).
Отправьте команду регистрации с GitLab-данными.
При необходимости привяжите свой Compass mention.
Проверьте профиль через команду настроек.

Обезличенный пример (вместо реальных данных):

Шаг 1: регистрация

/link_gitlab 123456 ivanov_ii

Шаг 2: привязка mention

/set_compass @Иванов Иван

2. Где взять креды

GitLab ID: откройте профиль GitLab, раздел профиля/настроек аккаунта. Это числовой ID пользователя.
GitLab username: ваш логин в GitLab (например, ivanov_ii), обычно виден в URL профиля.
Compass ID: это ID вашего пользователя в Compass, его обычно передает сама платформа в событиях бота. Для команд чаще нужен не ID, а mention через @....

3. Команды в личке (DM)

Профиль и регистрация

/settings
/link_gitlab 123456 ivanov_ii
/set_compass @Иванов Иван
/unregister

Время и доступность

/set_timezone +02
/set_hours 11:00-19:00
/set_quiet_hours 22:00-08:00
/snooze 2h
/snooze off

Выходные и отпуск

/add_dayoff 01.05.2026
/add_vacation 10.06.2026-20.06.2026

Справка

/help
/feedback

4. Команды в групповом чате

Основная команда для назначения ревью:

Назначение ревьюеров

/cra https://gitlab.example.com/team/project/-/merge_requests/42 @Иванов Иван @Петров Петр

После полного ревью бот сам уведомит автора MR. Отдельная команда /cra link для этого не нужна.

Действие после ревью

/cra MR_URL @Reviewers --force
/cra MR_URL @Reviewers --no-auto

--force выбирает ready-лейбл и настроенный Jira-flow. --no-auto отключает только действие после ревью, но не уведомления ревьюеров.

Обязательное финальное ревью

/cra MR_URL @Reviewers --required @Final
/cra MR_URL @Reviewers -r @Final
/cra MR_URL @Reviewers --lead

--required/-r назначает указанного финального ревьюера. Bare --lead выбирает лида команды инициатора из Admin -> Review Teams.

Когда откроется финальный этап

Если обычный ревьюер один, достаточно его аппрува. Если их два или больше, достаточно любых двух. После этого все обязательные финальные ревьюеры должны поставить аппрув.

Алиасы

/cr_assign https://gitlab.example.com/team/project/-/merge_requests/42 @Иванов Иван
/cr help

Обратная связь

/feedback

Если в имени есть пробел, используйте mention целиком: @Иванов Иван. Для нескольких людей просто указывайте несколько mention подряд. Старый вариант --lead @User пока работает, но его нужно заменить на --required @User или -r @User.

5. Частые ошибки

Команда не распознается: проверьте формат и что вы в правильном чате (DM или группа).
Ошибка регистрации: проверьте, что GitLab ID числовой, а username указан без лишних символов.
Не назначаются ревьюеры: проверьте доступность GitLab-интеграции и корректность упоминаний.

FAQ: как начать работу с Code Review Bot