Cardano Dev Skills collega gli agenti AI alla documentazione aggiornata

Cardano Dev Skills fornisce agli agenti di programmazione AI istruzioni e riferimenti tecnici per costruire transazioni, scrivere smart contract e comprendere gli standard di Cardano. Il pacchetto affronta un problema ricorrente nello sviluppo: gli agenti possono produrre codice convincente che però si basa su librerie o regole di rete obsolete.

Giovanni Gargiulo, Senior Blockchain Architect presso la Cardano Foundation, ha mostrato lo strumento durante le Developers Office Hours il 18 settembre, portando un agente da una spiegazione di CIP-68 a un esempio di implementazione in Java.

Errori Aiken e Conway nel codice Cardano

Gargiulo ha avviato il progetto dopo aver constatato che correggere il codice generato dall'AI a volte richiedeva più tempo che implementare lui stesso la soluzione. Ciò che era iniziato come un esperimento personale è poi confluito nell'organizzazione GitHub della Cardano Foundation ed è stato aperto ai contributi della community.

Un problema ricorrente riguardava Aiken, un linguaggio per sviluppare smart contract su Cardano. L'agente continuava a utilizzare pattern della versione 2.4 della libreria standard anche quando Gargiulo richiedeva la documentazione per la versione 3. Il codice risultante non riusciva a compilare.

Le modifiche dell'era Conway hanno creato un diverso punto di guasto. Lavorando con la registrazione degli stake address e i certificati, l'agente ha combinato requisiti più recenti con un approccio più vecchio alla costruzione delle transazioni. Il codice dell'applicazione poteva compilare correttamente mentre la transazione falliva al momento dell'invio alla rete.

I software development kit, o SDK, presentavano problemi simili. Queste librerie consentono alle applicazioni di costruire transazioni e interagire con Cardano, ma campi rinominati o firme di funzione cambiate possono rendere inutilizzabili gli esempi più datati.

Inizialmente Gargiulo scaricava manualmente la documentazione aggiornata e indirizzava ripetutamente l'agente ad essa. Il riavvio delle sessioni o la compressione del contesto della conversazione significavano che quelle istruzioni dovevano essere fornite di nuovo. I suoi esperimenti con il recupero della documentazione richiedevano inoltre una manutenzione continua delle fonti, portando a un pacchetto che combinava riferimenti con flussi di lavoro di sviluppo riutilizzabili.

Fonti mantenute e dimostrazione di CIP-68

La versione presentata durante la sessione conteneva 15 competenze di sviluppo e 55 fonti di documentazione. Il 2 ottobre, il sito ufficiale del progetto elencava 18 competenze e 73 fonti, che coprivano SDK, linguaggi di programmazione, infrastruttura, CIP e specifiche del ledger.

Una competenza fornisce istruzioni per un'attività specifica, come costruire una transazione di trasferimento di ADA, scrivere un validator o ottimizzare un contratto. Le Cardano Improvement Proposals, note come CIP, forniscono standard tecnici che gli agenti possono spiegare e applicare attraverso le fonti allegate.

Il pacchetto separa il registro delle fonti, le istruzioni dei compiti e i riferimenti scaricati. I manutentori possono aggiornare la documentazione in modo indipendente dai flussi di lavoro che indicano a un agente come utilizzarla.

Le descrizioni dei compiti aiutano anche l'agente ad abbinare le richieste ordinarie al flusso di lavoro appropriato. Uno sviluppatore può chiedere una transazione di token o una revisione di un contratto in linguaggio naturale, consentendo all'agente di selezionare la competenza pertinente senza un comando esplicito.

Un processo automatico settimanale recupera le modifiche upstream e apre una pull request su GitHub per la revisione umana prima che entrino nel ramo principale. Gli utenti ottengono quindi il pacchetto aggiornato. Gli utenti di Claude Code devono abilitare gli aggiornamenti automatici per il suo marketplace oppure aggiornarlo manualmente.

La competenza cardano-context aggiunge un'istruzione persistente di progetto che indica a Claude Code o Codex di considerare potenzialmente obsoleta la conoscenza esistente su Cardano e di consultare prima i riferimenti inclusi. Entrambi gli agenti utilizzano le stesse competenze di sviluppo e le stesse fonti attraverso i rispettivi percorsi di installazione.

Nella dimostrazione, Gargiulo ha richiesto una spiegazione di CIP-68, lo standard di metadati per gli asset nativi di Cardano. Esso distingue un NFT di riferimento, il cui output di transazione contiene i metadati, da un token utente che rappresenta l'asset nel portafoglio del detentore. La logica del contratto dell'emittente determina se i metadati possono essere aggiornati.

L'agente ha poi risposto a una richiesta per una transazione corrispondente selezionando le istruzioni di sviluppo e presentando le librerie disponibili. Gargiulo ha scelto cardano-client-lib, una libreria Java, e ha ricevuto configurazione del progetto, dipendenze e codice di implementazione. L'esempio generato specificava Java 17.

Gargiulo non ha eseguito l'esempio durante la sessione. La dimostrazione ha quindi riguardato la preparazione dell'implementazione, con i test della transazione end to end ancora in sospeso.

Feedback e ulteriori applicazioni su Cardano

Cardano Dev Skills include un meccanismo di feedback per segnalare documentazione errata, istruzioni mancanti o errori nella selezione della competenza appropriata. Bora, un collaboratore del progetto, ha descritto un caso in cui un agente ha proposto un report al termine di una sessione e ha chiesto all'utente di rivederlo prima di approvarne l'invio come issue su GitHub.

I manutentori utilizzano quei report per valutare se una fonte o un flusso di lavoro necessita di correzioni. Gargiulo ha anche distinto i problemi di documentazione dalle richieste che sono esse stesse poco chiare o tecnicamente difettose, poiché ciascuna richiede una risposta diversa.

I contributi specialistici aiutano ad ampliare la copertura. Gargiulo ha citato l'aggiunta di materiale su Go da parte di un collaboratore esperto del linguaggio e dei suoi strumenti per Cardano. Le regole di ambito del progetto ammettono integrazioni di sviluppo, specifiche, SDK e documentazione dell'infrastruttura, escludendo invece il materiale di marketing e i manuali utente dei prodotti finali.

Il testo del pacchetto può essere ispezionato direttamente, mentre i suoi hook di supporto richiedono revisione poiché eseguono codice. Gargiulo ha delineato ulteriori sessioni su prompt injection, confini di fiducia e situazioni in cui gli agenti ignorano la documentazione. Ha anche descritto piani per ulteriore lavoro sulla modularità e sulla compatibilità con altri agenti nella seconda metà di ottobre.

Le potenziali estensioni discusse durante la sessione includevano la valutazione delle proposte di governance rispetto alla Costituzione di Cardano e un esperimento su testnet in cui gli utenti pagherebbero un agente in USDCx per una revisione di smart contract, potenzialmente tramite Masumi. Queste sono state presentate rispettivamente come lavori in corso e come esperimento proposto.

L'onboarding per gli hackathon ha fornito un'applicazione concreta per il pacchetto esistente. Per un evento di 36 ore previsto a Singapore, un partecipante ha descritto l'idea di fornire agli sviluppatori Cardano Dev Skills e alcuni prompt iniziali anziché assemblare un elenco esteso di risorse per ogni team.

In quel flusso di lavoro, un team può iniziare con una transazione, un validator o uno standard di token all'interno del proprio agente di programmazione. Le istruzioni del compito pertinenti e i riferimenti tecnici sono disponibili nello stesso ambiente, mentre i problemi scoperti durante l'implementazione possono essere segnalati tramite il processo di feedback del pacchetto.