Cardano Dev Skills verbindet KI Agenten mit aktueller Dokumentation

Cardano Dev Skills gibt KI Programmieragenten Anweisungen und technische Referenzen für das Erstellen von Transaktionen, das Schreiben von Smart Contracts und das Verständnis von Cardano Standards. Das Paket adressiert ein wiederkehrendes Entwicklungsproblem: Agenten können überzeugenden Code erzeugen, der sich auf veraltete Bibliotheken oder Netzwerkregeln stützt.

Giovanni Gargiulo, Senior Blockchain Architect bei der Cardano Foundation, demonstrierte das Tool während der Developers Office Hours am 18. September und führte einen Agenten von einer Erklärung zu CIP-68 zu einem Java Implementierungsbeispiel.

Aiken und Conway Fehler im Cardano Code

Gargiulo begann das Projekt, nachdem er festgestellt hatte, dass die Korrektur von KI generiertem Code manchmal länger dauerte, als die Lösung selbst zu implementieren. Was als persönliches Experiment begann, wanderte später in die GitHub Organisation der Cardano Foundation und wurde für Beiträge aus der Community geöffnet.

Ein wiederkehrendes Problem betraf Aiken, eine Sprache zur Entwicklung von Smart Contracts auf Cardano. Der Agent nutzte weiterhin Muster aus der Standardbibliothek Version 2.4, selbst wenn Gargiulo Dokumentation für Version 3 anforderte. Der daraus resultierende Code ließ sich nicht kompilieren.

Änderungen in der Conway Ära führten zu einem anderen Fehlpunkt. Bei der Arbeit mit Stake Address Registrierung und Zertifikaten kombinierte der Agent neuere Anforderungen mit einem älteren Ansatz zur Transaktionskonstruktion. Der Anwendungscode konnte erfolgreich kompilieren, während die Transaktion beim Einreichen ins Netzwerk fehlschlug.

Software Development Kits, oder SDKs, bereiteten ähnliche Probleme. Diese Bibliotheken ermöglichen es Anwendungen, Transaktionen zu konstruieren und mit Cardano zu interagieren, doch umbenannte Felder oder geänderte Funktionssignaturen können ältere Beispiele unbrauchbar machen.

Gargiulo lud anfangs aktuelle Dokumentation manuell herunter und verwies den Agenten wiederholt darauf. Neustarts von Sitzungen oder das Komprimieren des Gesprächskontexts bedeuteten, dass diese Anweisungen erneut geliefert werden mussten. Seine Experimente mit Dokumentenabruf erforderten zudem fortlaufende Pflege der Quellen, was zu einem Paket führte, das Referenzen mit wiederverwendbaren Entwicklungsworkflows kombinierte.

Gepflegte Quellen und die CIP-68 Demonstration

Die während der Sitzung vorgestellte Version enthielt 15 Entwicklungsskills und 55 Dokumentationsquellen. Am 2. Oktober listete die offizielle Website des Projekts 18 Skills und 73 Quellen auf, die SDKs, Programmiersprachen, Infrastruktur, CIPs und Ledger Spezifikationen abdecken.

Ein Skill liefert Anweisungen für eine konkrete Aufgabe, etwa das Erstellen einer ADA Transfertransaktion, das Schreiben eines Validators oder das Optimieren eines Contracts. Cardano Improvement Proposals, bekannt als CIPs, liefern technische Standards, die Agenten anhand der beigefügten Quellen erklären und anwenden können.

Das Paket trennt sein Quellregister, Aufgabenanweisungen und heruntergeladene Referenzen. Maintainer können die Dokumentation unabhängig von den Workflows aktualisieren, die einem Agenten sagen, wie er sie nutzen soll.

Aufgabenbeschreibungen helfen dem Agenten zudem, gewöhnliche Anfragen dem passenden Workflow zuzuordnen. Ein Entwickler kann in natürlicher Sprache nach einer Token Transaktion oder einer Vertragsprüfung fragen, sodass der Agent die relevante Fähigkeit ohne expliziten Befehl auswählt.

Ein automatisierter wöchentlicher Prozess ruft Upstream Änderungen ab und eröffnet einen GitHub Pull Request zur menschlichen Überprüfung, bevor sie in den Main Branch gelangen. Nutzer erhalten anschließend das aktualisierte Paket. Claude Code Nutzer müssen automatische Updates für seinen Marktplatz aktivieren oder es manuell aktualisieren.

