Przejdź do głównej zawartości

Szybkie efekty w pierwszych 24 godzinach

Szybkie efekty z Claude Code, Codeksem i Cursorem to dziesięć technik na pierwszy dzień, które zwracają się w kilka minut. Pięć nie wymaga konfiguracji (wyjaśnianie kodu, testy charakteryzujące, poprawki zaczynające się od testu, refaktoryzacja za bramką testów i przegląd przed pushem), a pięć wymaga 10–30 minut przygotowania. Każda łączy gotowy prompt z kontrolą potwierdzającą wynik bez czytania każdej linii.

Ta strona jest dla dewelopera, który wczoraj zainstalował agenta i jeszcze nie powierzył mu prawdziwej pracy. Za godzinę masz standup, w repozytorium leży moduł bez żadnego testu, a w logach czeka stack trace z wczorajszego wdrożenia. Poniższe prompty działają na tym kodzie już dziś, a każdy kończy się dowodem, który sprawdzisz w niecałą minutę: testem, który najpierw był czerwony, a potem zielony, wskazanym numerem linii albo raportem z przeglądu.

Nie masz jeszcze agenta? Zacznij od szybkiego startu Claude Code, Codeksa albo Cursora.

  • Pięć promptów, które działają na twoim prawdziwym repozytorium bez żadnej konfiguracji poza instalacją
  • Pięć jednorazowych przygotowań — plik instrukcji, aktualna dokumentacja bibliotek, praca od planu, skill wielokrotnego użytku i równoległe worktree — które poprawiają każde kolejne zadanie
  • Nawyk weryfikacji dla każdej techniki, dzięki któremu oceniasz agenta po dowodach, a nie po ponownym czytaniu jego diffu
  • Punkt odniesienia, z którym jutro porównasz wyniki, zamiast polegać na wrażeniu

Zacznij od czystego drzewa roboczego Gita (git status nie pokazuje nic do zatwierdzenia). Czyste drzewo to twój przycisk „cofnij”: cokolwiek zrobi agent, git diff to pokaże, a git restore . usunie.

Pierwszego dnia zostań przy domyślnym modelu narzędzia. Zasada tego serwisu: zacznij od domyślnego modelu, najpierw podnieś poziom wysiłku (effort), a model zmieniaj dopiero wtedy, gdy wskażą to twoje własne wyniki. Aktualne domyślne modele i ceny znajdziesz w przeglądzie modeli.

  1. W terminalu, w katalogu głównym repozytorium, uruchom claude.
  2. Uruchom /init. Claude Code zapisze CLAUDE.md z opisem projektu, jego poleceń i konwencji. Przeczytaj go od razu; Efekt 6 go ulepszy.
  3. Sprawdź tryb uprawnień w stopce; Shift+Tab przełącza między trybami, m.in. Manual, Accept edits, Plan i Auto. Manual pyta, zanim Claude edytuje plik lub uruchomi polecenie.
  4. Zapytaj What is this project, and which commands build, test and lint it? Poprawna odpowiedź oznacza, że agent umie uruchomić twoje kontrole, a od tego zależy każda technika poniżej.

Te pięć promptów jest takich samych we wszystkich trzech narzędziach. Wklej je do sesji Claude Code lub Codeksa albo do panelu Agent w Cursorze. Zamień ścieżki plików na prawdziwy plik z twojego repozytorium.

Funkcja na 200 linii z niejasnymi nazwami to problem czytania, nie pisania, więc agent ma tu tylko czytać. Weryfikacja jest wbudowana w prompt: każde twierdzenie musi wskazywać linię, a ty sprawdzasz dwie z nich.

Sprawdź: otwórz dwie wskazane linie. Jeśli którakolwiek nie mówi tego, co twierdzi agent, odrzuć wyjaśnienie i zapytaj ponownie o mniejszy fragment.

Efekt 2: utrwal obecne zachowanie testami charakteryzującymi

Dział zatytułowany „Efekt 2: utrwal obecne zachowanie testami charakteryzującymi”

Testy dla nieprzetestowanego kodu to dobre pierwsze zadanie, bo każda późniejsza zmiana staje się sprawdzalna. Poproś o testy, które zapisują to, co kod robi teraz, łącznie z błędami, a nie to, co powinien robić.

Sprawdź: ostatni krok to jednolinijkowy test mutacyjny. Jeśli po zmianie kodu żaden test nie zaświeci się na czerwono, zestaw jest ozdobą. Pełną technikę opisuje przewodnik po testach charakteryzujących.

