Cursor IDE: edytor kodu AI

Cursor to edytor kodu AI zbudowany na VS Code. Jego agent planuje, edytuje wiele plików, uruchamia polecenia w terminalu i przygotowuje pull requesty — na twoim komputerze lub jako Cloud Agents w chmurze. Ten przegląd Cursora kieruje deweloperów i tech leadów do właściwego przewodnika i pokazuje, jak jedna zmiana trafia do scalonego pull requesta z dowodami.

Poprosiłeś agenta o poprawkę, zmienił 11 plików, a pull request czeka teraz, aż przeczytasz każdą linijkę. Cursor przyspieszył pisanie zmiany; ten przewodnik pokazuje, jak przyspieszyć też zaufanie do niej.

Która powierzchnia Cursora pasuje do zadania?

Wybierz najmniejszą powierzchnię, która domknie zadanie: każdy krok w górę autonomii wymaga mocniejszej kontroli na końcu.

Powierzchnia	Kiedy jej używać	Czym udowodnić wynik	Przewodnik
Uzupełnianie Tab i edycja inline	Znasz zmianę i chcesz ją szybciej wpisać	Rzut oka na kilka linijek, potem kontrola typów	Uzupełnianie Tab, edycja inline
Agent lokalnie	Zmiana obejmuje kilka plików, a ty potrafisz nazwać test akceptacyjny	Testy i lint uruchomione przez agenta, potem CI	Praca z agentem
Plan Mode	Zmiana jest ryzykowna lub niejasna	Przeglądasz plan, nie kod	Tryby agenta
Worktrees	Chcesz równoległych prób, każdej we własnym checkoucie Gita	Osobny przebieg testów dla każdej próby; porównujesz wyniki	Checkpointy i gałęzie; zobacz też przewodnik po oknie Agents
Cloud Agents i Automations	Praca rusza bez ciebie: z issue, według harmonogramu lub po zdarzeniu	Wymagane CI i review na pull requeście	Cloud Agents i Automations
Bugbot oraz PR Routing & Approval	Review ma się zacząć, zanim człowiek otworzy diff	Uwagi Bugbota plus twoje reguły zatwierdzania; merge należy do człowieka	Bugbot, PR Routing & Approval

Plan Mode według dokumentacji Cursora „tworzy szczegółowe plany implementacji, zanim powstanie jakikolwiek kod”, a worktrees pozwalają agentowi „pracować w izolowanych checkoutach Gita” (sprawdzone 28 sierpnia 2026 r.). Konwencje projektu trzymaj w regułach Cursora, powtarzalne procedury w Agent Skills, a zewnętrzne systemy za serwerami MCP — wtedy prompty są krótkie.

Przeprowadź jedną zmianę od planu do pull requesta

To wersja niezależnego od narzędzia cyklu AI-native dla Cursora. Artefakt każdego etapu leży w docs/<rodzaj>/FEATURE.md.

Warunki wstępne: repozytorium Git z czystym drzewem roboczym, zalogowany Cursor, prawdziwe polecenia testów, lintu i kontroli typów w regule projektu oraz intencja i specyfikacja zmiany w docs/intents/FEATURE.md i docs/specs/FEATURE.md (zobacz Uchwyć intencję i Napisz specyfikację).

Przełącz agenta w Plan Mode i wklej prompt planowania poniżej. Prompt zabrania agentowi edytowania plików.
Zapisz plan w docs/plans/FEATURE.md (wklej go sam albo napisz agentowi „write the accepted plan to docs/plans/FEATURE.md and nothing else”), wytnij wszystko, o co nie prosiłeś, i zacommituj plik.
Uruchom implementację w worktree, żeby nieudana próba nigdy nie dotknęła głównego checkoutu. Utwórz go w terminalu na nowej gałęzi, otwórz ten folder w Cursorze i zainstaluj w nim zależności:
Okno terminala
```
git worktree add -b FEATURE ../FEATURE_CHECKOUT
```
FEATURE_CHECKOUT to nowy folder obok repozytorium. Cursor potrafi też sam tworzyć worktrees dla agentów; zobacz checkpointy i gałęzie. Sprawdź, że checkout istnieje:
Okno terminala
```
git worktree list
```
Wklej prompt implementacji poniżej do agenta pracującego w tym worktree.
Otwórz pull request. Poczekaj, aż CI i Bugbot skończą, zanim spojrzy na niego człowiek, a potem scal go na podstawie dowodów opisanych niżej.

