Wykonaj swoje pierwsze zadanie w Codex

Pierwsze zadanie w Codex uruchamia otwarty prompt na wszystkich czterech powierzchniach: w aplikacji desktopowej ChatGPT, interfejsie CLI, rozszerzeniu IDE oraz w środowiskach Cloud. Każda powierzchnia realizuje ten sam cykl eksploracji, analizy, implementacji i testowania, napędzany przez modele takie jak GPT-5.6 Sol i GPT-6 Astra, różniąc się sposobem wizualizacji postępu, bramkowaniem uprawnień w piaskownicy (sandbox) oraz przeglądem diffa.

Ten przewodnik prowadzi przez pierwsze wieloplikowe zadanie w OpenAI Codex: znalezienie luk w obsłudze błędów, implementację poprawek, uruchomienie testów i ocenę funkcji właściwych dla danej powierzchni. Integrację z całym cyklem zespołu opisuje etap Build.

Efekty wykonania zadania

• Zrealizujesz pełne zadanie obejmujące prompt, wykonanie w piaskownicy i przegląd diffa.
• Przetestujesz ten sam prompt w aplikacji desktopowej, terminalu CLI, edytorze IDE i w chmurze.
• Zrozumiesz wpływ polityk zatwierdzania, worktree gita i granic piaskownicy na proces tworzenia kodu.
• Wykorzystasz szablony promptów do wykrywania błędów, refaktoryzacji i implementacji funkcji.

Definicja zadania

W ramach przewodnika wykonamy praktyczne zadanie: zlokalizowanie luki w obsłudze wyjątków w trasach API, wdrożenie obsługi błędów oraz zabezpieczenie poprawki dedykowanym testem automatycznym. Ćwiczenie weryfikuje odczyt plików, analizę AST, generowanie kodu, wykonywanie poleceń w piaskownicy oraz śledzenie statusu gita.

Użyj następującego promptu:

Find an error handling gap in this project's API routes: a place where an
exception could crash the server or return a misleading response. Fix it with
proper error handling and add a test that proves the fix works. Run the tests
to confirm they pass.

Prompt kładzie nacisk na mierzalny rezultat. Codex musi zbadać repozytorium, zidentyfikować faktyczny problem, zaimplementować rozwiązanie i przeprowadzić walidację. Jeśli Twój projekt nie posiada tras API, dostosuj prompt do warstwy logiki biznesowej.

Wykonanie zadania na poszczególnych powierzchniach

Aplikacja

Przepływ pracy w aplikacji desktopowej

Aby wykonać zadanie w aplikacji desktopowej:

1. Otwórz aplikację ChatGPT w trybie Codex i wybierz katalog swojego projektu.

2. Kliknij New Thread. Wybierz tryb Worktree, aby odizolować zmiany w osobnym drzewie roboczym gita, lub Local, aby modyfikować bieżący katalog.

3. Wklej prompt do okna kompozytora i naciśnij Enter.

4. Obserwuj postęp prac. Aplikacja prezentuje w czasie rzeczywistym odczyt plików, analizę zależności, modyfikacje kodu oraz uruchamianie testów. Przy konfiguracji workspace-write i zatwierdzaniu on-request rutynowe operacje w repozytorium przebiegają bez konieczności potwierdzeń.

5. Po zakończeniu pracy przejdź do panelu Review, aby ocenić pełny diff.

6. Użyj zintegrowanego terminala (Cmd+J), aby sprawdzić wyniki testów i przejrzeć zmodyfikowane pliki.

Możliwości aplikacji desktopowej:

• Wątki równoległe: Uruchamianie równoległych sesji na niezależnych worktree bez konfliktów gałęzi.
• Izolacja worktree: Zmiany pozostają w izolowanym drzewie gita, nie naruszając głównej gałęzi.
• Wprowadzanie głosowe: Przytrzymaj Ctrl+M, aby podyktować prompt.
• Powiadomienia systemowe: Alerty informują o ukończeniu długotrwałych zadań w tle.

Wskazówka

Prompt dla równoległego zadania w aplikacji desktopowej:

Review the project's README and update it to reflect current API endpoints, dependencies, and setup instructions.

CLI

Przepływ pracy w terminalu CLI

Aby wykonać zadanie w terminalu:

1. Przejdź do katalogu swojego projektu.

2. Uruchom interaktywny interfejs terminalowy Codex:

   codex --sandbox workspace-write --ask-for-approval on-request

