Przejdź do głównej zawartości

Worktree 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.

SytuacjaWzorzec wykonaniaUzasadnienie
2–4 poprawki lub funkcje w rozłącznych modułach, każda z testamiRównoległe worktree, jeden strumień na zadanieNiezależne diffy i niezależne bramki
Jedno trudne zadanie z dwiema konkurencyjnymi architekturamiTa sama specyfikacja w dwóch worktree; zostaje czystszy zielony diffObiektywne porównanie na identycznych testach
Dwa zgłoszenia dotykające tego samego API, schematu lub konfiguracjiJeden strumień, kolejnoPraca równoległa gwarantuje konflikty semantyczne i przeróbki
Rozpoznanie kodu tylko do odczytu albo audyt PRSubagent zakresowy w jednej sesjiBez narzutu osobnego checkoutu i gałęzi

Szerszy wybór między worktree, subagentami i kolejkami w tle opisują wzorce orkiestracji.

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óbIzolowany przez worktree Gita?Awaria przy braku izolacji
Śledzone pliki i gałąźTakRozwiązane natywnie przez worktree
Pliki ignorowane przez Git (.env, zależności)Brak w świeżym worktreeBuild pada albo agent zmyśla konfigurację
Porty serwera deweloperskiego i testówNieCichy przeskok portu kieruje testy na serwer innego strumienia
Lokalna baza, cache, kolejkiNieRównoległe migracje lub seedy psują wspólny stan
git configNieZapis konfiguracji w jednym worktree zmienia wszystkie pozostałe
Poświadczenia chmurowe, sekrety, wdrożeniaNieKażdy strumień wciąż sięga do tych samych zdalnych zasobów

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.

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:

  1. Tworzenie z jawną bazą i blokiem portów (wt new): pobierz origin, 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), zapisz WT_INDEX, WT_BASE, APP_PORT i DB_PORT do ignorowanego .wt-env, skopiuj wyłącznie jawną allowlistę plików deweloperskich i zainstaluj zależności.
  2. Ścisłe powiązanie serwerów i testów z .wt-env: odczytuj APP_PORT z .wt-env w 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:
playwright.config.ts
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,
},
});
  1. Bezpieczne usuwanie (wt cleanup): odmawiaj usunięcia, gdy git status --porcelain nie jest pusty, gdy na porcie z .wt-env wciąż nasłuchuje proces albo gdy gałąź zawiera commity niewypchnięte na origin.

Prowadź równoległe strumienie od podziału do scalenia

Dział zatytułowany „Prowadź równoległe strumienie od podziału do scalenia”
  1. 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.
  2. 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.
  3. 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.
  4. 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:
Okno terminala
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/main zgadza się z planowaną rewizją bazową, a proces nasłuchujący na APP_PORT dział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ę .worktreeinclude i 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).
  • Testy przechodzą na serwerze sąsiedniego strumienia. Brak strictPort albo stałe URL-e w testach E2E maskują zepsuty kod. Zatrzymaj wszystkie serwery, powiąż serwery i URL-e testów ściśle z .wt-env i 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 .worktreeinclude i zautomatyzuj instalację zależności przy tworzeniu worktree.
  • Commity znikają po usunięciu odłączonego HEAD. Odzyskaj je przez git reflog przed czyszczeniem i wymagaj w prompcie startowym sprawdzenia git branch --show-current oraz 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 wykonuj git worktree prune.

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.

wcale bardzo

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.