Tworzenie aplikacji Web3 w folderze Twojego projektu

Co agent może zrobić dla Twojego dApp

• Plikiread_file, write_file, edit_file, grep, glob i list_dir działają w folderze roboczym czatu, więc komponenty, style i plik JSON ABI można czytać i modyfikować bezpośrednio w tym miejscu.
• Shelluruchamia Twoją własną komendę budowania i komendę testów na Windows, WSL lub serwerze SSH, którym dysponujesz, i raportuje rzeczywisty kod wyjścia każdego polecenia.
• Siećweb_search i http_get pobierają publiczne strony dokumentacji, więc pytanie o bibliotekę lub interfejs można zweryfikować na podstawie strony, która go opisuje.
• Zrzuty ekranu i obrazyocr odczytuje tekst z zapisanego zrzutu ekranu, np. makietę projektu, a gen_image zapisuje pliki obrazów, np. grafikę zastępczą.
• Orkiestracjatask uruchamia pod-agentów do równoległej pracy nad oddzielnymi częściami zadania, run_on_model wysyła jeden trudny krok do większego modelu, a skill pozwala ponownie wykorzystać playbook.
• Tryby zatwierdzaniaAuto-run działa natychmiast, Ask first pauzuje przed działaniami zmieniającymi stan i pokazuje diff, a Plan only generuje plan i nic nie uruchamia.
• Cronuruchamia prompt zgodnie z harmonogramem, np. Twoją komendę testów raz dziennie, a plany przetrwają restart aplikacji, więc długie zadanie może kontynuować się później.
• Modeleużyj dostawcy AI w chmurze przez standardowy punkt końcowy API, modelu na własnym komputerze lub wbudowanego modelu i naciśnij Test, aby sprawdzić poprawność punktu końcowego.

Cztery przewodniki dla projektu dApp

Zmapuj przejęty projekt

Poproś agenta o zmapowanie folderu dApp, który rozpoczął ktoś inny. list_dir pokazuje strukturę, glob znajduje pliki komponentów i ABI, a grep wypisuje każde miejsce, w którym wywoływana jest funkcja kontraktu. Każdy wynik to karta w czacie. Nic się nie zmienia. Mapa pokazuje, gdzie obsługiwane są stany transakcji, a gdzie brakuje ich obsługi. Tym, co powstrzymuje użytkowników przed korzystaniem z dApp, często jest interfejs, który zawodzi bez podania przyczyny: brak portfela, niewłaściwa sieć lub odrzucony podpis. Tryb Plan only dobrze pasuje do tego zadania, ponieważ generuje plan i nic nie uruchamia, a plan może wskazać pliki wymagające uwagi jako pierwsze. Poproś o krótkie streszczenie, przeczytaj je w kontekście folderu przed rozpoczęciem edycji i skoryguj agenta, jeśli źle zinterpretował plik.

Podłącz ABI do komponentu

Poproś o komponent, który wyświetla saldo konta testowego. read_file otwiera plik JSON ABI, więc agent wie, że balanceOf przyjmuje adres i zwraca uint256, a edit_file dodaje wywołanie do Twojego komponentu. W trybie Ask first zmiana czeka jako diff. Czytasz dodane i usunięte linie, akceptujesz lub odrzucasz je i prosisz o poprawkę, jeśli nazwa lub typ wyglądają na błędne. Shell następnie uruchamia Twoją komendę budowania i raportuje rzeczywisty kod wyjścia na karcie; możesz rozwinąć kartę, aby przeczytać pełny wynik. Zielony wynik kompilacji oznacza, że kod się kompiluje, ale nie gwarantuje, że wywoływana jest właściwa funkcja – sprawdź wywołanie samodzielnie w kontekście ABI i utrzymuj synchronizację pliku ABI z kontraktem.

Przetestuj każdy stan transakcji

Interfejsy zawodzą w lukach między stanami: nie wysłano, oczekiwanie na portfel, oczekujący, potwierdzony i nieudany. Aby przestać budować „ghost dApp”, które wyglądają na gotowe, ale łamią się przy pierwszym odrzuconym podpisie, poproś agenta o napisanie testu front-end dla każdego stanu. write_file tworzy plik testowy, edit_file dostosowuje komponent w miejscu, gdzie brakuje stanu, a Shell uruchamia Twoją komendę testów. Karta pokazuje kod wyjścia, a po jej rozwinięciu – pełny wynik. Uruchom testy na lokalnej sieci z jednorazowymi kontami, przeczytaj każdą awarię i zdecyduj, czy to test, czy komponent jest błędny. Nie akceptuj zmiany tylko dlatego, że testy stają się zielone: przeczytaj diff i sprawdź, czy test faktycznie weryfikuje stan, na który wskazuje jego nazwa.

Zaplanuj funkcję, a następnie ją zrealizuj

Deweloper, który chce awansować po roku w web3, może poprosić agenta o plan dodający stany ładowania, poprawki dostępności i testy do istniejącego dApp. W trybie Plan only agent generuje kroki, nie uruchamia żadnej komendy i nie zmienia żadnego pliku. Czytasz plan, usuwasz elementy, których nie chcesz, i przełączasz się na Ask first, aby zrealizować zadanie. Od tego momentu agent pauzuje przed każdym działaniem zmieniającym stan, a Ty czytasz każdy diff przed jego akceptacją. Plan przetrwa restart, więc możesz przerwać w dowolnym kroku i kontynuować następnego dnia. Zakończ zadanie, uruchamiając swoją komendę testów i samodzielnie analizując jej wynik, oraz zapisz w README, jakich komend użyłeś.