Refaktoryzacja i ulepszanie istniejącego kodu
Na tej stronie
Transformacja starego kodu w nowoczesny
Refaktoryzacja to jedno z najbardziej czasochłonnych zadań w procesie wytwórczym, a rzadko najbardziej doceniane: nikt nie gratuluje Ci podziału pliku liczącego 800 linii. Właśnie dlatego techniczny dług narasta z sprintu na sprint, aż staje się rzeczywistą przyczyną spowolnienia pracy. Codex redukuje godziny ręcznej pracy do minut, zachowując przy tym istniejące zachowanie systemu – co jest jedynym aspektem mającym znaczenie podczas refaktoryzacji.
Refaktoryzacja strukturalna
Najczęstszym przypadkiem jest plik typu „wszystko w jednym“, którego nikt nie odważa się dotknąć, ponieważ jest importowany w całym projekcie.
"Refactor src/utils/helpers.ts: this file is 800 lines long.
Split it into thematic modules in src/utils/ (string.ts,
date.ts, validation.ts, formatting.ts). Update all imports
across the project."
Codex wyjątkowo dobrze radzi sobie z tego typu zadaniami: identyfikuje funkcje, grupuje je tematycznie, tworzy nowe pliki, a następnie aktualizuje wszystkie importy w projekcie. To właśnie ten ostatni krok najczęściej zniechęca do ręcznej refaktoryzacji – czterdzieści plików do poprawy, jeden pominięty import i kompilacja przerywa się w najgorszym możliwym momencie. Wynik jest przy tym obiektywnie weryfikowalny: jeśli testy przechodziły wcześniej i nadal przechodzą, podział został wykonany poprawnie.
Modernizacja kodu
Drugim głównym przypadkiem jest aktualizacja do nowoczesnych wzorców, gdzie transformacja ma charakter mechaniczny, lecz jest tak powtarzalna, że ciągle ląduje na końcu listy zadań (backlogu).
"Migrate all callbacks in src/lib/database.ts to
async/await. Preserve existing error handling."
Punktem wyjścia jest JavaScript oparty na callbackach z kaskadową obsługą błędów:
function getUser(id, callback) {
db.query("SELECT * FROM users WHERE id = ?", [id],
(err, rows) => {
if (err) return callback(err);
callback(null, rows[0]);
});
}
Oto wynik generowany przez Codex:
async function getUser(id: string): Promise<User> {
const rows = await db.query(
"SELECT * FROM users WHERE id = ?",
[id]
);
return rows[0];
}
W jednym przebiegu zaszły trzy zmiany: pojawiły się typy TypeScript, callbacki ustąpiły miejsca konstrukcji async/await, a obsługa błędów uległa uproszczeniu, gdyż wyjątki są teraz propagowane w sposób naturalny. Logika biznesowa pozostaje identyczna – i to właśnie ją weryfikujesz podczas przeglądu kodu, a nie elegancję samego wyniku.
Poprawa jakości
Możesz również skupić się na konkretnym wymiarze jakości, a nie na transformacji składniowej, pod warunkiem że szczegółowo wymienisz wymagania.
"In src/api/, improve error handling:
- Replace generic try/catch blocks with typed errors
- Add appropriate HTTP error codes
- Add logging with request context
- Ensure Prisma errors are mapped correctly"
Sformułowane w ten sposób żądanie staje się weryfikowalne punkt po punkcie podczas przeglądu. Samodzielny prompt typu „popraw obsługę błędów“ wygenerowałby coś, co brzmi prawdopodobnie, ale jest nieużyteczne, ponieważ ani Ty, ani agent nie wiedzielibyście, kiedy cel został osiągnięty.
Refaktoryzacja oparta na wzorcach
Najpotężniejszą odmianą jest wskazanie pliku, który już spełnia wymagania, i poproszenie o uogólnienie tego podejścia.
"All React components in src/components/ that use
useState for forms must migrate to react-hook-form.
Apply the same pattern as src/components/LoginForm.tsx,
which is already migrated."
Codex odczytuje komponent referencyjny, ekstrahuje z niego wzorzec i aplikuje go do docelowych komponentów, uwzględniając przypadki brzegowe – takie jak walidacja niestandardowa czy efekty uboczne – zamiast dokonywać ślepej zamiany. Praktyczny wniosek jest interesujący: pierwszy komponent, który migrujesz samodzielnie, „opłaca“ wszystkie kolejne. Zainwestuj czas i uwagę w ten plik wzorcowy; jest on wart równowartości specyfikacji technicznej.
Weryfikacja refaktoryzacji
Codex uruchamia testy po każdej refaktoryzacji, jednak refaktoryzacja, która przechodzi testy, niekoniecznie nadaje się do wdrożenia. Cztery sprawdzenia stanowią absolutne minimum, a każde z nich adresuje inne ryzyko.
| Sprawdzenie | Polecenie | Co weryfikuje |
|---|---|---|
| Testy jednostkowe | npm run test | Zachowanie zostało zachowane |
| Typy | npx tsc --noEmit | Brak błędów typowania |
| Linting | npm run lint | Przestrzeganie konwencji |
| Kompilacja | npm run build | Gotowość produkcyjna |
Typowy przypadek uzasadniający tę listę: przeniesienie plików pozostawia testy „zielone“, ponieważ importują one z pliku zbiorczego (barrel file), ale powoduje awarię kompilacji produkcyjnej na skutek cyklicznego importu, którego nic innego nie ujawnia. Dodaj te cztery polecenia do swojego pliku AGENTS.md, a Codex będzie je uruchamiał po każdej zmianie, bez konieczności Twojego przypominania czy myślenia o tym.
Kluczowe wnioski
- Refaktoryzacja to zadanie, w którym Codex przynosi największe oszczędności czasu
- Odwołuj się do pliku wzorcowego, aby kierować wzorcem refaktoryzacji
- Codex aktualizuje importy i odniesienia w całym projekcie
- Zawsze weryfikuj zmiany za pomocą testów, sprawdzania typów i kompilacji po refaktoryzacji
- Udokumentuj polecenia weryfikacyjne w pliku AGENTS.md