Efekt 3: napraw błąd ze stack trace’u, zaczynając od testu

Dział zatytułowany „Efekt 3: napraw błąd ze stack trace’u, zaczynając od testu”

Wklejenie stack trace’u z prośbą o poprawkę działa, ale poprawka jest udowodniona dopiero wtedy, gdy wcześniej test odtworzył błąd. Kolejność ma znaczenie: czerwony, poprawka, zielony.

Zamień PASTE_STACK_TRACE_HERE na pełny stack trace, razem z liniami z twojego własnego kodu. Przed wklejeniem usuń ze stack trace’u tokeny, adresy e-mail i identyfikatory klientów.

Sprawdź: potrzebujesz dwóch wyników: nowego testu, który nie przechodzi przed poprawką, i całego zestawu, który przechodzi po niej. Poprawka bez wcześniejszego czerwonego testu mogła naprawić inny problem.

Efekt 4: zrefaktoryzuj długą funkcję za bramką testów

Dział zatytułowany „Efekt 4: zrefaktoryzuj długą funkcję za bramką testów”

Refaktoryzacja jest bezpieczna, gdy zachowanie zostało utrwalone, zanim zmieni się struktura. Prompt każe agentowi najpierw zbudować to zabezpieczenie, jeśli go brakuje.

Sprawdź: te same testy przechodzą przed zmianą i po niej, a sprawdzenie typów i linter są czyste. Oceniasz kształt nowych funkcji, a nie każdą przeniesioną linię.

Zanim zmianę zobaczy człowiek, niech przejrzy ją agent. Wbudowane polecenia przeglądu czytają diff i zgłaszają uwagi z odwołaniem do pliku i linii.

Uruchom w sesji /code-review, żeby przejrzeć bieżące zmiany. /security-review robi przegląd skupiony na bezpieczeństwie.

Sprawdź: popraw każdą uwagę o wysokiej wadze albo zapisz, dlaczego jest błędna. Przegląd, który na dużym diffie nie znajduje niczego, to sygnał, żeby zapytać ponownie o węższy zakres.

Reszta dnia: pięć efektów, które wymagają 10–30 minut przygotowania

Dział zatytułowany „Reszta dnia: pięć efektów, które wymagają 10–30 minut przygotowania”

Te techniki wymagają jednorazowej inwestycji i poprawiają każde kolejne zadanie. Wykonaj je w tej kolejności: plik instrukcji najpierw, bo czyta go każda późniejsza technika.

Efekt 6: dopracuj plik instrukcji, który agent czyta w każdej sesji

Dział zatytułowany „Efekt 6: dopracuj plik instrukcji, który agent czyta w każdej sesji”

Plik z /init to szkic. Staje się użyteczny, gdy zawiera zasady, których agent nie wywnioskuje z kodu: które polecenia dowodzą poprawności zmiany, których katalogów nie ruszać i co znaczy „gotowe”.

Claude Code czyta CLAUDE.md na początku każdej sesji. Od wersji 2.1.277 (kanał latest) czyta też AGENTS.md, gdy projekt nie ma CLAUDE.md, więc repozytorium dzielone z użytkownikami Codeksa może mieć jeden plik.

Sprawdź: każde polecenie w pliku zadziałało w trakcie tego promptu. Krótszy, zweryfikowany plik jest lepszy od długiego i zgadywanego; zobacz przycinanie plików kontekstu.

Efekt 7: daj agentowi aktualną dokumentację bibliotek przez Context7

Dział zatytułowany „Efekt 7: daj agentowi aktualną dokumentację bibliotek przez Context7”

Modele znają API bibliotek ze stanu z danych treningowych. Serwer MCP Context7 od Upstash pobiera na żądanie dokumentację dla konkretnej wersji. Serwer działa bez klucza API; darmowy klucz podnosi limity.

Okno terminala
claude mcp add --scope user --transport http context7 https://mcp.context7.com/mcp

Żeby dodać klucz, najpierw usuń wpis bez klucza (claude mcp remove context7 albo codex mcp remove context7) i odczytaj klucz ze zmiennej środowiskowej, którą wypełnia twój magazyn sekretów. Nigdy nie wpisuj samego klucza w polecenie:

Okno terminala
# Claude Code: powłoka rozwija zmienną, a zakres user zapisuje wartość w twojej konfiguracji użytkownika, nie w repozytorium
claude mcp add --scope user --header "Authorization: Bearer $CONTEXT7_API_KEY" --transport http context7 https://mcp.context7.com/mcp
# Codex: zapisuje tylko nazwę zmiennej i odczytuje klucz przy połączeniu
codex mcp add context7 --url https://mcp.context7.com/mcp --bearer-token-env-var CONTEXT7_API_KEY

