AI-native SDLC z Codex

Ścieżka Codex wdraża sześć wspólnych etapów przez Plan mode, AGENTS.md, skille, polityki sandboxa, hooki, worktree aplikacji, wykonanie nieinteraktywne, code review oraz zadania cykliczne. Ta strona jest adapterem Codex: wskazuje właściwą funkcję dla każdej bramki i prowadzi do jednego kanonicznego opisu etapu.

Sam cykl pozostaje niezależny od narzędzia. Najpierw przeczytaj przegląd AI-native SDLC, a następnie wracaj tutaj po szczegóły wykonania w Codex.

Mapa etapów

Etap	Zaakceptowany artefakt	Funkcja Codex	Kanoniczna procedura
Plan	`intent.md`	Interaktywne `/plan`; chat aplikacji do odkrywania i kontekstu plików	Uchwyć intencję
Design	`spec.md`	`AGENTS.md`, `.agents/skills/`, MCP, obrazy i inspekcja repo	Napisz specyfikację
Build	`plan.md`, diff, testy	Worktree aplikacji lub jawny Git worktree; sandbox i polityka akceptacji CLI	Buduj z zaakceptowanego planu
Test	Dowody z testów	Aktywna pętla informacji zwrotnej; `codex exec` do powtarzalnych kontroli	Zamknij pętlę informacji zwrotnej
Deploy	Zrecenzowany pull request	`codex review`, `openai/codex-action@v1`, chroniony merge i wydanie	Warstwowe review i akceptacje
Maintain	Incydent i następny `intent.md`	Zadania cykliczne aplikacji, hooki, harmonogram CI, Slack lub Linear	Połącz produkcję z planowaniem

Skonfiguruj ścieżkę budowy

Wymagania: repozytorium Git, uwierzytelniony Codex, czysty working tree oraz instrukcje repo i komendy weryfikacyjne w AGENTS.md.

Uruchom interaktywne CLI i wejdź w Plan mode, zanim agent zacznie pracę:

codex

/plan Przeczytaj docs/intents/FUNKCJA.md i docs/specs/FUNKCJA.md. Zbadaj
repozytorium i zaproponuj plan z konkretnymi plikami, krokami test-first,
ryzykami oraz rollbackiem. Nie edytuj źródeł.

Przejrzyj plan i zapisz zaakceptowaną wersję jako docs/plans/FUNKCJA.md.
Do pracy równoległej wybierz Worktree w aplikacji Codex albo utwórz worktree poleceniem Git. Codex CLI 0.146.0 nie ma flagi --worktree.

W wybranym checkoutcie uruchom ograniczoną implementację:

Przeczytaj docs/plans/FUNKCJA.md i AGENTS.md. Zrealizuj tylko milestone 1.
Uruchom wskazany typecheck, lint, testy jednostkowe, integracyjne i wizualne.
Poprawiaj implementację; nie osłabiaj testów ani nie pomijaj bramek.
Zakończ listą plików, wynikami komend i pozostałym ryzykiem.

Przejrzyj lokalne zmiany:
Okno terminala
```
codex review --uncommitted
```
Merge i wydanie produkcyjne pozostaw za ochroną gałęzi i imienną akceptacją człowieka.

Umieść zasady we właściwej warstwie

Trwałe instrukcje repo zapisuj w AGENTS.md; bliższy plik nadpisuje reguły dla swojego poddrzewa.
Powtarzalne przepływy zapisuj w .agents/skills/NAZWA_SKILLA/SKILL.md.
Deterministyczne zachowanie cyklu umieszczaj w .codex/hooks.json albo aktywnej warstwie config.toml.
Wykonanie ograniczaj sandboxem i polityką akceptacji; sam tekst instrukcji nie jest granicą bezpieczeństwa.
Autoryzację merge i produkcji konfiguruj w repozytorium oraz platformie wdrożeniowej.

Automatyzuj ograniczone kontrole

codex exec jest stabilną komendą nieinteraktywną. Nowa automatyzacja powinna żądać najmniejszego potrzebnego zakresu sandboxa:

codex exec \
  --sandbox workspace-write \
  --output-schema .github/codex/review.schema.json \
  "Uruchom udokumentowane checki i zapisz ustrukturyzowane review bieżącego diffu."

Użyj --json, gdy odbiorca potrzebuje pełnego strumienia zdarzeń JSONL. --full-auto jest tylko przestarzałą flagą zgodności; używaj jawnego sandboxa. danger-full-access ma sens wyłącznie w osobno izolowanym runnerze.

Potwierdź działanie adaptera

codex --help, codex exec --help i codex review --help zawierają wszystkie kopiowane flagi.
/plan jest wywołane przed aktywną pracą i tworzy plan możliwy do review.
Worktree aplikacji lub Git jest widoczny w git worktree list.
codex exec używa najmniejszego sandboxa i zwraca format maszynowy, jeśli jest potrzebny.
Automatyczne review może komentować lub oblać check, ale człowiek albo polityka nadal kontroluje merge i produkcję.

Typowe awarie

Przewodnik używa codex --worktree. Tej flagi nie ma w Codex CLI 0.146.0. Użyj worktree aplikacji albo git worktree add.

Automatyzacja nadal używa --full-auto. Zastąp przestarzałą flagę przez --sandbox workspace-write, a następnie ogranicz poświadczenia i runner.

/plan jest niedostępne. Nie można zmienić trybu, gdy Codex już pracuje. Poczekaj na koniec albo przerwij turę, a potem wpisz /plan.

Kontynuuj ścieżkę

Łańcuch artefaktów Zbuduj ślad od intencji do kolejnego sygnału z produkcji.

Szybki start Codex Zainstaluj, uwierzytelnij i wykonaj pierwsze ograniczone zadanie.

Worktree Wybierz worktree aplikacji albo jawny Git worktree do pracy równoległej.

Tryb nieinteraktywny Uruchamiaj Codex w skryptach i CI z jawnym sandboxem.