Разработка 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запускает промпт по расписанию, например команду тестирования раз в день, а планы сохраняются после перезапуска приложения, так что длительная задача может продолжиться позже.
• Моделииспользуйте облачного ИИ-провайдера через стандартный 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 и проверьте, действительно ли тест утверждает состояние, которому он посвящён.

Планирование функции, затем её реализация

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