Zrozum pracę05 / 20
Sprawdź dowody
Na tej stronie
Samo to, że Agent mówi „zaimplementowano”, nie wystarcza. Każde wyjaśnienie ma swoje dowody: kod, który przeczytał, testy, które uruchomił, zapisy przebiegów i zrzuty ekranu, do sprawdzenia jednym kliknięciem. Gdy ktoś zapyta, możesz wskazać dokładne miejsce.
Co zawierają dowody
Otwórz „Evidence” w notatce. Zwykle spotkasz takie materiały:
| Materiał | Wygląda jak | Po kliknięciu |
|---|---|---|
| Miejsce w kodzie | Nazwa funkcji albo znacznik „plik:wiersz” | Panel kodu otwiera się po prawej na tych wierszach |
| Wynik polecenia, na przykład uruchomienia testów | Znacznik | Pełny wynik otwiera się w pasku pomocniczym po prawej |
| Diff kodu | Znacznik | Otwiera się w pasku pomocniczym po prawej |
| Zrzuty ekranu i inne obrazy | Miniatura | Otwiera się powiększony |
Wyniki poleceń, diffy i zrzuty ekranu pochodzą z zapisów, które Agent zostawił podczas implementacji. Noea przechowuje dla każdej tury, jakie polecenia uruchomiono i jakie zrzuty ekranu zrobiono, więc wyjaśnienie może się do nich odwoływać bezpośrednio.
Spójrz na miejsce w kodzie
Miejsce w kodzie w środku zdania zwykle pokazuje się jako nazwa funkcji lub zmiennej, na przykład openGrace; w innym razie jako znacznik „plik:wiersz”, na przykład grace.ts:6-18. Jeśli jedno wyjaśnienie cytuje dwa pliki o tej samej nazwie, znacznik dodaje folder nadrzędny.
Zatrzymaj wskaźnik na nazwie lub znaczniku, by zobaczyć pełną ścieżkę, zakres wierszy i symbol. Kliknij, a panel kodu otworzy się po prawej dla tego pliku, na cytowanych wierszach. Jeśli plik jest nadal taki, jak zostawiła go jedna tura implementacji, zmiany tej tury są nałożone na cały plik, więc widzisz, która tura je napisała. Menu prawego przycisku może otworzyć plik w domyślnej aplikacji, pokazać go w Finderze lub skopiować jego ścieżkę.
Jeśli kod od tego czasu się przesunął, numery wierszy znacznika i miejsce, do którego prowadzi, podążają za jego obecnym położeniem. Jeśli cytowany kod się zmienił i można znaleźć tylko jego nazwę, znacznik jest przyciemniony; jeśli pliku nie ma albo kodu nie da się już znaleźć, znacznik jest przyciemniony i przekreślony, a najechanie mówi dlaczego. W obu przypadkach wyjaśnienie najpewniej trzeba zbadać ponownie.
Jak daleko sięgają dowody
Gdy patrzysz na materiał, najpierw rozpoznaj jego rodzaj:
| Materiał | Co może potwierdzić | O czym pamiętać |
|---|---|---|
| Kod implementacji lub testów | Jakiej logiki używa kod i jakie przypadki definiują testy | To, że kod testów istnieje, nie znaczy, że testy uruchomiono lub że przeszły |
| Wcześniejsze wyniki uruchomień | Co wtedy uruchomiono i jaki był wtedy wynik | Jeśli kod od tego czasu się zmienił, wynik może już nie obowiązywać |
| Weryfikacja uruchomiona podczas tego wyjaśnienia | Wynik w środowisku i zakresie tego uruchomienia | Przypadki, które przechodzą, nic nie mówią o przypadkach niepokrytych |
Explain i Investigation opierają się głównie na czytaniu kodu i istniejących materiałów; nie uruchamiają za każdym razem testów, buildów ani aplikacji. Agent weryfikuje coś tylko wtedy, gdy samo czytanie kodu nie rozstrzyga faktu, od którego zależy wniosek. Dobre dowody mówią, czego nie zweryfikowano, na przykład: „Nie uruchomiono wobec prawdziwego dostawcy płatności; wyniki obciążeń pochodzą z atrapy testowej.” Gdy dowodów jest mało, nie znaleziono implementacji albo zamiar jest niejednoznaczny, dowody i Attention powinny to powiedzieć wprost, zamiast podawać wniosek, który tylko wygląda na pewny.
Pamiętaj też, że wyjaśnienie jest zapisem badania z dowodami, a nie certyfikatem. Sprawdzenie implementacji jednego Agenta przez drugiego Agenta samo w sobie nie czyni wyniku pewniejszym. Wartość dowodów polega na tym, że możesz je otworzyć i sprawdzić, a nie na tym, że wyjaśnienie mówi „potwierdzone”.
Zrzuty ekranu i interfejs
Niektórych zachowań nie da się rozstrzygnąć samym kodem, na przykład czy powiadomienie naprawdę pojawia się w interfejsie. Jeśli Agent zrobił zrzut ekranu podczas implementacji, wyjaśnienie może wymienić go jako dowód, na przykład: „W okresie karencji u góry strony ustawień zespołu pojawia się powiadomienie.”
Kliknij miniaturę, by ją powiększyć. Zwróć uwagę, jaką stronę pokazuje, w jakim stanie i które uruchomienie ją zostawiło: zrzut ekranu dowodzi, jak interfejs wyglądał wtedy; jeśli kod od tego czasu się zmienił, interfejs mógł się zmienić także.
Sprawdzaj pozycja po pozycji
Sprawdzając dowody, pytaj o każdą pozycję:
- Czy to odwołanie wskazuje na to, czego dotyczy ta część zamiaru?
- Jakie przypadki obejmują testy i czy są wśród nich przypadki brzegowe?
- Czy wynik naprawdę potwierdza wniosek wyjaśnienia?
- Czy dowody mówią, czego nie zweryfikowano?
Na przykład dowody dla okresu karencji mówią „uruchomiono testy okresu karencji: wszystkie 6 przechodzi”, a Attention zauważa, że „żaden test nie obejmuje sytuacji, w której udane okaże się trzecie ponowienie.” Teraz wiesz, że ta ścieżka opiera się wyłącznie na czytaniu kodu, bez uruchomienia, które by ją potwierdziło.
Gdy dowodów nie wystarcza
Jeśli brakuje kluczowego przypadku, najedź na akapit, kliknij „Ask about this” po jego lewej stronie i poproś Agenta o weryfikację:
Dodaj test: trzecie ponowienie udaje się w 6. dniu okresu karencji, więc subskrypcja wraca do stanu normalnego i nie zostaje obniżona. Gdy test się wykona, podaj mi wynik.
Gdy Agent skończy, Noea sama wyjaśnia turę; jeśli to wyłączyłeś, kliknij „Investigation” po lewej stronie akapitu. Nowe wyjaśnienie wymienia to uruchomienie jako dowód.
Jeśli wniosek wyjaśnienia nie zgadza się z jego dowodami albo uważasz, że Agent źle odczytał Twój zamiar, zapytaj o to także tutaj i nie zmieniaj zamiaru, by pasował do kodu. Zobacz Zapisz to, co ustaliłeś, jako zamiar.