W Cursorze wpis z kluczem umieść w swoim pliku użytkownika ~/.cursor/mcp.json, a nie w pliku projektu. Nigdy nie commituj klucza do .cursor/mcp.json ani .mcp.json: oba leżą w repozytorium, więc klucz trafiłby do historii Gita.

Potem nazwij w prompcie bibliotekę i wersję: Use Context7 to check the current Next.js routing API for the version in package.json before you change this file.

Każdy serwer MCP dokłada narzędzia, spośród których agent musi wybierać, a w niektórych klientach także ich definicje w kontekście, więc dodawaj serwery pojedynczo, gdy zadanie ich wymaga. Przewodnik po Context7 opisuje przypinanie identyfikatora biblioteki i tryb CLI bez MCP.

Efekt 8: zaplanuj funkcję i uzgodnij kryteria akceptacji przed kodem

Dział zatytułowany „Efekt 8: zaplanuj funkcję i uzgodnij kryteria akceptacji przed kodem”

Przy wszystkim większym niż poprawka błędu każ agentowi najpierw zaplanować pracę i spisać kryteria akceptacji, które da się sprawdzić. Zatwierdzasz trzy strony planu zamiast przeglądać trzysta linii błędnego kodu.

Włącz tryb Plan poleceniem /plan albo klawiszami Shift+Tab i wklej prompt. Agent czyta i planuje, ale niczego nie edytuje.

Sprawdź: każde kryterium akceptacji ma w końcowej zmianie co najmniej jeden test, a testy przeszły. To powiązanie zatwierdzasz. Przewodnik po kryteriach akceptacji pokazuje, jak pisać kryteria, których agent nie zrozumie źle.

Do popołudnia wkleisz prompt przeglądu z Efektu 5 trzy razy. Skill zamienia go w nazwany, wersjonowany plik, który agent wczytuje, gdy go potrzebuje. Skille korzystają z otwartego formatu Agent Skills (katalog z plikiem SKILL.md), który obsługują wszystkie trzy narzędzia.

Utwórz .claude/skills/pre-push-review/SKILL.md:

---
name: pre-push-review
description: Review uncommitted changes for bugs, missing error handling, security issues and untested behaviour changes before a push.
---
Review the uncommitted changes as a strict senior reviewer.
Report only real problems, each with file, line, severity (high, medium, low) and a one-line fix.
Do not edit files. If nothing is above low severity, say so in one line.

Wywołaj go przez /pre-push-review albo pozwól Claude Code wczytać go, gdy prośba pasuje do opisu. Zatwierdź katalog w repozytorium, żeby dostał go cały zespół.

Sprawdź: uruchom skill na diffie ze znanym błędem, na przykład z usuniętym sprawdzeniem null. Jeśli raport go nie wychwyci, zaostrz treść skilla, zanim zaczniesz na nim polegać. Skille społeczności instaluje się poleceniem npx skills add OWNER/REPO; przeczytaj SKILL.md przed instalacją, bo skill to instrukcje, które twój agent wykona.

Efekt 10: uruchamiaj niezależne zadania równolegle w worktree

Dział zatytułowany „Efekt 10: uruchamiaj niezależne zadania równolegle w worktree”

Trzy niezwiązane zadania — funkcja, poprawka błędu i aktualizacja dokumentacji — nie muszą na siebie czekać. Każdy agent dostaje własne worktree Gita, więc ich zmiany się nie zderzają, a każda trafia na osobną gałąź.

Okno terminala
# Terminal 1
claude --worktree order-emails
# Terminal 2
claude --worktree token-refresh-fix
# Terminal 3
claude --worktree api-docs

Każda sesja działa we własnej kopii roboczej, na własnej gałęzi.

Sprawdź: praca równoległa mnoży ilość przeglądów, więc każde zadanie przechodzi przez bramkę, zanim na nie spojrzysz: testy, sprawdzenie typów i linter muszą przejść na gałęzi. Scal gałąź z zielonymi kontrolami; pozostałe odeślij z wynikiem, który nie przeszedł. Zacznij od dwóch zadań, nie od pięciu. Narzędzia na dalsze dni opisuje strona agenci równolegli.

Za każdą techniką stoi ten sam nawyk: poproś o dowód, a potem sprawdzaj dowód zamiast kodu. Ta tabela to cały proces przeglądu na pierwszy dzień.

