Передача задач AI-агенту
Обновлено 22 октября 2026 г.
Задачу можно передать AI-агенту для разработки — Claude Code или OpenAI Codex на вашем компьютере, с вашими репозиториями и вашими настройками. Агент берёт задачу, работает над ней, пишет о ходе работы в комментариях и переводит её на проверку.
Как это работает
- Вы передаёте задачу. В разделе Агент на странице задачи нажмите Передать агенту. На карточке на доске появится Для агента.
- Агент её берёт. Раннер на вашем компьютере — laraue-boards-agent (коротко
lba), см. ниже — входит с вашим API-ключом, забирает переданные вам задачи, ведёт работу в ветке с именем задачи в репозиториях спейса и переводит задачу в работу. На карточке — Агент работает. - Агент работает. Пишет комментарии о ходе работы и итог, затем переводит задачу в статус проверки. На карточке — Агент готов · проверьте, а компьютер показывает уведомление.
- Вы проверяете. Переведите задачу в «готово» или попросите доработку: прямо на своём компьютере командой
lba continueили кнопкой Вернуть агенту в разделе «Агент».
Значок остаётся на карточке, если задачу хоть раз передавали агенту: после проверки — Сделано агентом, у отменённого запуска — Агент отменён. Если агент не справился, на карточке будет Агент не справился. На странице задачи причина и время — в красной рамке в разделе «Агент», а раннер оставляет комментарий с подробностями.
Кто может передать задачу
Только исполнитель задачи и только своему агенту: раннер работает лишь с задачами, назначенными пользователю, чей API-ключ он использует. Никто другой не может отправить работу на ваш компьютер.
Кнопка Передать агенту неактивна, а причина видна в подсказке, пока:
- у вас нет API-ключа в организации — раннер входит с ним, а настройка раннера его создаёт,
- задача не в не начатом статусе, или
- на её доске нет статусов для каждого этапа, через который проходит агент: не начато, в работе, на проверке.
Пока задача у агента
Задача заблокирована для изменений: нельзя менять заголовок, описание, атрибуты, вложения и исполнителя, нельзя удалить задачу — агент работает с тем, что вы передали. Статус и комментарии менять можно. Комментарии не от исполнителя агент воспринимает как информацию, а не как указания.
Любой, кто может редактировать задачу, может отменить запуск крестиком × рядом с его значком в разделе «Агент». Это останавливает агента и снимает блокировку.
Заблокированные задачи
Можно передать заблокированную задачу. Она ждёт — агент её не берёт, — пока все блокирующие задачи не будут готовы.
Настройка раннера
laraue-boards-agent (коротко — lba) — это раннер: одна программа для macOS, Windows и Linux, которая работает на вашем компьютере. Сейчас он в бета-версии. Нужны git и агент для разработки — Claude Code или Codex.
Раннер устанавливается одной командой — она скачивает последний релиз и запускает настройку:
curl -fsSL https://raw.githubusercontent.com/Laraue/boards-agent/main/install.sh | sh
В Windows — в PowerShell:
irm https://raw.githubusercontent.com/Laraue/boards-agent/main/install.ps1 | iex
Во время настройки раннер:
- Выбирает агента: тот, что у вас установлен, а если установлены оба — спрашивает.
- Открывает Boards в браузере. Проверьте, что код на странице совпадает с кодом в терминале, выберите организацию и нажмите Разрешить. Boards создаст API-ключ с названием агента и вашего компьютера, например «Claude Code agent (MacBook)», а раннер сохранит его в «Связке ключей» или «Диспетчере учётных данных» — копировать ключ никуда не нужно.
- Спрашивает, в какой папке лежат копии ваших репозиториев (путь можно ввести или выбрать папку в Finder или Проводнике), и показывает, какие репозитории нашлись для каждого спейса (см. ниже).
- Спрашивает, где работать агенту.
- Спрашивает, что делать с веткой агента, когда он закончит: ничего, запушить или запушить и открыть пул-реквест (см. ниже).
- Предлагает запускать раннер в фоне, в том числе после перезагрузки, — тогда ничего не придётся запускать вручную.
Чтобы обновиться, ещё раз выполните команду установки: она заменит laraue-boards-agent и перезапустит его, не задавая вопросов заново. Изменить ответы можно командой lba setup. Подробности — в README.
В каких репозиториях работает агент
Репозитории спейса — это его ссылки, URL которых совпадает с git remote репозитория, склонированного на ваш компьютер. Добавьте URL репозитория в ссылки спейса — и раннер сам найдёт вашу копию: сопоставлять ничего не нужно, а ссылка, добавленная позже, учитывается со следующей передачи задачи. Добавляйте только те репозитории, в которых делаются задачи этого спейса: каждый из них, если он склонирован на ваш компьютер, участвует в каждом запуске.
У спейса может быть несколько репозиториев — например, бэкенд и веб-приложение. Агент меняет только те, что нужны задаче, — в каждом в ветке с одним и тем же именем. Описание спейса и остальные его ссылки (документацию, макеты) агент получает как контекст, а не как указания.
Если на этом компьютере нет ни одного репозитория спейса, задача ждёт другой ваш компьютер, где они есть.
Где работает агент
Во время настройки раннер спрашивает, какой из двух вариантов вам удобнее:
Отдельный worktree на каждую задачу (по умолчанию). Агент работает в своей копии каждого репозитория, в ветке с именем задачи, например
agent/WEB-42-fix-export. Ваши копии остаются как есть, и вы можете тем временем работать в них.Ваши собственные копии, по одной задаче за раз. Раннер обновляет основную ветку каждого репозитория и переключает вашу копию на новую ветку от неё. Когда агент закончит, копия так и останется на этой ветке: откройте её в редакторе, запустите приложение и проверяйте как обычно. Копии, которые агент не менял, возвращаются на ту ветку, где были.
Чистую копию раннер переключает без вопросов, на какой бы ветке она ни была — например, на ветке прошлой задачи, которую вы ещё проверяете; её коммиты остаются в той ветке. Раннер спрашивает (в диалоговом окне) только о копиях с незакоммиченными изменениями: при переключении они могли бы перенестись в новую ветку или вызвать конфликт. Кнопка Continue запускает проверку заново: ваши незакоммиченные изменения раннер никогда не трогает, поэтому спрашивает снова, пока вы их не закоммитите или не уберёте в stash. Not now откладывает задачу — раннер спросит ещё раз через 10 минут.
В обоих случаях агент работает с фиксированным списком разрешённых команд и не может пушить.
Когда агент закончил
- Уведомления. Компьютер показывает уведомление от laraue-boards-agent с логотипом Laraue: когда агент начинает работу, когда задача готова к проверке, когда агент не справился и когда запуск отменён. Нажмите на уведомление, чтобы открыть задачу. При первом уведомлении macOS может спросить, разрешить ли laraue-boards-agent их присылать.
- Ветка. По умолчанию она остаётся на вашем компьютере — вы проверяете её и пушите сами. Если вы выбрали это при настройке, laraue-boards-agent сам запушит её после того, как агент закончит, — в каждом репозитории, который агент менял, — и может открыть пул-реквест, если установлен и авторизован GitHub CLI. Ссылки будут в комментарии laraue-boards-agent к задаче и в уведомлении. Сам агент никогда не пушит.
Как попросить доработку
На своём компьютере: lba continue. Работа агента лежит у вас на компьютере, поэтому доработку быстрее всего попросить прямо там. Выполните в терминале:
lba continue
Откроется та же сессия агента, в которой он работал над задачей, — тот же разговор, со всем, что он знал, в тех же репозиториях и в ветке задачи. Если не указать ключ задачи, берётся задача той ветки, на которой вы сейчас, а если такой нет — последняя задача, над которой работал ваш агент; команда напишет, какую задачу выбрала. Напишите, что не так («кнопка всё ещё синяя», «добавь тест для пустого списка»): изменения сразу видны, приложение можно тут же запустить. В Boards при этом ничего не меняется, и ждать раннер не нужно. Когда вы выйдете из сессии, к задаче добавится один комментарий с новыми коммитами.
Чтобы поручить одну правку, не продолжая разговор, напишите её сразу после команды (кавычки не нужны). Агент сделает её сам и выведет ответ в терминал:
lba continue WEB-42 сделай кнопку красной, как остальные основные кнопки
lba continue WEB-42 выведи JSON дашборда Grafana для новых метрик
Сессия есть только на том компьютере, где выполнялась задача. В режиме собственных копий раннер сначала переключит ваши копии обратно на ветку задачи и спросит вас только о незакоммиченных изменениях.
Из Boards: «Вернуть агенту». Если задача на проверке, нажмите в разделе «Агент» Вернуть агенту и напишите, что не так: комментарий добавится к задаче, она вернётся в не начатый статус и снова уйдёт агенту. Агент продолжит в той же ветке — в его комментарии будет «continuing … (N commits so far)». Это удобно, когда вас нет за компьютером.
Для авторов раннеров
Раннер использует MCP-инструменты: list_agent_runs (опрос с state: Ready, вашим id из get_me в assigneeIds и excludeBlocked: true), claim_agent_run (true — задача ваша, false — пропустить), finish_agent_run (Done или Failed с причиной) get_issue, где latestAgentRun показывает, не отменён ли запуск, и get_space — описание и ссылки спейса. Каждое изменение запуска видно в истории изменений задачи вместе с API-ключом, который его сделал.