Zrozum pracę06 / 20
Czytaj zmiany według zamiaru
Na tej stronie
Gdy Agent zmienia w jednej turze dziesiątki plików, przechodzenie po diffach plik po pliku utrudnia odpowiedź na pytanie „po co były te zmiany?”. W Noea zmiany z tury można pogrupować według zamiaru, na który odpowiadają, więc widzisz, któremu Twojemu zdaniu służy każda zmiana. Zmiany, które nie odpowiadają na żaden zamiar, są wypisane osobno na końcu, a nie wymieszane z resztą.
Zacznij od karty zmian
Gdy tura zostawia zmiany w plikach, odpowiedź kończy się kartą zmian. Jeśli zmienił się jeden plik, jej tytuł brzmi na przykład „Edited grace.ts”; jeśli kilka, na przykład „Changed 9 files”, a obok widać dodane i usunięte wiersze. Pliki, które Agent zmienił przez wiersz poleceń, też się liczą.
Gdy Explain obsłuży turę, druga linia karty brzmi na przykład „2 intents · 1 unmatched”: ile części Twojego zamiaru obejmują zmiany i ile zmian nie odpowiada na żadną. Do tego czasu druga linia proponuje „Run Explain to group them”.
Kliknij w dowolnym miejscu karty, a panel kodu otworzy się w pasku pomocniczym po prawej stronie głównego obszaru, pokazując każdą zmianę z tury. Sam czat nie powtarza diffu tury.
Panel kodu
Góra panelu pokazuje tytuł czatu i numer tury, na przykład „Mail o okresie karencji · Turn 2”, i pozwala przełączać się na inne tury ze zmianami w tym samym czacie. Przycisk w prawym górnym rogu pokazuje lub ukrywa listę plików, która może być płaska albo pogrupowana według folderów; przy każdym pliku widać dodane i usunięte wiersze, a kliknięcie przenosi do niego. Nagłówek każdego pliku ma „Open with default app”.
Diff ma jedną kolumnę numerów wierszy: dodane i niezmienione wiersze pokazują nowe numery, a usunięte stare, przyciemnione. Niezmienione wiersze między zmianami zwijają się w jeden rząd, który możesz rozwinąć, aż do całego pliku. Jeśli plik zmienił się jeszcze po tej turze, panel pokazuje tylko zmiany z tej tury i oferuje „Show current file”.
Przeciągnij lewą krawędź paska pomocniczego, by poszerzyć panel. Zamknięcie go zwija tylko pasek pomocniczy; dokument i czat po jego lewej stronie zostają bez zmian.
Pogrupowane według zamiaru
Panel ma dwa układy, „By file” i „By intent”. Według zamiaru:
- Każda grupa to jedna część Twojego zamiaru. Jej nagłówkiem jest tekst tego akapitu, a dokument i sekcja, w której leży, są pokazane małą czcionką nad nim. Grupy idą w kolejności akapitów w Twoich dokumentach założeń.
- W obrębie grupy zmiany są ułożone według kluczowego punktu, potem według pliku. Każdy kluczowy punkt jest podtytułem ze swoją nazwą, po której małą czcionką następuje pierwsze zdanie jego realizacji.
- Każda zmiana pojawia się tylko raz. Jeśli odpowiada na kilka kluczowych punktów, trafia pod główny, a pozostałe wiszą na niej jako znaczniki.
- Ostatnia grupa to zawsze „Other changes”, na zmiany, które nie odpowiadają na żaden zamiar.
To, w którym układzie panel się otwiera, zależy od tego, jak daleko Explain doszedł z turą:
| Explain | Otwiera się w układzie |
|---|---|
| Jeszcze nie obsłużył tury | By file |
| W toku, z wyjaśnieniami już powiązanymi z tą turą | Przełącza się na By intent, gdy opublikowane zostanie pierwsze wyjaśnienie; akapity, które nadal są badane, zajmują miejsce w swojej grupie |
| Zakończył się normalnie | By intent |
| Nie znalazł akapitu do zbadania | By file, z uwagą „This turn didn't touch any explained intent.” |
W każdej chwili możesz wrócić do układu By file.
Na co odpowiada każda zmiana
Przy każdej zmianie Twój zamiar pojawia się w trzech warstwach, od lekkiej do szczegółowej:
- Znaczniki przy wierszach: wiersze, które wyjaśnienie wyraźnie cytuje, mają po lewej cienki neutralny znacznik. Wskaż go, by podświetlić pozostałe wiersze cytowane przez to samo wyjaśnienie i zobaczyć nazwę zamiaru.
- Znaczniki zamiaru: kluczowe punkty, na które odpowiada zmiana, wiszą na jej nagłówku, najwyżej dwa, a reszta jest zwinięta w „+N intents”. Wskaż znacznik, by zobaczyć podgląd akapitu i pierwszego zdania jego wyjaśnienia; kliknij, by otworzyć dokument w sąsiednim panelu, z otwartym tym wyjaśnieniem.
- Blok zamiaru: pod każdą zmianą jest zwinięta linia podsumowania, na przykład „2 intents · 1 gap”. Otwórz ją, by zobaczyć tekst każdego akapitu, na który odpowiada zmiana, wraz z pozycjami Attention z jego najnowszego wyjaśnienia.
Zmiana jest powiązana z Twoim zamiarem na jeden z trzech sposobów: „Cited by Explain” znaczy, że wyjaśnienie wyraźnie cytuje te wiersze; „Matched by lines” znaczy, że zmiana mieści się w wierszach cytowanych przez wyjaśnienie; „Judged unaffected” znaczy, że Explain sprawdził zmianę i uznał, że nie wpływa na ten akapit. Zmiana, która obejmuje większość pliku, albo taka, której wcześniejszą zawartość zgłosił Agent, a nie odczytała Noea, nie jest dopasowywana po wierszach; panel oznacza ją „Not grouped by lines”.
Zawęź do jednej części zamiaru
„Filter by intent” na górze listy plików pokazuje tylko zmiany dla jednego akapitu lub jednego kluczowego punktu. Wybierz „No matching intent”, by zobaczyć tylko zmiany, które nie odpowiadają na żaden.
Możesz też pójść w drugą stronę, od zamiaru do zmian. Otwórz wyjaśnienie akapitu w dokumencie założeń: „Recent implementation” na końcu notatki wymienia tury, które niedawno go zmieniły. Otwórz jedną, a panel kodu otworzy się na tej turze, już przefiltrowany do tego akapitu.
Po przeczytaniu
„Other changes” niekoniecznie są problemem; to często pomocnicy testów, formatowanie albo aktualizacje zależności. Ale jeśli zmiana w logice biznesowej nie odpowiada na żaden zamiar, warto zapytać, dlaczego się zmieniła i czy powinna trafić do Twojego zamiaru.
Zapytaj Agenta na czacie albo kliknij „Ask about this” po lewej stronie akapitu. O decyzjach, które chcesz zachować, mówi Zapisz to, co ustaliłeś, jako zamiar.
Grupowanie zależy od wyników Explain. Jeśli karta stale pokazuje „Run Explain to group them”, sprawdź „Explain automatically after implementing” i „Explain code-only turns” w Settings → Automation albo po prostu kliknij kartę; zobacz Gdy kod się zmienia.