Заметки ревью

Заметки ревью — основа changAIs. Они дают сфокусированный способ понять, что изменил AI и почему это может быть важно.

Измененные файлы

Начните со списка измененных файлов. Откройте каждый файл и сравните состояние до и после в diff view.

Файлы с заметками для ревью показываются первыми. Переключайтесь кнопками «назад/вперёд»; счётчики показывают прогресс выбранного файла и всего отчёта.

На этом шаге ответьте на базовые вопросы:

• Какой файл изменился?
• На какое поведение может повлиять изменение?
• Достаточно ли данных, чтобы понять изменение?
• Нужны ли тесты или ручная проверка?

Рекомендация: всегда проверяйте вручную результат и доверяйте только тестам созданным вручную или тестам, которые понимаете полностью.

Diff view

Diff view показывает предыдущую и текущую версии файла. Читайте окружающий контекст, а не только подсвеченные строки.

Переключение split/unified и hunks/full-file не скрывает текущий diff. При обновлении и смене вида показывается неблокирующая полоса прогресса; если выбранный файл не менялся, положение прокрутки сохраняется.

AI-сгенерированный код может выглядеть убедительно, но все равно пропускать edge cases, обработку ошибок или соглашения проекта.

AI-заметки

AI-заметки закреплены на измененных файлах или строках, которые они описывают. Заметка может объяснять намерение, отмечать риск, предлагать follow-up или фиксировать решение, принятое во время генерации.

Считайте заметки подсказками для ревью. Они не являются гарантиями.

Ответы

Используйте ответы, чтобы сохранять собственные решения ревью или follow-up вопросы. Ответ полезен, когда нужно помнить, почему заметка принята, отклонена или отложена.

Prepare AI Follow-up Prompt

После добавления ответов можно подготовить prompt для AI-ассистента.

Используйте Prepare AI Prompt в панели ревью или выполните changAIs: Prepare AI Follow-up Prompt из Command Palette. changAIs создает .changais/prompt.md на основе текущего отчета и ответов.

Передайте этот файл AI-ассистенту и попросите обработать feedback. После изменений AI должен обновить .changais/report.json свежими заметками.

Спросить AI внутри ревью (Pro)

Нажмите Ask AI, введите вопрос, выберите доступный установленный CLI и читайте ответ, не выходя из changAIs. Поддерживаются Codex, Claude Code, Gemini CLI, OpenCode, Aider и Qwen Code. Для OpenCode есть поиск по доступным моделям; для OpenCode и Aider можно указать модель вручную или оставить поле пустым для модели по умолчанию. В списке показываются только обнаруженные CLI; выбранный инструмент должен быть установлен и авторизован.

Вместе с вопросом выбранный CLI получает заметки, ответы и diff выбранного файла. Панель показывает ответ или ошибку. Кнопка Cancel останавливает запрос; закрытие панели также отменяет выполняющийся запрос. Ask AI предназначен только для ответа и не должен менять код или отчёты. CLI может передать этот контекст настроенному провайдеру и списать оплату по его тарифу. Prepare Prompt остаётся доступным на Free и ничего не отправляет автоматически.

Состояние checked и resolved

Используйте checked или resolved, чтобы отслеживать прогресс ревью:

• Checked означает, что вы посмотрели заметку.
• Resolved означает, что заметка больше не требует действий.

Чтобы отметить все оставшиеся доступные для ревью заметки активного отчёта, нажмите Mark all as reviewed и подтвердите предупреждение. Отчёт и счётчики прогресса обновляются вместе; исключённые из ревью некорректные заметки не затрагиваются. В истории и объединённом виде действие недоступно. При необходимости снимите отметки с отдельных заметок.

Для общего ответа нажмите Batch reply: в режиме выбора рядом с заметками появятся чекбоксы, а панель действий покажет точное количество выбранных. Обычный клик по заметке по-прежнему открывает её карточку. Cancel или повторный клик по Batch reply очищает выбор.

Для рискованных изменений проверяйте поведение тестами или вручную перед тем, как отмечать заметку resolved.

Привычки ревью

• Проверяйте security-sensitive код медленно.
• Смотрите сгенерированные зависимости и изменения конфигурации.
• Убедитесь, что тесты проходят.
• Коммитьте только те изменения, которые понимаете.