# Plany

> Podziel pracę na kroki z bramkami i zakresem plików, żeby kilku agentów pracowało nad jednym planem naraz, i sprawdź plan z gitem.

Plan to praca dla agentów podzielona na kroki. Krok może wskazać kroki, na które czeka (jego bramki), i pliki, których dotyka (jego zakres). Dzięki temu kilku agentów może pracować nad jednym planem naraz: agent bierze krok, nikt inny go nie weźmie, a krok dotykający tych samych plików co krok w toku zostaje odrzucony.

## Kiedy z nich korzystać

Użyj planu do pracy dłuższej niż jeden commit. Do szybkiego pytania do agenta plan nie jest potrzebny.

[Screenshot: Ekran Plany z tablicą kart planów w kolumnach Do zrobienia, W toku i Zrobione, każda z rzędem znaczników kroków i nazwą pracującego agenta. Pokazane dane przykładowe są zmyślone.]

## Tablica

Otwórz **Plany** w grupie **Dokumenty** na pasku bocznym. Karty stoją w trzech kolumnach: **Do zrobienia**, **W toku** i **Zrobione**. Szukaj po nazwie albo id planu i filtruj po organizacji i repozytorium. **Pokaż zrobione** rozwija kolumnę zrobionych. Karta pokazuje znacznik każdego kroku, ile jest zamkniętych, ile wstrzymanych i kto pracuje.

## Kroki

Kliknij kartę, żeby otworzyć okno planu. Lista po lewej pokazuje kroki. Dla wybranego są trzy zakładki:

- **Treść**: czym jest krok. Agent dopisuje ją, gdy bierze krok.
- **Fakty**: status, po (bramki), dotyka (zakres plików), commity, utworzony, zamknięty, trzyma i ostatnia sesja.
- **Log**: linia, którą agent dopisuje na koniec każdego podejścia, także nieudanego, i to, co ma być dalej.

Krok ma jeden z tych statusów:

- **gotowy**: wolny, każdy może go wziąć;
- **w pracy**: ktoś go trzyma;
- **wstrzymany**: utknął, plan na niego czeka;
- **zamknięty**: zrobiony, są za nim commity;
- **sprawdzony**: zrobiony i ktoś to sprawdził;
- **porzucony**: nie powstanie, plan idzie dalej bez niego.

Zamknięcie kroku otwiera to, co na niego czekało.

## Dodawaj i zmieniaj kroki

1. Kliknij **Nowy plan** na tablicy, a potem **Dodaj krok** w oknie planu.
2. Żeby zmienić status ręcznie, użyj pola **Status kroku**. Jeśli krok trzyma agent, DevHub ostrzega: zmiana statusu zabiera mu claim, a agent nie dostaje żadnej wiadomości.
3. **Zwolnij krok** zabiera go agentowi, z tym samym ostrzeżeniem.

**Usuń plan** kasuje plan z jego krokami i ich historią. Tego nie da się cofnąć, a agent, który trzyma krok, nie dostaje wiadomości.

## Sprawdź plan z gitem

**Sprawdź z gitem** porównuje to, co plan twierdzi, z commitami repozytorium. Commit liczy się dla kroku, gdy jego opis niesie trailer kroku. Sprawdzenie wskazuje:

- kroki **zamknięte bez śladu w repozytorium**, które nie mają commita;
- **pracę, której nikt nie policzył**, czyli commity wskazujące krok, który nie jest zamknięty.

Jeśli żaden commit nie niesie trailera kroku, nic nie da się sprawdzić, i okno to mówi.

> **Uwaga:** Trailer kroku to linia na końcu opisu commita, która podaje id kroku. Plan prowadzony z agentem
> zwykle pilnuje go za Ciebie.

## Przekaż go agentowi

Agent pracuje przez narzędzia `plan_status`, `plan_ready`, `plan_claim`, `step_log`, `plan_close` i inne z [katalogu](/pl/devhub/reference/mcp-tools/index.md). **Kopiuj wywołanie** kopiuje wywołanie `plan_status()`, a ikona kolejki dodaje plan do [Kontekstu AI](/pl/devhub/features/ai-context/index.md).

## Powiązane

- [Analizy](/pl/devhub/features/investigations/index.md)
- [Agenci](/pl/devhub/features/agents/index.md)
- [Kontekst AI](/pl/devhub/features/ai-context/index.md)