Проверка правок агента

Написанное агентом не попадает в базу знаний молча. Каждая правка ложится предложением и ждёт человека на экране проверки. Это касается и агента в редакторе кода, и ассистента во вкладке «Чат».

Зачем это нужно

Агент работает под вашим доступом, и права у него настоящие. Этого мало: агент, которому подсунули постороннюю инструкцию в тексте, действует в рамках прав — переписывает регламент, сносит раздел, подкладывает в базу текст, который потом сам же прочитает как «знание компании».

Поэтому подтверждение приходит другим каналом — в вебе, отдельно от сессии агента. Смысл не в том, что нужен второй человек: нажать может и тот же, кто агента и позвал. Смысл в том, что нажатие в чужом канале не подделать.

Единица разбора — пачка

Все правки одной сессии агента собираются в одно предложение. «Создал десять страниц, удалил две, поправил три» — это один экран, а не пятнадцать вопросов подряд, на которые нажимают «да» не глядя.

Где это видно

• «Входящие» → «Ждут решения» — экран проверки. Красное число на значке «Входящих» — сколько правок ждёт вашего решения в этом проекте; точка на кнопке проекта — что ждут в другом.
• Уведомление «Правка ждёт проверки» — всем, кто вправе решать, и тому, под чьим доступом работал агент. Лента уведомлений общая на все проекты, поэтому предложение, оставленное в соседнем проекте, не теряется. См. Уведомления.
• Дашборд — счётчик «правок ждут решения» и карточка «Предложения».
• Пометки в дереве: ✨ — предложено агентом, рядом вторая метка — создание, правка или удаление. Создаваемые страницы стоят призраками (пунктиром), удаляемые — зачёркнутыми. Свёрнутая ветка показывает число.
• Плашка на самой странице — «по этому документу есть непринятое предложение». Её видит и читатель.
• Ссылка от агента: в ответе инструмента он отдаёт прямой адрес на экран проверки — её можно открыть из чата с ним.
• Карточка в чате: правку, предложенную ассистентом во вкладке «Чат», можно принять прямо под его ответом — «Применить», «Отклонить», «Что меняется» — или открыть экран проверки.

Экран проверки

Под заголовком стоит сводка состава — до прокрутки и до первого решения: «будет создано 3, изменено 4, удалено 2 страницы — вместе с вложенными 7; сломается 41 ссылка». Это то, что стоит прочесть раньше диффов: цена пачки видна одной строкой.

Дальше — карточка на правку, дифф в каждой, без «посмотрите в истории»: правки в истории ещё нет и быть не должно.

У каждой карточки указано время правки: агент мог дописать в пачку, пока вы её разбирали, и это единственное, чем такая строка помечена.

Дифф показывает правку, а не всю страницу

Неизменённый текст между правками сворачивается до трёх строк с каждой стороны, и раскрывается обратно — шагом, целым прогоном, всем диффом сразу или всей карточкой по заголовку.

Ни одна строка самой правки не прячется — ни свёрткой, ни ограничением высоты. Обрезанная правка означала бы решение вслепую, а барьер, который дороже внимания, перестаёт работать: правка одного абзаца на странице в 500 строк давала карточку в 500 строк, из которых важны две.

Решать можно по отдельным правкам

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

Создание вложенной страницы автоматически тянет за собой создание её родителя — иначе страница повисла бы в пустоте; отметка проставляется сама, и об этом сказано на месте.

Решение не уносит место чтения: карточка гаснет там, где стояла, а фокус переезжает на первую нерешённую ниже. По группам «Решённые» и «Ждут решения» всё раскладывается при следующем заходе на экран. У принятого создания сразу есть кнопка «Открыть» — новую страницу не нужно искать в дереве; дерево и открытая страница обновляются сами, без перезагрузки.

Пачкой

«Принять всё» спрашивает подтверждение и показывает в нём ту же сводку состава. Галки «больше не спрашивать» у этого вопроса нет намеренно: это единственная кнопка экрана, которая необратимо меняет базу знаний целиком.

«Отклонить всё» стоит рядом второстепенной кнопкой и просит коротко объяснить причину — она останется в истории предложения. В базе оно не меняет ничего.

Обе кнопки применяют ровно то, что вы видели: поимённый список со своего экрана, а не «всё, что ждёт решения на сервере». Правка, которую агент дописал, пока вы читали сводку, в эту пачку не попадёт.

С клавиатуры

Разбор пачки — не мышиная работа: чтобы принять четырнадцать правок из пятнадцати, не нужно четырнадцать раз попадать в чекбокс.

Часть команд названа строкой под рядом решений, остальные — за кнопкой «Все команды». Клавиши читаются по физическому положению, поэтому в русской раскладке они работают так же.

На телефоне отметок и клавиш нет: чекбокс пальцем не берётся, а ряд кнопок разворачивался бы в половину экрана. Решения по одной карточке доступны везде.

Если отклонили зря

У отклонённой правки есть «Вернуть» — она снова встаёт в очередь на решение. Кнопка стоит в двух местах: на карточке, отклонённой прямо сейчас (она остаётся на месте с пометкой «Отклонена — только что»), и в группе «Решённые» у отклонённой раньше. Окна отмены на несколько секунд тут мало: «передумал через день» — такой же законный случай, как промах по кнопке.

Подтверждения у возврата нет — он ничего не применяет. Вернуть нельзя только то, по чьей цели в предложении уже лежит другая правка.

У применённой правки кнопки «Вернуть» нет вовсе, а не заблокированной: применённое отменяют корзиной и историей страницы, см. ниже.

Устаревшие правки

Если вы поправили страницу руками после того, как агент предложил свою правку, его правка не применится: она считалась против прежней версии, и применение молча затёрло бы вашу работу. Такая правка помечается как устаревшая — «страница изменилась с момента предложения», — принять её нельзя, только отклонить или попросить агента переделать поверх актуального текста.

Агент об этом узнаёт, когда перечитывает страницу: ему приходит живой текст и прямое указание, что правка не применится.

Устаревшее копится, поэтому есть кнопка, которая снимает все устаревшие правки разом. Сроков годности у предложений нет — само по себе ничего не сгорает.

Неподтверждённое не индексируется

Пока правка не принята, её нет ни в поиске, ни в ответах ассистента. Это не аккуратность, а защита от замкнутого круга: иначе агент пишет в базу текст и через минуту читает его обратно как факт о компании, а коллега в чате получает неутверждённое утверждение без всякой пометки.

Единственное исключение: свой черновик агент читает — иначе он не смог бы продолжить работу с того места, где остановился. Другим субъектам и через поиск — никогда.

Кто подтверждает

Правило простое: подтверждение не даёт больше власти, чем сделать то же самое руками.

• Читатель видит пометки и диффы, решений не принимает.
• Редактор принимает и отклоняет правки страниц и задач.
• Владелец — то же плюс массовые удаления.

Правка, которую ваша роль подтвердить не может, показывает не заблокированную кнопку, а объяснение, у кого просить. В «Принять всё» она не считается и в пачку не уходит: счётчик, обещающий пятнадцать и применяющий четырнадцать, хуже честного отказа.

Кто в итоге автор

Три разных факта, и в один их не схлопывают: инициатор (человек, под чьим доступом работал агент), канал (какой клиент) и подтвердивший. В истории страницы это читается как «Алексей · через Claude Code · подтвердил Пётр».

Учётной записи «AI» в системе нет: агент — это как, а не кто, и ответственность за правку остаётся на человеке.

Если приняли зря

Всё обратимо: правка лежит ревизией в истории страницы, удалённое — в корзине.