3. Wklej treść promptu i naciśnij Enter.

4. Obserwuj strumieniowane wykonanie. Codex odczytuje pliki, analizuje kod, wprowadza zmiany i uruchamia runner testów w bezpiecznej piaskownicy.

5. Wykonaj polecenie /review, aby wywołać automatyczny przegląd kodu wprowadzonego diffa:

   /review

6. Zweryfikuj diff w gicie:

   git diff

Możliwości CLI:

• Zmiana modelu w trakcie sesji: Użyj /model, aby przełączać się między GPT-5.6 Sol, Terra lub GPT-6 Astra.
• Cofanie stanu konwersacji: Wciśnij dwukrotnie Esc w pustym kompozytorze, aby cofnąć się w historii i utworzyć nowe rozgałęzienie.
• Wykonywanie bezobsługowe: Uruchamiaj zadania nieinteraktywnie za pomocą codex exec.
• Wprowadzanie obrazów: Przeciągaj pliki zrzutów ekranu bezpośrednio do okna terminala.

Wskazówka

Polecenie do bezobsługowego uruchomienia zadania:

codex exec "Find an error handling gap in this project's API routes. Fix it and add a test."

Rozszerzenie IDE

Przepływ pracy w rozszerzeniu IDE

Aby wykonać zadanie w edytorze kodu:

1. Otwórz projekt w VS Code, Cursorze lub Windsurfie.

2. Otwórz panel boczny Codex.

3. Wybierz tryb Agent, aby nadać uprawnienia do odczytu plików, edycji kodu i uruchamiania terminala.

4. Wklej prompt do pola tekstowego i wyślij zapytanie.

5. Obserwuj zmiany nanoszone w edytorze oraz polecenia uruchamiane w zintegrowanym terminalu.

6. Przejrzyj proponowane modyfikacje za pomocą wbudowanego narzędzia Git diff.

Możliwości rozszerzenia IDE:

• Odwołania @file: Wpisz @src/routes/auth.ts, aby dołączyć kontekst konkretnego pliku do promptu.
• Synchronizacja kontekstu: Rozszerzenie synchronizuje aktualnie otwarte pliki z aplikacją desktopową.
• Delegowanie do chmury: Kliknij ikonę chmury, aby przekazać wykonanie do kontenera zdalnego.

Cloud

Przepływ pracy w chmurze

Aby wykonać zadanie w kontenerze chmurowym:

1. Przejdź pod adres chatgpt.com/codex.

2. Wybierz połączone repozytorium.

3. Kliknij New Task i wklej prompt zadania.

4. Codex uruchomi środowisko chmurowe, sklonuje repozytorium, zainstaluje zależności i rozpocznie pracę.

5. Monitoruj logi na żywo lub zamknij przeglądarkę podczas wykonywania zadania.

6. Po ukończeniu zadania przejrzyj diff w interfejsie webowym.

7. Kliknij Create PR, aby utworzyć pull request, lub pobierz gałąź lokalnie:

   git fetch && git checkout BRANCH_NAME

   Zastąp BRANCH_NAME nazwą gałęzi wygenerowanej przez Codex Cloud.

Możliwości środowiska Cloud:

• Praca w tle: Operacje wykonują się na zewnętrznej infrastrukturze, nie obciążając lokalnego komputera.
• Integracja z GitHubem: Wywołuj zadania bezpośrednio, wpisując @codex w komentarzach do issue lub pull requestów.
• Automatyczne tworzenie PR: Zadania generują gotowe pull requesty z opisem i wynikami testów.

Etapy cyklu podczas wykonania zadania

Na każdej powierzchni Codex realizuje zadanie w pięciu etapach:

1. Eksploracja: Codex analizuje strukturę repozytorium, odczytuje konfigurację i mapuje zależności modułów.

2. Analiza: Wyszukuje brakujące bloki obsługi wyjątków, porównując je ze standardami frameworka.

3. Implementacja: Modyfikuje pliki źródłowe, wprowadzając walidację danych, bloki try-catch lub handlery błędów.

4. Testowanie: Tworzy lub aktualizuje specyfikacje testowe i uruchamia runnera w piaskownicy.

5. Podsumowanie: Zwraca raport zawierający opis wykrytej luki, listę zmienionych plików oraz status testów.

