AI‑агент не увидел код: проблемы worktree и доступа в VECTA
В VECTA AI‑агент получал пустую рабочую копию из Git, потому что файлы не были закоммичены. Разбираем, как правильно использовать worktree, управлять задачами и ограничивать доступ.
Что случилось
Разработчики, использующие платформу VECTA для запуска coding‑agent, столкнулись с тем, что агент «не видел» их код. Файлы проекта находились на диске, но AI‑агент получал пустую рабочую копию (worktree) и не мог выполнить задачу.
Почему так происходит
- Git‑worktree берёт состояние из
HEAD– если изменения ещё не закоммичены, они не попадают в worktree. - VECTA автоматически создаёт worktree из текущего коммита, поэтому незакоммиченные файлы остаются невидимыми.
- Платформа не заменяет полноценную песочницу: worktree не изолирует процесс исполнения, а лишь предоставляет снимок репозитория.
Как решить проблему
- Снимок текущих файлов – перед запуском агента делайте
git add . && git commit -m "snapshot"или используйтеgit stash+git worktree add. - Восстановление после обрыва связи – храните метаданные задачи (идентификатор, хеш коммита) в базе VECTA, чтобы при повторном подключении агент мог «подхватить» состояние.
- Права доступа – ограничьте доступ к репозиторию через токены с минимальными правами (read‑only), чтобы агент не мог изменить историю без контроля.
- Проверка результата – после выполнения кода сравнивайте хеши файлов с ожидаемыми, используя
git diff --quiet. - Лимит расходов – не обещайте пользователям безграничный бюджет; фиксируйте лимит токенов и предупреждайте о превышении.
Подробнее о подходе и примерах кода можно прочитать в оригинальной статье на Habr AI: https://habr.com/ru/articles/1083542/.
Для разработчиков, работающих с AI‑агентами, эта статья – напоминание, что Git‑workflow остаётся критическим элементом. Правильные снимки и строгие права доступа позволяют избежать «пустых» запусков и обеспечить предсказуемость результатов. Не забывайте фиксировать бюджет токенов, иначе проект может выйти за рамки плановых расходов.