EfektDowód, który sprawdzaszCzas sprawdzenia
1. Wyjaśnienie koduDwa wskazane numery linii zgadzają się z twierdzeniami1 minuta
2. Testy charakteryzująceTesty przechodzą, a jedna celowa mutacja sprawia, że test przestaje przechodzić1 minuta
3. Poprawka błęduNowy test nie przechodzi przed poprawką, cały zestaw przechodzi po niej1 minuta
4. RefaktoryzacjaTe same testy zielone przed i po; typy i linter czyste1 minuta
5. PrzeglądKażda uwaga o wysokiej wadze poprawiona albo odrzucona z uzasadnieniem5 minut
6. Plik instrukcjiKażde wymienione polecenie zadziałało w trakcie promptu2 minuty
7. Dokumentacja bibliotekWygenerowany kod kompiluje się z zainstalowaną wersją biblioteki (sprawdzanie typów przechodzi)1 minuta
8. Zaplanowana funkcjaKażde kryterium akceptacji ma przechodzący test5 minut
9. SkillRaport skilla wykrywa podłożony błąd (usunięte sprawdzenie null)2 minuty
10. Praca równoległaKontrole zielone na każdej gałęzi, zanim otworzysz diff1 minuta na gałąź

Za to, co scalasz, nadal odpowiadasz ty. Dowody mówią ci, gdzie poświęcić czas na czytanie: na uwagę zgłoszoną przez recenzenta, test, który trudno było napisać, i plik, który zmienił kształt. Strona dowody zamiast diffów zamienia ten nawyk w metodę pracy.

Wrażenie szybkości to nie pomiar. Badania kontrolowane nie są zgodne: kontynuacja badania METR z końca 2025 roku z deweloperami open source dała szacunki punktowe o około 18% krótszego czasu pracy z AI u powracających deweloperów i 4% u nowo zrekrutowanych, ale oba przedziały ufności obejmują zero, a METR zaznacza, że wyniki trudno interpretować (METR, opublikowane 24.02.2026). Jedyne liczby, które dotyczą twojej bazy kodu, to twoje własne.

Co zapisaćJakCo ci to mówi
Zamknięte zadaniaPolicz zadania scalone dziś i w zwykły dzień w zeszłym tygodniuPrzepustowość
Czas na zadanieGodzina rozpoczęcia i zakończenia dla trzech do pięciu zadańGdzie agent pomaga, a gdzie nie
PoprawkiZmiany wycofane lub ponownie otwarte w ciągu tygodniaCzy szybkość kosztowała jakość
PokrycieZmierz pokrycie testami przed Efektem 2 i na koniec dniaCzy sprawdzalna powierzchnia urosła
  • Agent edytuje pliki, o które nie prosiłeś. Uruchom git diff --stat, żeby zobaczyć zasięg zmian, i git restore <path>, żeby odrzucić niechciane pliki. W Claude Code Esc Esc (albo /rewind) cofa sesję do wcześniejszego checkpointu. Potem dopisz zakazane ścieżki do pliku instrukcji (Efekt 6).
  • Testy przechodzą, ale zachowanie jest złe. Agent napisał testy dopasowane do własnej implementacji. Powtórz krok z mutacją z Efektu 2; jeśli żaden test nie przestanie przechodzić, spisz kryteria akceptacji samodzielnie (Efekt 8) i poproś o testy na ich podstawie, bez pokazywania implementacji.
  • Agent zmienił istniejący test, żeby przeszedł. Odrzuć zmianę i przywróć plik testu. Dopisz do pliku instrukcji Never edit an existing test to make it pass; report the conflict instead. Przewodnik chroń wyrocznię pokazuje, jak wymusić to hookami i w CI.
  • Kod używa API, które już nie istnieje. Zainstaluj Context7 (Efekt 7) i podaj w prompcie wersję biblioteki. Jeśli błąd się powtarza, wklej do promptu odpowiedni fragment changeloga biblioteki.
  • Agent powtarza ten sam błąd. Kontekst sesji jest zaśmiecony nieudanymi próbami. Zacznij od nowa (/clear w Claude Code, /new w Codeksie, nowy czat w Cursorze) i powtórz zadanie z ograniczeniem, które agent ciągle łamał.
  • Równoległe gałęzie konfliktują przy scalaniu. Zadania nie były niezależne. Najpierw scal gałąź z najmniejszym diffem, a potem poproś drugiego agenta o rebase na nią i ponowne uruchomienie kontroli.