Построчная проверка изменений ИИ
Проверка diff, отправка комментариев агенту и повторная оценка исправлений.
Перед отправкой ветки прочитайте весь diff, проверьте спорные строки и верните замечания агенту. Для этого подходит следующий рабочий цикл.
Перед началом
Убедитесь, что агент завершил изменение и рабочее дерево не содержит неожиданных файлов с секретами, сборочными артефактами или локальными настройками. Заранее найдите в репозитории команды тестов, проверки типов и линтера.
Порядок действий
- Откройте просмотр diff текущего worktree.
- Переходите между файлами клавишами
jиk. Для каждого фрагмента проверьте, нужно ли это изменение, минимально ли оно и соответствует ли остальному файлу. - Нажмите
cи оставьте комментарии ко всему, что следует исправить. Лучше писать полными предложениями. - После проверки всего diff нажмите Отправить агенту. Orca объединит комментарии в один запрос.
- Следите за исправлениями. Индикатор агента станет жёлтым при ожидании ввода или зелёным во время работы.
- Когда агент перейдёт в состояние ожидания, снова откройте diff. Комментарии останутся привязанными к строкам. Закройте исправленные замечания и добавьте уточнения к остальным.
- Повторяйте проверку до готовности изменений, затем создайте коммит.
Проверка результата
Перед отправкой ветки выполните проверки проекта и просмотрите итоговый diff без фильтров. Убедитесь, что комментарии закрыты не формально, а соответствующим изменением кода. Если агент расширил область задачи, вынесите лишнее в отдельный worktree или верните его на доработку.
После проверки создайте коммит и отправьте ветку. Происхождение строк показывают индикаторы авторства.
Частые вопросы
С чего начать проверку diff агента?
Сначала прочитайте список изменённых файлов, затем изучите каждое изменение и сопоставьте его с исходной задачей.
Как отправить агенту несколько замечаний?
Добавьте построчные комментарии к нужным местам и отправьте их одним пакетом с общей просьбой исправить.
Нужно ли проверять повторный ответ агента?
Да. После исправления заново просмотрите diff, потому что агент мог изменить соседний код или неправильно понять замечание.
Какие проверки запустить перед принятием?
Выполните тесты, проверку типов, линтер и ручной сценарий, который соответствует внесённому изменению.
Когда изменение можно коммитить?
Только после того, как diff понятен, замечания закрыты, проверки проходят и в ветке нет случайных файлов.