Ревью
Читайте, что изменил агент, на панели «Изменения», откатывайте или принимайте отдельные фрагменты, отправляйте агенту комментарии и запускайте ревью кода на четырёх уровнях глубины.
Агент может быстро изменить много кода. Проверять это должно быть так же быстро. В Cusp для этого два инструмента: панель «Изменения», где вы читаете дифф сами, и ревью кода, где его читают агенты и сообщают о находках.
Панель «Изменения»
Откройте её кнопкой Изменения среди переключателей панелей или сочетанием ⌘⇧D (Ctrl+Shift+D).
Области
Выберите, что охватывает дифф:
| Область | Что показывает |
|---|---|
| С последнего сообщения | Что агент изменил в ответ на ваше последнее сообщение |
| Эта сессия | Всё, что сессия изменила с момента запуска |
| Рабочее дерево | Все незакоммиченные изменения в папке, кто бы их ни сделал |
| Ветка | Всё на текущей ветке по сравнению с её базовой веткой. Скрыто, если сравнивать не с чем |
Переходите между файлами клавишами j и k. Каждый файл можно свернуть, а вид — переключить между единым и раздельным, показать неизменённые строки или включить перенос строк.
Фрагмент за фрагментом
У каждого фрагмента (hunk) четыре действия:
- Спросить о фрагменте цитирует фрагмент в поле ввода, чтобы вы могли задать агенту вопрос о нём.
- Прокомментировать фрагмент добавляет комментарий ревью (см. ниже).
- Откатить фрагмент возвращает эту часть файла в прежнее состояние. Если файл изменился после загрузки диффа, Cusp откажется, чтобы не перезаписать правки, которых вы не видели.
- Принять фрагмент отмечает его как проверенный. Если принять все фрагменты файла, файл попадёт в индекс (staged).
У каждого файла отображается состояние: Ожидает ревью, Принят или Откачен.
Комментарии для агента
Чтобы прокомментировать строку, нажмите кнопку комментария рядом с ней, а для всего фрагмента — Прокомментировать фрагмент. Комментарии собираются в лотке внизу панели, а не отправляются по одному. Когда закончите, выберите Отправить комментарии или нажмите ⌘↵ (Ctrl+Enter), и Cusp отправит их агенту одним сообщением с файлом и строкой для каждого комментария. Дальше агент разбирает их, как любой другой запрос.
Коммит
Под диффом напишите сообщение коммита или сгенерируйте его по сессии, затем нажмите Закоммитить. Пуш из панели пока недоступен; сделайте пуш из терминала или попросите агента.
Ревью кода
Ревью — это запуск только на чтение: агент-ревьюер может читать файлы и выполнять команды только для чтения, но ничего не может изменить. Он сообщает о находках, у каждой — файл и строка, серьёзность и обоснование.
Уровни ревью
| Уровень | Что запускается | Когда использовать |
|---|---|---|
Быстрое (quick) | Один проход по диффу примерно с 20 строками контекста вокруг каждого фрагмента | Перед коммитом |
Стандартное (standard, по умолчанию) | Один ревьюер читает изменённые файлы и код, который их напрямую вызывает | Перед PR |
Глубокое (deep) | Параллельные ревьюеры, по одному на каждый аспект (корректность, безопасность, тесты, производительность и конкурентность, совместимость API, сопровождаемость). Дублирующиеся находки объединяются, а каждая важная находка уходит верификатору, который пытается воспроизвести конкретный сбой и помечает её как подтверждённую, правдоподобную или опровергнутую | Рискованные изменения, большие PR |
Ультра (ultra) | Как глубокое, но каждую важную находку дополнительно проверяют верификаторы из двух других семейств моделей, и она остаётся, только если согласны хотя бы двое из трёх. По желанию пишет падающий тест во временном worktree, чтобы воспроизвести проблему | Код, критичный для безопасности, релизы |
Для ультра-ревью нужны модели как минимум двух семейств (например, Claude и GPT). Без них запускается глубокое ревью, и Cusp об этом сообщает.
У глубокого и ультра-ревью есть лимит расходов — по умолчанию $5 и $15. Ревью, достигшее лимита, перестаёт запускать новых ревьюеров и показывает то, что успело найти.
Запуск ревью
Уровни ревью — в предварительной версии. Команды /review в приложении и CLI запускают стандартное ревью. Выбор уровня в поле ввода и на панели «Изменения», с отображением прогресса и панелью находок, — скоро. А пока выбирайте уровень, отправляя сообщение /review <level>, как показано ниже.
Отправьте /review с уровнем в качестве текста сообщения, например через cusp -p, Agent SDK или редактор с поддержкой ACP:
cusp -p "/review deep"
cusp -p "/review ultra --base main --reproduce"
cusp -p "/review quick --focus security,tests check the new auth middleware"/review [quick|standard|deep|ultra] [--base REF] [--max-cost USD]
[--reviewers provider:model,…] [--verifiers provider:model,…]
[--focus area,…] [--reproduce] [instructions…]| Параметр | Значение |
|---|---|
--base REF | Ревью ветки относительно REF (git diff REF...HEAD). Без него Cusp проверяет незакоммиченные изменения |
--max-cost USD | Лимит расходов для глубокого и ультра-ревью |
--reviewers | До трёх моделей для ревьюеров глубокого ревью |
--verifiers | Модели для перекрёстной проверки разными семействами в ультра-ревью |
--focus | Аспекты, на которых сделать акцент, например security,tests |
--reproduce | Только для ультра-ревью: попытаться воспроизвести важные находки падающим тестом во временном worktree |
Всё, что идёт после параметров, передаётся ревьюерам как дополнительные инструкции. Глубокое и ультра-ревью пропускают lock-файлы, папки dist/ и минифицированные файлы.
В интерактивном режиме CLI команда /review [pr|branch|uncommitted] [--post] [focus] запускает стандартное ревью привязанного PR, ветки или незакоммиченных изменений, а --post публикует находки в PR. См. справочник CLI.
Дальше
- Гонка: сравните несколько попыток, прежде чем проверять одну из них.
- Параллельные агенты: держите изменения разных агентов отдельно.
Бюджеты и чеки
Смотрите, сколько стоил каждый ход, с разбивкой по моделям, отслеживайте расходы по дням, моделям и рабочим областям и задавайте лимиты трат.
Параллельные агенты
Как запускать несколько агентов в одном репозитории без конфликтов — worktree, субагенты, workflow, корректировка на ходу и доска, — и что пока в предварительной версии.