Начало работы

Используйте этот процесс, если пробуете changAIs впервые.

1. Установите расширение

Установите changAIs из marketplace вашего редактора:

• VS Code: Visual Studio Marketplace.
• VSCodium и совместимые редакторы: Open VSX Registry.

Если устанавливаете скачанный пакет, установите файл .vsix:

1. Откройте VS Code.
2. Откройте Command Palette: Ctrl+Shift+P в Windows или Linux, Cmd+Shift+P в macOS.
3. Выполните Extensions: Install from VSIX....
4. Выберите скачанный .vsix файл.
5. Перезагрузите VS Code, если редактор попросит.

Подробности установки из marketplace и вручную есть в разделе Установка.

2. Откройте проект

Откройте папку с кодом, который хотите проверить. changAIs лучше всего работает, когда в проекте уже есть измененные файлы после AI-сессии.

3. Проверьте, что changAIs доступен

Откройте Extensions view и убедитесь, что changAIs установлен и включен для текущего workspace.

Если ваша сборка показывает команды в Command Palette, откройте Command Palette и введите changAIs. Точные названия команд зависят от установленной сборки расширения.

4. Загрузите или сгенерируйте отчет

В целом процесс ревью выглядит так:

• Загружается или генерируется отчет в папке .changais.
• Пользователь проверяет измененные файлы просматривая заметки, прикрепленные к измененным строкам.
• Пользователь отвечает на заметки или отмечает их как проверенные/решенные.

changAIs использует файлы отчетов, чтобы связать измененные файлы с AI-заметками. Отчет может быть:

• Создан changAIs-совместимым AI-процессом.
• Выбран вручную как локальный файл отчета.
• Сгенерирован поддерживаемым changAIs-процессом.

Если создаете отчет вручную или из автоматизации, используйте структуру из раздела Формат отчета.

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

5. Проверьте перед коммитом

Пройдите каждый измененный файл, сравните diff и изучите заметки, закрепленные на строках с изменениями. Используйте состояние checked или resolved, чтобы отслеживать уже проверенное.

В конце коммитьте только те изменения, которые понимаете и принимаете.

6. Commit with AI (Pro)

Commit with AI - функция Pro. Используйте ее после того, как проверили измененные файлы, отметили нужные заметки и убедились, что тестов или ручной проверки достаточно для этого изменения.

Чтобы создать коммит с AI-помощью:

1. Настройте поведение AI относительно коммитов в настройках расширения.
2. Откройте проект с уже проверенными изменениями.
3. Откройте отчет, который соответствует текущему состоянию файлов.
4. Отметьте как resolved или checked заметки, которые уже проверили.
5. Откройте Commit with AI в интерфейсе ревью changAIs.
6. Добавьте префикс для коммита. Подсказка: можно также конфигурировать поведение для данного коммита с помощью этого поля.
7. Дождитесь пока AI закончит работу и проверьте созданный коммит.

Commit with AI может подготовить commit message на основе отчета и измененных файлов, но не проверяет корректность кода.

7. Экспортируйте отчет (Pro)

Расширенный экспорт отчетов - функция доступная Pro пользователям. Используется, когда нужна запись о том, что изменилось, какие заметки были проверены и какие решения приняты.

Чтобы экспортировать отчет:

1. Откройте отчет, который хотите экспортировать.
2. Проверьте файлы и обновите состояние заметок, если нужно.
3. Нажмите на Export dropdown и выберите нужный формат: Markdown, JSON, HTML, CSV или PDF.
4. Используйте экспортированный файл. Рекомендуется удалить его из проекта после генерации.

Экспортированные файлы записываются в .changais/exports/ с именами, содержащими дату:

.changais/exports/export-YYYYMMDD-HHmmss-SSS.md
.changais/exports/export-YYYYMMDD-HHmmss-SSS.json
.changais/exports/export-YYYYMMDD-HHmmss-SSS.html
.changais/exports/export-YYYYMMDD-HHmmss-SSS.csv
.changais/exports/export-YYYYMMDD-HHmmss-SSS.pdf

.changais/prompt.md не является export artifact. Это рабочий prompt для случая, когда вы просите AI-ассистента обработать ваши ответы.

Перед отправкой export-файла удалите приватный код и любые другие данные, которые не должны покидать вашу машину.