Masz funkcję PHP formatującą sumę zamówienia i chcesz sprawdzić jej działanie na różnych danych wejściowych. CycleMantle działa jako generator danych: zapisuje plik JSON z wymyślonymi zamówieniami, a następnie tworzy sprawdzenia, które go odczytują. Żadne dane nie są kopiowane od rzeczywistych klientów. Przy modelu w chmurze Twoje polecenie i tekst pliku odczytywany przez agenta trafiają do dostawcy; przy modelu lokalnym nic nie opuszcza Twojego komputera. Planuj około cztery krótkie wiadomości: otwórz folder, poproś o rekordy, poproś o sprawdzenia i uruchom je. Każda wiadomość generuje karty, które możesz przeczytać, zaakceptować lub odrzucić przed rozpoczęciem kolejnej. Czytaj karty od góry do dołu: każda wskazuje narzędzie, plik lub polecenie, którego użyła, oraz otrzymany wynik. Jeśli wolisz czytać przed uruchomieniem czegokolwiek, rozpocznij czat w trybie Plan only i przełącz się na Ask first po przeczytaniu planu.
01
Otwórz folder projektu
Uruchom aplikację, wybierz folder zawierający kod PHP i wybierz Ask first jako tryb zatwierdzania, aby każda zmiana czekała na Twoją decyzję. Tryb możesz zmienić później w dowolnym momencie, na przykład na Auto-run, gdy będziesz już pewien kroków.
02
Poproś o wymyślone rekordy
Opisz potrzebne pola, takie jak imię, data i kwota, i poproś o plik JSON z wymyślonymi wierszami. Podaj, ile wierszy chcesz. Upewnij się, że każda nazwa, adres i kwota są wyraźnie fikcyjne, aby nikt nie pomylił wiersza z prawdziwą osobą.
03
Poproś o sprawdzenia
Poproś o mały skrypt testowy, który odczyta plik JSON i porówna znane dane wejściowe z oczekiwanymi wynikami. Podaj nazwę funkcji, którą należy przetestować. Poproś agenta o wyjaśnienie każdego sprawdzenia jednym zdaniem, aby wiedzieć, co ma wykryć.
04
Przejrzyj i uruchom
Przejrzyj diff, zaakceptuj go i pozwól Shell uruchomić polecenie testowe. Następnie przeczytaj kod wyjścia i rozwiń kartę, aby zobaczyć wynik. Jeśli sprawdzenie nie przejdzie, poproś agenta o wyjaśnienie przyczyny awarii przed wprowadzeniem jakichkolwiek zmian.
Mały skrypt testowy do rozpoczęcia
CycleMantle · Fixture i sprawdzenia● Ask first
Napisz tests/orders.json z 3 wymyślonymi zamówieniami i skryptem sprawdzającym funkcję rabatową.
write_filetests/orders.jsonsaved
write_filetests.phpsaved
Shellyour test commandexit 0
read_filetests.phploaded
oczekiwanie na Twoją zgodę przed wykonaniem kolejnego krokuOdrzućAkceptuj
Jedna prosta funkcja i cztery asercje z znanymi danymi wejściowymi i wynikami. Nie używa bazy danych, sieci ani sekretów. Później agent może zamienić stałe liczby na wiersze z Twojego pliku JSON, a sprawdzenia zachową tę samą strukturę. Celowo zmień jedną oczekiwaną wartość, aby zobaczyć awarię. Zapisz go jako tests.php w folderze projektu, uruchom go poleceniem testowym i przeczytaj kod wyjścia na karcie przed zapytaniem o cokolwiek więcej. Następnie celowo zmień jedną oczekiwaną wartość i obserwuj, jak karta zmienia kolor na czerwony.
Cztery zadania dla narzędzi do generowania danych testowych
Napisz przykładowe rekordy
Wielu ludzi zastanawia się, jak generować dane testowe szybciej niż ręcznie. Opisz żądaną strukturę i pozwól agentowi ją zapisać: plik JSON z 3 wymyślonymi klientami, każdy z imieniem, datą rejestracji i kwotą zamówienia. Spośród narzędzi do generowania danych testowych, zwykły plik w Twoim projekcie jest najłatwiejszy do odczytania i zmiany później, ponieważ diff pokazuje każdą wartość. glob i list_dir pokazują, gdzie już znajdują się fixture, więc nowy plik pojawi się obok innych. Otwórz kartę, sprawdź, czy każda wartość jest wyraźnie wymyślona, i edytuj podejrzane wiersze ręcznie przed zaakceptowaniem. Używaj zastrzeżonych domen przykładowych dla adresów e-mail. Poproś o garść wierszy, a nie setki, abyś mógł przeczytać każdy z nich. Zapisuj daty w jednym stałym formacie, aby każdy wiersz wyglądał tak samo.
Napisz sprawdzenia odczytujące plik
Poproś o skrypt, który ładuje JSON i sprawdza jeden wynik na wiersz. Agent otwiera Twój kod źródłowy za pomocą read_file, znajduje funkcję za pomocą grep i proponuje plik testowy jako diff. Mockowanie metod statycznych w php jest kłopotliwe, więc poproś agenta o wypisanie wywołań statycznych przed napisaniem czegokolwiek i trzymaj te wywołania za małą funkcją, którą test może zastąpić. Ask first zatrzymuje zmianę, aż ją zaakceptujesz. Przeczytaj każdą asercję i zapytaj, czy zawiedzie, gdyby funkcja była błędna. Odrzuć każde sprawdzenie, które tylko powtarza kod, który testuje. Następnie dodaj jeden wiersz, który celowo powinien zawieść. Jeśli agent nie może powiedzieć, o którą funkcję chodzi, podaj jej nazwę w poleceniu i wspomnij o pliku. Trzymaj jedną koncepcję na test.
Uruchom testy i przeczytaj kod wyjścia
Shell uruchamia Twoje polecenie testowe w wybranym środowisku, takim jak lokalny Windows, WSL lub SSH do posiadanego serwera. Karta pokazuje rzeczywisty kod wyjścia, a zero oznacza, że każde sprawdzenie przeszło, podczas gdy każda inna wartość oznacza awarię. Rozwiń kartę, aby czytać wynik linia po linii. Jeśli coś zawiedzie, agent przeczyta komunikat i zaproponuje poprawkę jako diff. Nie akceptuj poprawki tylko dlatego, że uruchomienie jest zielone. Najpierw sprawdź oczekiwaną wartość w teście. Jeśli nastąpi druga awaria, poproś agenta o wyjaśnienie pierwszej przed ponowną edycją. Plan only to dobry pierwszy przebieg, jeśli polecenie jest dla Ciebie nowe, ponieważ agent wtedy pisze plan i nic nie uruchamia.
Zdecyduj, który kod wymaga testu
Po przejściu testów uruchom polecenie pokrycia i pozwól agentowi przeczytać raport. Zespoły dyskutują, czy uwzględniać kod infrastruktury w pokryciu kodu, a rozsądną odpowiedzią jest uzgodnienie tego przed zamianą liczby na cel. Niektóre zespoły wymagają również obowiązkowego pokrycia testami krytycznych metod, takich jak sprawdzenia cen lub uprawnień. Poproś agenta o wypisanie tych metod za pomocą grep i zaproponowanie testów dla pierwszej z nich. Przejrzyj diff, uruchom testy ponownie i zatrzymaj się, gdy ścieżki krytyczne są pokryte. Zapisz foldery, które policzyłeś, aby wynik w przyszłym miesiącu oznaczał to samo. Poproś agenta o umieszczenie listy policzonych folderów w zwykłym pliku tekstowym w Twoim projekcie i przeczytaj diff przed jego zaakceptowaniem.