Розробка Web3-додатків у папці вашого проєкту

Що агент може зробити для вашого dApp

• Файлиread_file, write_file, edit_file, grep, glob і list_dir працюють у робочій папці чата, тому компоненти, стилі та файл ABI JSON можна читати й змінювати там.
• Shellзапускає вашу власну команду збірки й команду тестування на Windows, WSL або SSH-сервері, яким ви володієте, і повідомляє реальний код виходу для кожної.
• Вебweb_search і http_get читають публічні сторінки документації, тому питання щодо бібліотеки чи інтерфейсу можна перевірити за сторінкою, що її описує.
• Знімки екрана й зображенняocr зчитує текст збереженого знімка екрана, наприклад макета дизайну, а gen_image зберігає файли зображень, наприклад тимчасові ілюстрації.
• Оркеструванняtask запускає субагентів для окремих частин роботи паралельно, run_on_model надсилає один складний крок до більшої моделі, а skill повторно використовує плейбук.
• Режими погодженняAuto-run діє одразу, Ask first робить паузу перед діями, що щось змінюють, і показує diff, а Plan only складає план і нічого не запускає.
• Cronзапускає промпт за розкладом, наприклад вашу команду тестування раз на день, а плани зберігаються після перезапуску додатка, тому тривале завдання можна продовжити пізніше.
• Моделівикористовуйте хмарного AI-постачальника через стандартний API-ендпоінт, модель на власному ПК або вбудовану модель, і натисніть Test, щоб перевірити ендпоінт.

Чотири покрокові інструкції для проєкту dApp

Створити карту успадкованого проєкту

Ви просите агента створити карту папки dApp, яку розпочав хтось інший. list_dir показує структуру, glob знаходить файли компонентів і ABI, а grep перелічує кожне місце, де викликається функція контракту. Кожен результат — це картка в чаті. Нічого не змінюється. Карта показує, де обробляються стани транзакцій, а де вони відсутні, і те, що заважає людям використовувати dApp, часто — це фронтенд, який ламається без пояснення причин: немає гаманця, неправильна мережа або відхилений підпис. Режим Plan only добре підходить для цього завдання, оскільки він складає план і нічого не запускає, а план може вказати файли, яким потрібно приділити увагу першочергово. Попросіть короткий письмовий звіт, а потім перевірте його за папкою, перш ніж почати будь-яке редагування, і виправте агента, якщо він неправильно прочитав файл.

Підключити ABI до компонента

Ви просите компонент, який показує баланс тестового облікового запису. read_file відкриває ABI JSON, тому агент знає, що balanceOf приймає адресу й повертає uint256, а edit_file додає виклик до вашого компонента. У режимі Ask first зміна чекає як diff. Ви читаєте додані й видалені рядки, приймаєте або відхиляєте їх і просите виправлення, якщо ім’я чи тип виглядають неправильно. Shell потім запускає вашу команду збірки й повідомляє реальний код виходу на картці, і ви можете розгорнути картку, щоб прочитати повний вивід. Зелена збірка показує, що код компілюється; вона не показує, що викликається правильна функція, тому перевірте виклик самостійно за ABI й синхронізуйте файл ABI з контрактом.

Протестувати кожен стан транзакції

Інтерфейси ламаються у проміжках між станами: не надіслано, очікування гаманця, в обробці, підтверджено й відмовлено. Щоб уникнути створення «привидів» dApp, які виглядають готовими, але ламаються при першому відхиленому підписі, попросіть агента написати фронтенд-тест для кожного стану. write_file створює файл тесту, edit_file коригує компонент там, де відсутній стан, а Shell запускає вашу команду тестування. Картка показує код виходу й, коли ви її розгортаєте, повний вивід. Запустіть тести проти локальної мережі з одноразовими обліковими записами, прочитайте кожен збій і вирішіть, чи неправильний тест, чи компонент. Не приймайте зміну лише тому, що тести стали зеленими: прочитайте diff і перевірте, чи дійсно тест перевіряє стан, назва якого використовується.

Скласти план функції, а потім впровадити її

Розробник, який хоче покращити свої навички після року роботи у web3, може попросити агента скласти план, який додасть стани завантаження, виправлення доступності та тести до існуючого dApp. У режимі Plan only агент записує кроки й не запускає жодної команди й не змінює жодного файлу. Ви читаєте план, видаляєте те, що вам не потрібно, і перемикаєтеся на Ask first, щоб виконати його. Відтепер агент робить паузу перед кожною дією, що щось змінює, і ви читаєте кожен diff, перш ніж прийняти його. Плани зберігаються після перезапуску, тому ви можете зупинитися на будь-якому кроці й продовжити наступного дня. Завершіть запуском вашої команди тестування й самостійно прочитайте її вивід, а також запишіть у README, які команди ви використовували.