Dbaj o aktualność wyjaśnień — Dokumentacja Noea Code

Po zmianie założeń lub kodu sprawdź, czy wyjaśnienia nadal obowiązują. Użyj Explain na pasku bocznym, aby zająć się wyjaśnieniami wymagającymi uwagi w całym projekcie, albo akcji Investigation przy akapicie, aby sprawdzić jeden fragment.

Ustal, co się zmieniło

Status	Znaczenie	Następny krok
Treść do przeanalizowania	Nowe lub zmienione sformułowanie nie ma własnego wyjaśnienia.	Zapisz, a potem przeanalizuj. Jeśli wymaganie nie jest jeszcze spełnione, najpierw je zaimplementuj.
Wyjaśnienie poprzedniej treści	Akapit się zmienił, ale notatka nadal wyjaśnia wcześniejsze sformułowanie.	Sprawdź różnice w tekście i ponownie przeanalizuj akapit.
Może być nieaktualne	Zmieniły się pliki przeczytane lub przywołane przez wyjaśnienie.	Przejrzyj zmienione pliki i ponownie sprawdź wyjaśnienie.
Nie znaleziono zmian	Żadna treść nie czeka na analizę ani nie jest oznaczona jako potencjalnie nieaktualna.	W razie potrzeby czytaj dalej lub weryfikuj konkretne pytania.

„Może być nieaktualne” nie musi oznaczać błędnego wniosku; zmiana pliku może być niepowiązana. „Nie znaleziono zmian” nie dowodzi, że testy przechodzą albo że wszystkie funkcje są ukończone.

Przeanalizuj jeden akapit

Zapisz dokument, najedź na akapit i wybierz Investigation po lewej stronie. Istniejąca notatka na marginesie może również oferować Investigate Again.

Ta akcja aktualizuje tylko wyjaśnienie wybranego fragmentu. Gdy ma on niezapisane zmiany, Investigation jest niedostępne, a Noea prosi najpierw o zapis.

Po zmianie kodu zapobiegającego wielokrotnemu przyznawaniu nagród przeanalizuj na przykład odpowiednią regułę, aby sprawdzić, czy wyjaśnienie opisuje obecną implementację.

Aktualizuj wyjaśnienia w całym projekcie

Kliknij Explain na pasku bocznym, aby sprawdzić treści czekające na analizę oraz wyjaśnienia, których pliki źródłowe się zmieniły. Akcja jest niedostępna, gdy nie otwarto projektu, projekt jest tylko do odczytu albo nie połączono folderu implementacji.

Ręcznie uruchomione zadanie Explain otwiera rozmowę pokazującą etapy, postęp i wyniki poszczególnych analiz. Podczas jego pracy nie możesz wysyłać zwykłych wiadomości w tej rozmowie, ale możesz korzystać z innych rozmów w projekcie.

Po zakończeniu rozwiń wyniki, aby zobaczyć, które wyjaśnienia się zmieniły, które pozostały poprawne oraz które kontrole się nie powiodły lub nie zostały ukończone. Samo zakończenie zadania nie oznacza powodzenia każdej kontroli.

Zrozum, co sprawdziło Explain

Explain porównuje założenia z kodem i sprawdza wyjaśnienia akapitów oraz fragmentów. Zachowuje poprawne treści i aktualizuje te wymagające korekty; nie musi przepisywać każdego wyjaśnienia.

Aktualizacja wyjaśnienia nie oznacza ponownego uruchomienia testów. Aby zweryfikować działanie, poproś o kontrole w zwykłej rozmowie, a potem przeanalizuj odpowiedni fragment. Zakres weryfikacji opisuje artykuł Czytaj wyjaśnienia i dowody.

Dowiedz się, kiedy Explain uruchamia się automatycznie

Settings → Current Project → Automation → Explain automatically after implementing jest domyślnie włączone. Główne wyzwalacze to:

Działanie	Automatyczne Explain
Akceptacja propozycji zmieniającej założenia i nadal wymagającej implementacji.	Po normalnym zakończeniu zadania implementacji.
Akceptacja propozycji zmieniającej założenia, którą implementacja już spełnia.	Po zaakceptowaniu.
Rozpoczęcie pracy przez Realize na pasku bocznym.	Po normalnym zakończeniu pierwszej tury.
Akceptacja planu porządkowania, który zmienia tekst założeń.	Po zaakceptowaniu, niezależnie od powyższego ustawienia.
Zmiana tylko nazw plików lub struktury folderów podczas porządkowania.	Nie jest uruchamiane.
Zmiana samego kodu w zwykłej rozmowie, wybór Implement Directly albo niepowodzenie lub zatrzymanie implementacji.	Nie jest uruchamiane; uruchom Explain ręcznie.

Automatyczne Explain działa w tle bez tworzenia zwykłej rozmowy. Kontynuuj pierwotną rozmowę i sprawdzaj postęp w sekcji Runs.

Przeglądaj zapisy i ponawiaj uruchomienia

Sekcja Runs na pasku bocznym przechowuje zadania tworzenia wyjaśnień. Rozwiń zadanie, aby zobaczyć zapisy jego wykonań tylko do odczytu. Zapisy pozostają dostępne po przełączeniu rozmów lub ponownym uruchomieniu aplikacji.

Po błędzie lub przerwaniu wybierz Run Again. Istniejące wyjaśnienia są zachowywane. Gdy nowe uruchomienie się skończy, sprawdź, czy wcześniej nieudane lub niedokończone elementy zostały obsłużone.

Wybierz agenta do każdej operacji

Agent używany przez Explain zależy od sposobu uruchomienia zadania. Ustawienia operacji projektowych i ich zakres opisuje artykuł Agenci, modele i użycie.

Jeśli wyjaśnienia się nie aktualizują, zobacz Rozwiązywanie problemów i najczęstsze pytania.