Read docs/intents/FEATURE.md and docs/specs/FEATURE.md, then inspect the code they touch.
Do not edit any file. Propose an ordered plan in milestones. For each milestone list:
the files it changes, the test that will prove it (name the test file and the behaviour
it asserts), the risk, and how to roll it back. End with open questions I must answer
before you start. Flag anything in the spec that the current code contradicts.

W obu promptach zastąp FEATURE slugiem funkcji.

Implement only milestone 1 of docs/plans/FEATURE.md, following the project rules.
Write or update the tests for the milestone first and show them failing.
Then implement until the project's type check, lint and full test suite pass.
Do not delete, skip or weaken an existing test or assertion to get to green; if one
looks wrong, stop and tell me why. Finish with: changed files, every command you ran
with its exit code, and any risk you could not test.

Jak zaufać zmianie z Cursora bez czytania każdej linijki?

Przenieś sprawdzanie z własnych oczu na bramki, które działają przy każdej zmianie. Pakiet dowodów określa, co musi zawierać pull request; w Cursorze pochodzi on z czterech źródeł:

Najpierw testy. Agent pokazuje nieprzechodzący test przed poprawką, więc zielony wynik oznacza, że zmieniło się zachowanie.
Maszynowe bramki w CI. Kontrola typów, lint i testy to wymagane status checki. Przebieg agenta to tylko podgląd; wiążący jest wynik CI.
Review przed człowiekiem. Bugbot według dokumentacji Cursora „przegląda pull requesty i znajduje błędy, problemy bezpieczeństwa i problemy z jakością kodu” (sprawdzone 28 sierpnia 2026 r.). PR Routing & Approval przydziela recenzentów według własności kodu i może zatwierdzać pull requesty niskiego ryzyka spełniające twoje kryteria.
Podpis konkretnej osoby. Merge do chronionych gałęzi wymaga imiennie wskazanego zatwierdzającego, który czyta plan, nazwy testów i wynik CI, a diff otwiera tylko tam, gdzie dowodów jest za mało.

Pełny wywód znajdziesz w tekście dowody zamiast czytania kodu.

Co psuje się na początku pracy z Cursorem?

Agent zamienia czerwony test na zielony, zmieniając sam test. Jak to naprawić: odrzuć zmianę, przywróć test z Gita i uruchom ponownie z promptem implementacji, który tego zabrania. Ten sam zakaz wpisz do reguły projektu.

Polecenia uruchamiane bez nadzoru docierają do czegoś destrukcyjnego. Jak to naprawić: zanim pozwolisz agentowi uruchamiać polecenia bez pytania, przejrzyj ustawienia Run modes (sekcja Agent security w dokumentacji Cursora), a skrypty wdrożeń, migracji i usuwania danych trzymaj poza wszystkim, co jest zatwierdzane automatycznie.

Zmian agenta nie da się czysto cofnąć. Nie polegaj wyłącznie na historii cofania w edytorze ani na checkpointach: przed dużym zadaniem agenta zrób commit, żeby Git trzymał punkt przywracania, nad którym masz kontrolę.

Dokąd dalej w przewodniku po Cursorze

Zaczynasz z Cursorem? Przejdź przez szybki start, a potem ścieżkę dewelopera. Prowadzisz zespół? Przeczytaj Cursor w zespole.

Planowanie Od pomysłu do intencji, specyfikacji i zaakceptowanego planu.

Budowanie Agent, edycja inline, worktrees i praca z dużym kodem.

Testowanie i debugowanie Pętle agenta zaczynające się od testów i polowanie na błędy.

Code review i wdrożenie Bugbot, reguły zatwierdzania, CI i wydania.

Eksploatacja Bezpieczeństwo, monitoring i zużycie tokenów na produkcji.

Automatyzacja Cloud Agents, Automations, własne serwery MCP i SDK.

Zespół i firma Wspólne reguły, prywatność i wdrożenie w zespole.

Materiały referencyjne Changelog, skróty klawiszowe i przewodniki aktualizacji.

Ten sam cykl działa w Claude Code i Codeksie; triki dla zaawansowanych obejmują wszystkie trzy narzędzia.