🎯 О чём этот конспект: Разбор новой функции «Review and Comment» в GitHub Copilot для VS Code. Инструмент позволяет не просто генерировать код, но и проводить его мгновенный аудит на соответствие лучшим практикам, находить скрытые баги (например, отсутствие проверок на пустые значения) и улучшать читаемость через интерактивный интерфейс diff-сравнения.

👤 Кому будет полезно: Разработчикам любого уровня, использующим VS Code и GitHub Copilot, а также вайбкодерам, которым нужно быстро проверить качество сгенерированного нейросетью кода перед деплоем.

✨ Что получите: Вы научитесь запускать автоматический код-ревью для отдельных функций или целых файлов, принимать точечные исправления и внедрять стандарты именования и безопасности в один клик.

1. Генерация базовой логики через комментарии

Контекст: Процесс начинается с классического «steering» (направления) модели. Вместо написания кода вручную, вы формулируете задачу на естественном языке. В примере рассматривается PowerShell, но метод универсален для любого языка программирования (Python, JS, Go). Важно понимать, что первый результат от AI — это «черновик», который может работать, но не учитывать краевые случаи или стандарты оформления кода (style guides).

Выгода: Сокращение времени на написание шаблонного кода и возможность сразу перейти к этапу оптимизации.

Как применить:

• Шаг 1: Формулировка задачи — VS Code — Откройте файл (например, .ps1, .js, .py) и напишите комментарий с описанием функции.
• Шаг 2: Принятие предложения — GitHub Copilot — Дождитесь появления серого текста (ghost text) и нажмите Tab для вставки кода.

# need a function to get largest number in an array
function Get-LargestNumber($numbers) {
    $largest = $numbers[0]
    foreach ($n in $numbers) {
        if ($n -gt $largest) {
            $largest = $n
        }
    }
    return $largest
}

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

2. Запуск функции «Review and Comment»

Контекст: Это ключевой этап трансформации кода. Вместо того чтобы самому искать ошибки, вы вызываете агента Copilot для анализа выделенного фрагмента. Инструмент анализирует контекст и предлагает улучшения по четырем категориям: именование, безопасность (обработка ошибок), производительность и соответствие стандартам языка. Это заменяет первичный этап ручного ревью коллегой.

Выгода: Обнаружение логических ошибок (например, падение функции при пустом массиве) до этапа тестирования.

Как применить:

• Шаг 1: Выделение кода — VS Code — Выделите мышкой или через Cmd/Ctrl + A нужный фрагмент кода.
• Шаг 2: Вызов меню Copilot — Контекстное меню — Нажмите правую кнопку мыши, выберите пункт Copilot -> Review and Comment.
• Шаг 3: Анализ предложений — Интерфейс Copilot — Изучите список найденных проблем в появившемся окне (модель сразу подсветит, что именно ей не нравится).

Результат: Список конкретных замечаний (например: «используйте CamelCase», «добавьте проверку на null»).

3. Интерактивное применение исправлений через Diff-view

Контекст: Copilot не просто дает советы, он генерирует готовые патчи. В VS Code открывается режим сравнения (diff), где слева виден старый код, а справа — предложенный вариант. Вы можете перемещаться между исправлениями кнопками «Next» и «Previous», принимая (Apply) или отклоняя каждое изменение по отдельности. Это дает полный контроль над финальным результатом.

Выгода: Безопасный рефакторинг. Вы видите каждое изменение в реальном времени и не рискуете сломать весь файл одним махом.

Как применить:

• Шаг 1: Исправление именования — Нажмите Apply and Go to Next, чтобы изменить имя функции на более описательное (например, Get-LargestFromNumbers).
• Шаг 2: Обработка краевых случаев — Примите предложение по добавлению проверки на пустой массив. Copilot предложит вставить блок:

if ($numbers.Count -eq 0) { return $null }

• Шаг 3: Стилистические правки — Примите изменения по замене операторов (например, return на Write-Output в PowerShell), если это соответствует вашим предпочтениям или стандартам команды.

Результат: Чистый, безопасный и стандартизированный код, прошедший проверку AI-агентом.

FAQ

В: Можно ли запустить ревью сразу для всего проекта, а не для одного файла?

О: В текущей версии через контекстное меню это делается для выделенного фрагмента или файла. Однако Copilot уже внедряет функции глубокого ревью (deep review) перед коммитом, которые могут анализировать связи между несколькими файлами.

В: Насколько точны советы Copilot по стилистике (например, замена return на Write-Output)?

О: Некоторые советы носят рекомендательный характер и зависят от личных предпочтений или специфики проекта. Вы всегда можете нажать «Ignore», если считаете, что предложение AI избыточно или неверно для вашего контекста.

В: Работает ли эта функция в других IDE, например, в JetBrains?

О: На данный момент функция «Review and Comment» наиболее полно реализована и интегрирована в экосистему VS Code и GitHub Copilot Chat. В других IDE функционал может отличаться или требовать ручного промпта в чате.

В: Нужно ли писать специальный промпт для запуска ревью?

О: Нет, в последнем обновлении это встроенная команда. Вам достаточно выбрать пункт меню Review and Comment, и Copilot сам поймет, что нужно проанализировать выделенный код на наличие багов и несоответствий.

В: Понимает ли Copilot специфические требования моей компании к коду?

О: По умолчанию он использует общепринятые стандарты (Best Practices). Однако, если в вашем проекте есть файлы конфигурации (например, .editorconfig или специфические правила линтинга), Copilot старается подстраиваться под существующий стиль кода в открытых файлах.

Конспект создан на основе видео «New Code Review capability in VS Code GitHub Copilot» канала Doug Finke. Все права на оригинальный материал принадлежат авторам. Источник: https://www.youtube.com/watch?v=Dgss8IYLk3s