4.4 KiB
| title | description | lang |
|---|---|---|
| Git и стратегия worktree – Документация Agent Teams | Как выбирать main worktree, feature branches или OpenCode worktree isolation для parallel agent work. | ru-RU |
Git и стратегия worktree
Git даёт Agent Teams самый сильный review path: narrow diffs, branch visibility, task-scoped changes и более безопасную parallel work.
Выбор стратегии
| Strategy | Когда использовать | Tradeoff |
|---|---|---|
| Main worktree | Solo work, docs-only edits или один teammate за раз | Просто, но parallel edits могут конфликтовать |
| Feature branch | Одна team работает над одним coherent change | Чистый review target, но teammates всё ещё делят files |
| Worktree isolation | Несколько OpenCode teammates могут параллельно менять один repo | Лучше isolation, но merge/review требует дисциплины |
Начинайте просто. Включайте worktree isolation, когда parallel edits вероятны, а не потому что каждому task нужен отдельный checkout.
Когда включать изоляцию worktree
Включайте для OpenCode teammates, когда:
- два или больше teammates могут менять один repository одновременно
- task может запускать formatters, code generators или broad tests
- нужно держать branch и diff каждого teammate отдельно
- lead workspace dirty и не должен получать прямые edits
Оставляйте выключенным, когда:
- task read-only
- один teammate владеет всеми edits
- repo не Git-tracked
- нужен runtime path, который не поддерживает этот isolation mode
::: warning Worktree isolation сейчас применяется к OpenCode members и требует Git-tracked project. :::
Гигиена веток
Перед parallel work:
git status --short
git branch --show-current
По возможности используйте clean branch. Если main worktree уже содержит user changes, скажите agents не revert unrelated files и держать task scope узким.
Рекомендуемый branch style:
agent/<team-or-task>/<short-purpose>
Примеры:
agent/docs/mcp-guide
agent/review/task-log-filtering
agent/ui/code-review-polish
Процесс ревью
Для isolated worktrees проверяйте diff teammate до merge или apply в main workspace.
- Убедитесь, что task result comment называет changed scope и verification.
- Проверьте task diff в review UI.
- Запросите changes в task, если diff трогает unrelated files.
- Approve только когда tests или manual checks соответствуют risk.
- Merge или apply changes осознанно.
Не auto-merge worktree output только потому, что task complete. Completion значит, что agent считает работу ready for review.
Политика разрешения конфликтов
| Situation | Action |
|---|---|
| Два teammates меняют один file | Pause one task или назначьте одного owner для integration |
| Generated files changed broadly | Требуйте comment с generator и command |
| Main worktree имеет unrelated changes | Preserve them и review только task-owned changes |
| Worktree branch diverges | Rebase или merge manually после review, не внутри vague agent task |
Пример промпта для задачи
Implement the settings validation fix in your assigned worktree. Keep edits inside src/features/settings and focused tests. Do not touch provider auth or task storage. Post the test command and result before completing the task.
Этот prompt работает, потому что называет allowed area, sensitive boundaries и completion evidence.