AgentBase

Что такое AgentBase?

AgentBase — рабочее пространство для ревью PR, которое объединяет несколько инструментов на одной странице для проверки pull request'ов. Оно сочетает GitHub diff с намерением PR и контекстом, включая заметку автора и панель в стиле Q&A («Ask me anything»), чтобы ревьюерам было проще понять, что изменилось и почему.

Основная цель — сократить переключение между вкладками во время ревью PR, собрав в один workflow материалы, которые обычно нужны ревьюерам: diff, контекст треда, тикет/намерение и навигацию по коду, плюс способ отвечать на уточняющие вопросы прямо в той же панели.

Ключевые функции

• Одностраничная поверхность для ревью PR (вместо множества вкладок): Объединяет diff, контекст обсуждения/треда, blame/историю, контекст тикета/почему, и AI Q&A-панель в одном рабочем пространстве.
• Пинги ревьюерам в Slack со структурированным намерением: Отправляет сообщение в Slack с намерением PR, охватом, релевантной логикой кода, которая изменилась, и оценкой времени чтения, чтобы ревьюеры быстро сориентировались перед открытием PR.
• Заметка «author note» PR, привязанная к diff: Показывает заметку автора (включая ссылку на тикет) рядом с соответствующими строками diff, фиксируя обоснование изменений.
• Загрузка контекста для глубоких вопросов: Когда ревьюер задаёт вопросы (например, где вызывается функция или какой blast radius), AgentBase загружает PR и релевантные паттерны ревью кодовой базы, чтобы ответы появлялись без переключения веток.
• Обработка транскриптов с редакцией: Очищает секреты перед сохранением транскриптов (например, API-ключи/токены/пароли/приватные ключи заменяются на [REDACTED]) и не хранит другую информацию сверх описанного.
• Фокус на приватности captured данных: Захватывает только разговор с AI по этому PR плюс базовые метаданные PR (repo, branch, commit) при открытии PR ревьюером.

Как использовать AgentBase

• Установка и открытие в бета-версии: Сайт показывает установку через npx useagentbase@latest install.
• Начало ревью PR: При открытии pull request AgentBase показывает консолидированную страницу ревью с diff, намерением автора и поддерживающим контекстом.
• Задавайте уточняющие вопросы в панели: Используйте интерфейс «Ask me anything» (на странице обозначен как Sprig), чтобы запросить детали вроде «где вызывается функция» или «что ещё затрагивает это изменение», с цитатами из доступного в PR и кодовой базе.
• Используйте пинг в Slack как точку входа: AgentBase может отправить сообщение нужному ревьюеру в Slack с намерением, охватом, изменённой основной логикой и временем чтения, чтобы решить, на чём сосредоточиться.

Кейсы использования

• Рефакторинг auth в edge/middleware: Если PR перемещает логику аутентификации/rate limiting из per-route handlers в edge middleware, ревьюеры могут использовать панель для проверки охвата (файлы/пакеты), обоснования, привязанного к diff, и миграции всех call sites.
• Ревью blast radius при миграциях: Когда изменение заменяет функцию (например, fetchSession на чтение из заголовков), ревьюер может спросить об impact по репозиторию и orphaned call sites.
• Быстрое понимание изменений и причин: Для PR с diff'ами кода и заметками намерения (ссылка на тикет, рассуждения автора) ревьюеры читают «author note» рядом со строками вместо поиска по вкладкам.
• Ответы на вопросы консистентности во время ревью: Если ревьюер хочет узнать, был ли ранее shipped похожий refactor (например, session middleware), можно запросить сравнение прямо в Q&A-панели.
• Триаж очереди ревью в команде: Когда PR висят в очереди, пинги в Slack дают структурированный summary для эффективного старта ревью, включая оценку времени чтения.

FAQ

• Что собирает AgentBase при открытии PR? Захватывает разговор с AI по этому изменению плюс базовые детали PR (repo, branch, commit). Не мониторит вас во время кодинга или чтения другого контента на ноутбуке.

• Хранит ли AgentBase секреты из разговора с AI? Транскрипт проходит через scrubber перед сохранением. API-ключи, токены, пароли и приватные ключи автоматически заменяются на [REDACTED].

• Можно ли задавать вопросы за пределами diff-view? Да. Интерфейс поддерживает уточняющие вопросы (например, где вызывается функция, какой blast radius), панель цитирует релевантную информацию из PR и кодовой базы.

• Как работают уведомления? Сайт описывает Slack-сообщения нужному ревьюеру с намерением PR, охватом, изменённой основной логикой и оценкой времени чтения.

• Как установить AgentBase? Страница показывает установку с npx useagentbase@latest install (доступно в бета-версии).

Альтернативы

• Ручное ревью PR с обычным интерфейсом GitHub + отдельные заметки: Ревьюеры могут открыть diff, проверить обсуждение и использовать поиск/blame напрямую. Это обычно требует больше переключений контекста, чем консолидированное одностраничное рабочее пространство.
• AI-помощники по коду, используемые параллельно с вкладками PR: Инструменты, генерирующие объяснения или ответы, можно использовать вместе с GitHub, но они не централизуют автоматически контекст diff, blame и тикет/намерение в одной поверхности ревью.
• Системы workflow, маршрутизирующие PR по ролям и отправляющие уведомления в Slack: Некоторые команды используют автоматизацию для уведомления ревьюеров, но без такой же консолидации «diff + намерение + Q&A» в одном месте.
• Чек-листы и шаблоны для code review: Команды могут сократить пропущенный контекст с помощью стандартизированных чек-листов и шаблонов PR; это повышает консистентность, но не предоставляет Q&A, привязанное к diff и кодовой базе именно так.