Cardano Dev Skills connecte des agents d'IA à la documentation actuelle

Cardano Dev Skills fournit aux agents de codage d'IA des instructions et des références techniques pour construire des transactions, écrire des smart contracts et comprendre les standards de Cardano. Le package répond à un problème récurrent de développement : les agents peuvent produire un code convaincant qui s'appuie sur des bibliothèques ou des règles du réseau obsolètes.

Giovanni Gargiulo, architecte blockchain senior à la Cardano Foundation, a démontré l'outil durant les Developers Office Hours le 18 septembre, en guidant un agent d'une explication de CIP-68 à un exemple d'implémentation en Java.

Erreurs Aiken et Conway dans le code Cardano

Gargiulo a lancé le projet après avoir constaté que corriger du code généré par IA prenait parfois plus de temps que d'implémenter lui-même la solution. Ce qui avait commencé comme une expérience personnelle a ensuite rejoint l'organisation GitHub de la Cardano Foundation et s'est ouvert aux contributions de la communauté.

Un problème récurrent concernait Aiken, un langage pour développer des smart contracts sur Cardano. L'agent continuait d'utiliser des modèles issus de la bibliothèque standard version 2.4 même lorsque Gargiulo demandait la documentation pour la version 3. Le code obtenu ne parvenait pas à compiler.

Les changements de l'ère Conway ont créé un autre point d'échec. En travaillant sur l'enregistrement d'adresses de stake et les certificats, l'agent a combiné de nouvelles exigences avec une ancienne approche de construction de transaction. Le code applicatif pouvait compiler avec succès tandis que la transaction échouait lors de sa soumission au réseau.

Les kits de développement logiciel, ou SDK, présentaient des problèmes similaires. Ces bibliothèques permettent aux applications de construire des transactions et d'interagir avec Cardano, mais des champs renommés ou des signatures de fonctions modifiées peuvent rendre les anciens exemples inutilisables.

Au départ, Gargiulo téléchargeait manuellement la documentation à jour et y renvoyait l'agent de manière répétée. La relance des sessions ou la compression du contexte de conversation signifiaient qu'il fallait fournir ces instructions à nouveau. Ses expérimentations de récupération de documentation nécessitaient aussi une maintenance continue des sources, menant à un package qui combinait des références avec des flux de travail de développement réutilisables.

Sources maintenues et démonstration de CIP-68

La version présentée pendant la session contenait 15 compétences de développement et 55 sources de documentation. Le 2 octobre, le site officiel du projet en listait 18 et 73 sources, couvrant des SDK, des langages de programmation, l'infrastructure, des CIP et des spécifications du registre.

Une compétence fournit des instructions pour une tâche spécifique, comme construire une transaction de transfert d'ADA, écrire un validateur ou optimiser un contrat. Les Cardano Improvement Proposals, connues sous le nom de CIP, fournissent des standards techniques que les agents peuvent expliquer et appliquer au moyen des sources associées.

Le package sépare son registre de sources, les instructions de tâche et les références téléchargées. Les mainteneurs peuvent mettre à jour la documentation indépendamment des flux de travail qui indiquent à un agent comment l'utiliser.

Les descriptions de tâches aident aussi l'agent à faire correspondre des requêtes ordinaires au flux de travail approprié. Un développeur peut demander une transaction de jeton ou une revue de contrat en langage naturel, ce qui permet à l'agent de sélectionner la compétence pertinente sans commande explicite.

Un processus hebdomadaire automatisé récupère les changements en amont et ouvre une pull request GitHub pour revue humaine avant leur entrée dans la branche principale. Les utilisateurs obtiennent ensuite le package mis à jour. Les utilisateurs de Claude Code doivent activer les mises à jour automatiques pour sa marketplace ou le mettre à jour manuellement.

La compétence cardano-context ajoute une instruction de projet persistante indiquant à Claude Code ou Codex de considérer les connaissances existantes sur Cardano comme potentiellement obsolètes et de consulter d'abord les références intégrées. Les deux agents utilisent les mêmes compétences de développement et sources via leurs voies d'installation respectives.

Lors de la démonstration, Gargiulo a demandé une explication de CIP-68, la norme de métadonnées pour les actifs natifs de Cardano. Elle distingue un NFT de référence, dont la sortie de transaction contient les métadonnées, d'un jeton utilisateur représentant l'actif dans le portefeuille d'un détenteur. La logique du contrat de l'émetteur détermine si les métadonnées peuvent être mises à jour.

L'agent a ensuite répondu à une demande de transaction correspondante en sélectionnant des instructions de développement et en présentant les bibliothèques disponibles. Gargiulo a choisi cardano-client-lib, une bibliothèque Java, et a reçu la configuration du projet, les dépendances et le code d'implémentation. L'exemple généré spécifiait Java 17.

Gargiulo n'a pas exécuté l'exemple pendant la session. La démonstration a donc couvert la préparation de l'implémentation, les tests de transaction de bout en bout restant à effectuer.

Retours et autres applications Cardano

Cardano Dev Skills inclut un mécanisme de retour pour signaler une documentation incorrecte, des instructions manquantes ou des échecs de sélection d'une compétence appropriée. Bora, un contributeur du projet, a décrit un cas où un agent a proposé un rapport à la fin d'une session et a demandé à l'utilisateur de le relire avant d'approuver son envoi comme issue GitHub.

Les mainteneurs utilisent ces rapports pour évaluer si une source ou un flux de travail nécessite une correction. Gargiulo a aussi distingué les problèmes de documentation des requêtes elles-mêmes floues ou techniquement erronées, car chacune exige une réponse différente.

Les contributions de spécialistes aident à étendre la couverture. Gargiulo a cité l'ajout de contenu Go par un contributeur familier du langage et de ses outils Cardano. Les règles de périmètre du projet admettent les intégrations de développement, les spécifications, les SDK et la documentation d'infrastructure tout en excluant le matériel marketing et les manuels utilisateurs de produits finis.

Le texte du package peut être inspecté directement, tandis que ses hooks d'assistance nécessitent une revue car ils exécutent du code. Gargiulo a annoncé d'autres sessions sur l'injection de prompts, les frontières de confiance et les situations où les agents ignorent la documentation. Il a aussi décrit des plans pour des travaux supplémentaires sur la modularité et la compatibilité avec d'autres agents dans la seconde moitié d'octobre.

Parmi les extensions potentielles évoquées pendant la session figuraient l'évaluation de propositions de gouvernance au regard de la Cardano Constitution et une expérimentation sur testnet dans laquelle des utilisateurs paieraient un agent en USDCx pour une revue de smart contract, possiblement via Masumi. Elles ont été présentées respectivement comme un travail en cours et une expérience proposée.

L'onboarding de hackathon a fourni une application concrète pour le package existant. Pour un événement de 36 heures prévu à Singapour, un participant a décrit le fait de donner aux développeurs Cardano Dev Skills et quelques prompts de départ plutôt que de constituer une longue liste de ressources pour chaque équipe.

Dans ce flux de travail, une équipe peut commencer par une transaction, un validateur ou une norme de jeton au sein de son agent de codage. Les instructions de tâche pertinentes et les références techniques sont disponibles dans le même environnement, tandis que les problèmes découverts pendant l'implémentation peuvent être signalés via le processus de retour du package.