Sviluppo app Web3 nella cartella del tuo progetto

Cosa può fare l'agente per il tuo dApp

• Fileread_file, write_file, edit_file, grep, glob e list_dir operano nella cartella di lavoro della chat, quindi componenti, stili e il file JSON ABI possono essere letti e modificati lì.
• Shellesegue il tuo comando di build e il comando di test su Windows, WSL o un server SSH di tua proprietà, e riporta il codice di uscita reale di ciascuno.
• Webweb_search e http_get leggono pagine di documentazione pubbliche, quindi una domanda su una libreria o un'interfaccia può essere verificata controllando la pagina che la descrive.
• Screenshot e immaginiocr legge il testo di uno screenshot salvato, come un mock-up di design, e gen_image salva file immagine, come illustrazioni segnaposto.
• Orchestrazionetask avvia sotto-agenti per parti separate del lavoro in parallelo, run_on_model invia un passaggio complesso a un modello più grande e skill riutilizza un playbook.
• Modalità di approvazioneAuto-run agisce subito, Ask first fa una pausa prima delle azioni che modificano qualcosa e mostra un diff, e Plan only scrive un piano ed esegue nulla.
• Cronesegue un prompt su base programmata, ad esempio il tuo comando di test una volta al giorno, e i piani sopravvivono a un riavvio dell'app, quindi un compito lungo può continuare più tardi.
• Modelliusa un provider AI cloud tramite un endpoint API standard, un modello sul tuo tuo PC o il modello integrato, e premi Test per verificare un endpoint.

Quattro guide per un progetto dApp

Mappare un progetto ereditato

Chiedi all'agente di mappare una cartella dApp iniziata da qualcun altro. list_dir mostra la struttura, glob trova i file dei componenti e ABI, e grep elenca ogni punto in cui viene chiamata una funzione del contratto. Ogni risultato è una scheda nella chat. Non cambia nulla. La mappa mostra dove gli stati delle transazioni vengono gestiti e dove mancano, e ciò che impedisce alle persone di adottare i dApp è spesso un front-end che fallisce senza dire perché: nessun wallet, la rete sbagliata o una firma rifiutata. La modalità Plan only si adatta bene a questo compito, poiché scrive il piano ed esegue nulla, e il piano può indicare i file che richiedono attenzione per primi. Chiedi un breve riassunto scritto, poi leggilo confrontandolo con la cartella prima di iniziare qualsiasi modifica, e correggi l'agente se ha interpretato male un file.

Collegare un ABI a un componente

Chiedi un componente che mostri il saldo di un account di test. read_file apre il JSON ABI, quindi l'agente sa che balanceOf richiede un indirizzo e restituisce un uint256, e edit_file aggiunge la chiamata al tuo componente. In modalità Ask first la modifica resta in attesa come un diff. Leggi le righe aggiunte e rimosse, accetta o rifiuta, e chiedi una revisione se un nome o un tipo sembra sbagliato. Shell esegue poi il tuo comando di build e riporta il codice di uscita reale nella scheda, e puoi espandere la scheda per leggere l'output completo. Un build verde mostra che il codice compila; non mostra che la funzione giusta viene chiamata, quindi verifica la chiamata contro l'ABI tu stesso e mantieni il file ABI sincronizzato con il contratto.

Testare ogni stato della transazione

Le interfacce falliscono negli intervalli tra gli stati: non inviata, in attesa del wallet, in corso, confermata e fallita. Per evitare di costruire dApp fantasma che sembrano finiti ma si rompono al primo rifiuto della firma, chiedi all'agente di scrivere un test front-end per ogni stato. write_file crea il file di test, edit_file regola il componente dove manca uno stato, e Shell esegue il tuo comando di test. La scheda mostra il codice di uscita e, quando la espandi, l'output completo. Esegui i test contro una chain locale con account usa e getta, leggi ogni fallimento e decidi se il test o il componente sono sbagliati. Non accettare una modifica solo perché i test diventano verdi: leggi il diff e verifica che il test affermi davvero lo stato per cui è nominato.

Pianificare una funzione, poi eseguirla

Uno sviluppatore che vuole fare un salto di qualità dopo 1 anno nel web3 può chiedere all'agente un piano che aggiunga stati di caricamento, correzioni di accessibilità e test a un dApp esistente. In modalità Plan only l'agente scrive i passaggi ed esegue nessun comando e non modifica nessun file. Leggi il piano, elimina ciò che non vuoi, e passa a Ask first per eseguirlo. Da quel momento l'agente fa una pausa prima di ogni azione che modifica qualcosa, e leggi ogni diff prima di accettarlo. I piani sopravvivono a un riavvio, quindi puoi fermarti a qualsiasi passaggio e continuare il giorno successivo. Finisci eseguendo il tuo comando di test e leggendo il suo output tu stesso, e scrivi nel README quali comandi hai usato.