Uruchamiaj równoległe agenty w izolowanych worktree
ENWorktree Gita daje każdemu równoległemu zadaniu agenta kodującego własny katalog roboczy i gałąź przy jednym wspólnym magazynie obiektów Gita. Programiści oraz tech leadzi łączą worktree z blokami portów, allowlistą konfiguracji deweloperskiej, kontrolą nakładających się plików i bezpiecznym sprzątaniem, aby prowadzić dwa do czterech równoległych strumieni w Claude Code, Codexie lub Cursorze bez kolizji.
Otwierasz trzy terminale w tym samym checkoucie. Formatter pierwszego agenta przepisuje plik edytowany przez drugiego, serwer deweloperski drugiego po cichu zajmuje kolejny wolny port, a testy end-to-end trzeciego przechodzą na serwerze drugiego. Wszystkie trzy meldują „gotowe”, mimo że żaden nie udowodnił, który kod przeszedł testy.
Kiedy równoległe worktree się opłacają, a kiedy lepiej iść szeregowo
Dział zatytułowany „Kiedy równoległe worktree się opłacają, a kiedy lepiej iść szeregowo”Równoległe strumienie zwiększają przepustowość tylko wtedy, gdy zadania dotyczą rozłącznych plików i każde ma maszynową bramkę. Wąskim gardłem jest niemal zawsze pojemność code review, a nie liczba uruchomionych modeli; dwa do czterech aktywnych strumieni utrzymują nadzór i integrację w ryzach dla jednego programisty.
| Sytuacja | Wzorzec wykonania | Uzasadnienie |
|---|---|---|
| 2–4 poprawki lub funkcje w rozłącznych modułach, każda z testami | Równoległe worktree, jeden strumień na zadanie | Niezależne diffy i niezależne bramki |
| Jedno trudne zadanie z dwiema konkurencyjnymi architekturami | Ta sama specyfikacja w dwóch worktree; zostaje czystszy zielony diff | Obiektywne porównanie na identycznych testach |
| Dwa zgłoszenia dotykające tego samego API, schematu lub konfiguracji | Jeden strumień, kolejno | Praca równoległa gwarantuje konflikty semantyczne i przeróbki |
| Rozpoznanie kodu tylko do odczytu albo audyt PR | Subagent zakresowy w jednej sesji | Bez narzutu osobnego checkoutu i gałęzi |
Szerszy wybór między worktree, subagentami i kolejkami w tle opisują wzorce orkiestracji.
Co worktree izoluje, a co pozostaje wspólne
Dział zatytułowany „Co worktree izoluje, a co pozostaje wspólne”Każdy worktree ma własne pliki robocze, indeks stagingu i wybraną gałąź, współdzieląc historię .git, refy i git config. Wszystko poza Gitem pozostaje wspólne, dopóki konfiguracja tego nie rozdzieli:
| Zasób | Izolowany przez worktree Gita? | Awaria przy braku izolacji |
|---|---|---|
| Śledzone pliki i gałąź | Tak | Rozwiązane natywnie przez worktree |
Pliki ignorowane przez Git (.env, zależności) | Brak w świeżym worktree | Build pada albo agent zmyśla konfigurację |
| Porty serwera deweloperskiego i testów | Nie | Cichy przeskok portu kieruje testy na serwer innego strumienia |
| Lokalna baza, cache, kolejki | Nie | Równoległe migracje lub seedy psują wspólny stan |
git config | Nie | Zapis konfiguracji w jednym worktree zmienia wszystkie pozostałe |
| Poświadczenia chmurowe, sekrety, wdrożenia | Nie | Każdy strumień wciąż sięga do tych samych zdalnych zasobów |
Natywne worktree w Claude Code, Codexie i Cursorze
Dział zatytułowany „Natywne worktree w Claude Code, Codexie i Cursorze”Wszystkie trzy narzędzia obsługują izolowane worktree natywnie, różniąc się lokalizacją katalogu oraz kopiowaniem plików ignorowanych. Aktualne flagi i kroki UI sprawdzaj w oficjalnej dokumentacji:
Claude Code oferuje wbudowane sesje worktree oraz izolację worktree dla subagentów, kopiując deweloperskie pliki ignorowane z głównej allowlisty .worktreeinclude. Dodaj katalog worktree do .gitignore, ogranicz .worktreeinclude wyłącznie do lokalnych plików deweloperskich (nigdy sekretów produkcyjnych) i pamiętaj, że przebiegi nieinteraktywne zostawiają worktree do jawnego sprzątania. Zobacz dokumentację Claude Code.
Codex tworzy zarządzane worktree z poziomu CLI lub w trakcie sesji (izolowane worktree Codexa). Zarządzane worktree często startują na odłączonym HEAD bez plików ignorowanych, więc przed pierwszym commitem utwórz nazwaną gałąź i dostarcz konfigurację lokalną — albo uruchamiaj Codexa wewnątrz worktree utworzonego skryptem repozytorium. Zobacz dokumentację OpenAI Codex.
Cursor obsługuje Worktrees obok okna Agents Window do pracy równoległej (okno Agents w Cursorze · dokumentacja Cursora). Gdy stos wymaga deterministycznych bloków portów i konfiguracji środowiska, utwórz checkout skryptem repozytorium i otwórz ten katalog w osobnym oknie Cursora.
Zapisz kontrakt izolacji w skryptach repozytorium
Dział zatytułowany „Zapisz kontrakt izolacji w skryptach repozytorium”Natywne polecenia narzędzi rozdzielają wyłącznie pliki, nie przydzielając bloków portów ani bezpiecznego sprzątania. Zacommituj cienki wrapper repozytorium (bin/wt new <slug> i bin/wt cleanup <slug>), aby każdy programista i agent stosował identyczny kontrakt:
- Tworzenie z jawną bazą i blokiem portów (
wt new): pobierzorigin, utwórz gałąźagent/<slug>od gałęzi domyślnej, przydziel najniższy wolny indeks portów (krok 10, żeby przypadkowy przeskok został w bloku strumienia), zapiszWT_INDEX,WT_BASE,APP_PORTiDB_PORTdo ignorowanego.wt-env, skopiuj wyłącznie jawną allowlistę plików deweloperskich i zainstaluj zależności. - Ścisłe powiązanie serwerów i testów z
.wt-env: odczytujAPP_PORTz.wt-envw konfiguracji serwera i testów E2E z włączonym ścisłym trybem portu, aby serwer zakończył się błędem zamiast cicho przechodzić na kolejny port:
import { readFileSync } from 'node:fs';import { defineConfig } from '@playwright/test';
const wtEnv = (() => { try { return readFileSync('.wt-env', 'utf8'); } catch { return ''; }})();const port = /^APP_PORT=(\d+)$/m.exec(wtEnv)?.[1] ?? '4321';const baseURL = `http://localhost:${port}`;
export default defineConfig({ use: { baseURL }, webServer: { command: `pnpm dev --port ${port} --strictPort`, url: baseURL, reuseExistingServer: !process.env.CI, },});- Bezpieczne usuwanie (
wt cleanup): odmawiaj usunięcia, gdygit status --porcelainnie jest pusty, gdy na porcie z.wt-envwciąż nasłuchuje proces albo gdy gałąź zawiera commity niewypchnięte naorigin.
Prowadź równoległe strumienie od podziału do scalenia
Dział zatytułowany „Prowadź równoległe strumienie od podziału do scalenia”- Najpierw podziel niezależne zadania. Przed utworzeniem checkoutów sprawdź, czy wybrane tickety modyfikują rozłączne pliki i kontrakty publiczne; prace nakładające się ustaw szeregowo.
- Uruchom 2–4 strumienie skryptem wrappera. Wystartuj po jednej sesji agenta w każdym worktree z jawnymi granicami ścieżek i kontraktem portów z
.wt-env. - Wymagaj lokalnych bramek w każdym worktree. Agent kończy zadanie dopiero wtedy, gdy typy, lint i testy zwracają kod 0 wewnątrz jego checkoutu — najlepiej z egzekwowaniem przez hook
Stop. - Integruj kolejno i rób rebase. Scalaj PR-y po jednym, rebasuj pozostałe aktywne gałęzie na zaktualizowany
main, ponawiaj bramki i sprzątaj scalone worktree bezpiecznym skryptem (kolejka review).
Zweryfikuj równoległe strumienie bez czytania każdego diffu
Dział zatytułowany „Zweryfikuj równoległe strumienie bez czytania każdego diffu”Przed otwarciem lub recenzją PR-ów wykonaj cztery mechaniczne sprawdzenia:
- Kontrola nakładania się plików między gałęziami: uruchom w głównym checkoucie; każda wypisana ścieżka oznacza kolizję dwóch strumieni — zatrzymaj jeden do czasu scalenia i rebasu drugiego:
for b in $(git for-each-ref --format='%(refname:short)' refs/heads/agent/ 'refs/heads/worktree-*'); do git diff --name-only "origin/main...$b"done | sort | uniq -d- Weryfikacja bazy i portu: potwierdź, że
git merge-base HEAD origin/mainzgadza się z planowaną rewizją bazową, a proces nasłuchujący naAPP_PORTdziała z katalogu tego właśnie worktree. - Automatyczny audyt Stanowiska 4: uruchom
npx @wondelai/harness-audit --lang pl, aby zweryfikować w Stanowisku 4 (Graf) skrypty worktree, higienę.worktreeincludei izolację portów (przewodnik po harness-audit). - Pakiet dowodów: dołączaj dokładne komendy, kody wyjścia i listy zmienionych plików do każdego PR-a (pakiet dowodów).
Kiedy równoległe worktree sprawiają problemy
Dział zatytułowany „Kiedy równoległe worktree sprawiają problemy”- Testy przechodzą na serwerze sąsiedniego strumienia. Brak
strictPortalbo stałe URL-e w testach E2E maskują zepsuty kod. Zatrzymaj wszystkie serwery, powiąż serwery i URL-e testów ściśle z.wt-envi unieważnij wcześniejsze niezweryfikowane przebiegi. - Świeże worktree nie potrafi się zbudować. Brak konfiguracji deweloperskiej lub zależności zatrzymuje agenta. Dodaj pliki deweloperskie do allowlisty wrappera albo
.worktreeincludei zautomatyzuj instalację zależności przy tworzeniu worktree. - Commity znikają po usunięciu odłączonego
HEAD. Odzyskaj je przezgit reflogprzed czyszczeniem i wymagaj w prompcie startowym sprawdzeniagit branch --show-currentoraz utworzenia nazwanej gałęzi przed pierwszą edycją. - Dwa strumienie przechodzą osobno, ale psują się po scaleniu. Zmieniły niejawny wspólny kontrakt. Zrób rebase drugiego strumienia na zaktualizowany
main, ponów pełną bramkę i wpisz ten kontrakt na listę zadań szeregowych. - Przebiegi headless zostawiają zablokowane worktree. Sprawdź
git status, zachowaj potrzebne commity, odblokuj i usuń stare worktree oraz okresowo wykonujgit worktree prune.
Oficjalna dokumentacja i kolejne kroki
Dział zatytułowany „Oficjalna dokumentacja i kolejne kroki”Aktualne komendy worktree, zasady .worktreeinclude i obsługę wielu agentów sprawdzaj w oficjalnej dokumentacji: Claude Code, OpenAI Codex i Cursor.
Czy ten artykuł Ci pomógł?
Jedno kliknięcie, bez logowania.
Co z tym zrobisz?
Jak się czytało?
Co przeszkadzało? Możesz zaznaczyć kilka
Twoja rola?
Dzięki. Czytam każdą odpowiedź. Michał Jaskólski
Pomógł Ci ten artykuł?
Każde to jedno kliknięcie. Zamknij, kiedy chcesz.
bez logowania
Najczęstsze pytania
Co izolują worktree Gita przy równoległych agentach, a jakiej dodatkowej izolacji wymagają?
Worktree Gita daje każdemu zadaniu osobny katalog roboczy i gałąź przy wspólnej historii repozytorium. Ponieważ izoluje wyłącznie pliki, każdy strumień potrzebuje dodatkowo własnego bloku portów, lokalnego stanu, allowlisty konfiguracji deweloperskiej oraz niezależnej bramki weryfikacji.
Ile równoległych strumieni agentów warto prowadzić jednocześnie w worktree Gita?
Dwa do czterech izolowanych strumieni równoważy przepustowość z możliwościami code review, pod warunkiem że każdy strumień przechodzi własną automatyczną bramkę, a sprzątanie chroni niewypchnięte commity.