Precyzja wykonania zależy od zawartości pliku AGENTS.md. Sprecyzowanie menedżera pakietów, polecenia testowego (pnpm vitest run) oraz granic architektonicznych zapobiega błędnym domysłom modelu.

Wzorce promptów do ponownego użycia

Stosuj poniższe szablony w codziennych pracach programistycznych:

Wskazówka

Prompt do wykrywania i usuwania błędów:

Scan this codebase for potential null pointer exceptions, unhandled promise rejections,
or missing error boundaries. Focus on the most critical user-facing code paths. Fix
the top 3 issues you find and add tests for each fix.

Wskazówka

Prompt do refaktoryzacji modularnej:

The authentication middleware in src/middleware/auth.ts has grown to 200+ lines.
Refactor it into smaller, testable functions. Each function must have a single
responsibility. Update existing tests to match the new structure and add tests
for any previously untested paths.

Wskazówka

Prompt do implementacji nowej funkcji:

Add rate limiting to the POST /api/login endpoint. Use a sliding window algorithm
with a limit of 5 attempts per minute per IP address. Return a 429 response with
a Retry-After header when the limit is exceeded. Add integration tests that verify
both the happy path and the rate-limited path.

Dobór powierzchni do typu zadania

Poniższa tabela przedstawia rekomendowany wybór środowiska w zależności od zadania:

Typ zadania	Rekomendowana powierzchnia	Uzasadnienie
Szybka poprawka błędu w jednym pliku	CLI lub rozszerzenie IDE	Minimalne przełączanie kontekstu i szybki czas reakcji.
Refaktoryzacja wieloplikowa	Aplikacja Desktop (tryb Worktree)	Czysta izolacja gałęzi i równoległe wątki pracy.
Długotrwała migracja	Środowisko Cloud	Działanie w tle na niezależnych zasobach obliczeniowych.
Automatyzacja pull requestów	Cloud + integracja GitHub	Bezpośrednie generowanie PR wraz z podsumowaniami.
Interaktywne debugowanie	Terminal CLI (tryb TUI)	Szybkie cofanie kroków klawiszem Esc i rozwidlenia sesji.
Prace nad interfejsem graficznym	Rozszerzenie IDE	Natychmiastowy podgląd diffa i bezpośrednia weryfikacja w edytorze.

Rozwiązywanie typowych problemów

• Codex modyfikuje niewłaściwe pliki: Zdefiniuj precyzyjne granice katalogów w pliku AGENTS.md (np. “API routes live in src/routes/, not src/api/”).
• Testy nie przechodzą po zmianach kodu: Upewnij się, że w AGENTS.md zdefiniowano dokładne polecenie uruchamiania testów (np. npm run test:unit).
• Codex zapętla się w powtarzanych próbach: Wciśnij Esc w CLI lub zatrzymaj wątek w aplikacji desktopowej. Uruchom prompt ponownie z dodatkowymi ograniczeniami.
• Zadanie w chmurze wykonuje się zbyt wolno: Zoptymalizuj skrypty inicjalizacyjne środowiska, aby zapewnić cache’owanie zależności między uruchomieniami.
• Okna zatwierdzania blokują automatyzację: Uruchamiaj CLI z flagami codex --sandbox workspace-write --ask-for-approval on-request, co pozwala na automatyczną pracę w granicach projektu przy zachowaniu kontroli nad systemem.

Weryfikacja wykonania zadania

Aby upewnić się, że zadanie zakończyło się powodzeniem:

1. Sprawdź zmodyfikowane i nowo utworzone pliki:

   git status -s

   Potwierdź, że modyfikacje objęły wyłącznie zamierzone pliki.

2. Uruchom nowo dodany test:

   npm test

   Upewnij się, że wszystkie pakiety testów przechodzą pomyślnie.

3. Wykonaj weryfikację typów i formatowania:

   npm run typecheck && npm run lint

   Upewnij się, że narzędzia nie zwracają błędów.

Kolejne kroki

AI-Native SDLC: Etap 1 - Intencja i odkrywanie Dowiedz się, jak rejestrować intent.md za pomocą polecenia Codex /plan i interaktywnego wywiadu

AI-Native SDLC: Etap 3 - Budowa i wykonanie Opanuj izolację worktree, polityki piaskownicy i bezobsługowe uruchamianie z Codex

Przegląd pracy agenta Naucz się weryfikować, dopracowywać i scalać zmiany wprowadzone przez Codex