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

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

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

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

Список changAIs Review с несколькими измененными файлами и счетчиками ревью

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

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

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

Diff view

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

Side-by-side diff changAIs для reportSummary.js с подсвеченными изменениями

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

AI-заметки

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

AI-заметка рядом с конкретным измененным кодом

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

Ответы

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

Контролы ответа на AI-заметку с категориями, текстовым полем и кнопкой отправки

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 свежими заметками.

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

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

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

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

Прогресс ревью changAIs с checked заметкой и обновленными счетчиками

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

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