Die Fähigkeit cardano-context fügt eine dauerhafte Projektanweisung hinzu, die Claude Code oder Codex anweist, bestehendes Cardano Wissen als potenziell veraltet zu betrachten und zuerst die mitgelieferten Referenzen zu konsultieren. Beide Agenten nutzen dieselben Entwicklungsskills und Quellen über ihre jeweiligen Installationswege.

In der Demonstration bat Gargiulo um eine Erklärung von CIP-68, dem Metadatenstandard für Cardano Native Assets. Er unterscheidet ein Referenz NFT, dessen Transaktionsausgabe die Metadaten enthält, von einem Nutzertoken, das den Vermögenswert in der Wallet eines Inhabers repräsentiert. Die Logik des Vertrags des Emittenten bestimmt, ob die Metadaten aktualisiert werden können.

Der Agent reagierte anschließend auf die Anfrage nach einer entsprechenden Transaktion, indem er Entwicklungsanweisungen auswählte und verfügbare Bibliotheken präsentierte. Gargiulo wählte cardano-client-lib, eine Java Bibliothek, und erhielt Projektkonfiguration, Abhängigkeiten und Implementierungscode. Das generierte Beispiel spezifizierte Java 17.

Gargiulo führte das Beispiel während der Sitzung nicht aus. Die Demonstration deckte daher die Vorbereitung der Implementierung ab, wobei End zu End Transaktionstests noch ausstanden.

Feedback und weitere Cardano Anwendungen

Cardano Dev Skills enthält einen Feedback Mechanismus zum Melden fehlerhafter Dokumentation, fehlender Anweisungen oder Fehlentscheidungen bei der Auswahl einer passenden Fähigkeit. Bora, ein Projektbeitragender, beschrieb einen Fall, in dem ein Agent am Ende einer Sitzung einen Bericht vorschlug und den Nutzer bat, ihn vor der Freigabe als GitHub Issue zu prüfen.

Maintainer nutzen diese Berichte, um zu bewerten, ob eine Quelle oder ein Workflow korrigiert werden muss. Gargiulo unterschied zudem Dokumentationsprobleme von Anfragen, die selbst unklar oder technisch fehlerhaft sind, da jede eine andere Reaktion erfordert.

Spezialisierte Beiträge helfen, die Abdeckung zu erweitern. Gargiulo nannte die Ergänzung von Go Material durch einen Beitragenden, der mit der Sprache und ihrem Cardano Tooling vertraut ist. Die Geltungsregeln des Projekts erlauben Entwicklungsintegrationen, Spezifikationen, SDKs und Infrastrukturdokumentation, schließen jedoch Marketingmaterial und Endprodukt Benutzerhandbücher aus.

Der Text des Pakets kann direkt geprüft werden, während seine Helfer Hooks eine Prüfung erfordern, da sie Code ausführen. Gargiulo skizzierte weitere Sitzungen zu Prompt Injection, Vertrauensgrenzen und Situationen, in denen Agenten Dokumentation ignorieren. Er beschrieb zudem Pläne für zusätzliche Arbeiten an Modularität und Kompatibilität mit anderen Agenten in der zweiten Oktoberhälfte.

Zu den in der Sitzung diskutierten möglichen Erweiterungen gehörten die Bewertung von Governance Vorschlägen anhand der Cardano Constitution und ein Testnet Experiment, bei dem Nutzer einen Agenten in USDCx für eine Smart Contract Prüfung bezahlen würden, möglicherweise über Masumi. Diese wurden jeweils als laufende Arbeit und als vorgeschlagenes Experiment präsentiert.

Hackathon Onboarding lieferte eine konkrete Anwendung für das bestehende Paket. Für ein geplantes 36 Stunden langes Event in Singapur beschrieb ein Teilnehmer, den Entwicklern Cardano Dev Skills und ein paar Start Prompts zu geben, statt für jedes Team eine umfangreiche Ressourcenliste zusammenzustellen.

In diesem Workflow kann ein Team mit einer Transaktion, einem Validator oder einem Token Standard innerhalb seines Programmieragenten beginnen. Die relevanten Aufgabenanweisungen und technischen Referenzen stehen in derselben Umgebung zur Verfügung, während Probleme, die während der Implementierung entdeckt werden, über den Feedback Prozess des Pakets gemeldet werden können.