Cardano Dev Skills подключает агентов ИИ к актуальной документации

Cardano Dev Skills предоставляет агентам ИИ для программирования инструкции и технические справочные материалы для построения транзакций, написания смарт контрактов и понимания стандартов Cardano. Пакет решает повторяющуюся проблему разработки: агенты могут выдавать убедительный код, который опирается на устаревшие библиотеки или правила сети.

Giovanni Gargiulo, Senior Blockchain Architect в Cardano Foundation, продемонстрировал инструмент во время Developers Office Hours 18 сентября, проведя агента от объяснения CIP-68 к примеру реализации на Java.

Ошибки Aiken и Conway в коде Cardano

Gargiulo начал проект после того, как обнаружил, что исправление сгенерированного ИИ кода иногда занимало больше времени, чем самостоятельная реализация решения. То, что начиналось как личный эксперимент, позже переехало в организацию Cardano Foundation на GitHub и открылось для вкладов сообщества.

Одной из повторяющихся проблем был Aiken, язык для разработки смарт контрактов на Cardano. Агент продолжал использовать шаблоны из стандартной библиотеки версии 2.4, даже когда Gargiulo запрашивал документацию для версии 3. В результате код не компилировался.

Изменения эпохи Conway создали другую точку отказа. Работая с регистрацией адреса стекинга и сертификатами, агент объединил новые требования со старым подходом к построению транзакции. Код приложения мог успешно компилироваться, тогда как транзакция отклонялась при отправке в сеть.

Наборы средств разработки, или SDK, создавали схожие проблемы. Эти библиотеки позволяют приложениям конструировать транзакции и взаимодействовать с Cardano, но переименованные поля или измененные сигнатуры функций могут сделать старые примеры непригодными.

Gargiulo изначально вручную скачивал актуальную документацию и снова и снова направлял к ней агента. Перезапуск сессий или сжатие контекста беседы означали, что эти указания приходилось давать заново. Его эксперименты с извлечением документации также требовали постоянного сопровождения источников, что привело к созданию пакета, сочетающего справочные материалы с повторно используемыми рабочими процессами разработки.

Поддерживаемые источники и демонстрация CIP-68

Версия, показанная во время сессии, содержала 15 навыков разработки и 55 источников документации. 2 октября официальный сайт проекта указал 18 навыков и 73 источника, охватывающих SDK, языки программирования, инфраструктуру, CIPs и спецификации реестра.

Навык предоставляет инструкции для конкретной задачи, например построение транзакции перевода ADA, написание валидатора или оптимизацию контракта. Cardano Improvement Proposals, известные как CIPs, предоставляют технические стандарты, которые агенты могут объяснять и применять с опорой на сопутствующие источники.

Пакет разделяет реестр источников, инструкции по задачам и загруженные справочные материалы. Мейнтейнеры могут обновлять документацию независимо от рабочих процессов, которые указывают агенту, как ею пользоваться.

Описания задач также помогают агенту сопоставлять обычные запросы с подходящим рабочим процессом. Разработчик может попросить провести токен транзакцию или ревью контракта на естественном языке, и агент выберет соответствующий навык без явной команды.

Автоматический еженедельный процесс забирает изменения из апстрима и открывает pull request в GitHub для ручного ревью перед их попаданием в основную ветку. После этого пользователи получают обновленный пакет. Пользователям Claude Code нужно включить автообновления для его маркетплейса либо обновить пакет вручную.

Навык cardano-context добавляет постоянную инструкцию для проекта, предписывающую Claude Code или Codex рассматривать имеющиеся знания о Cardano как потенциально устаревшие и сначала обращаться к включенным справочным материалам. Оба агента используют одни и те же навыки разработки и источники через свои маршруты установки.

В демонстрации Gargiulo запросил объяснение CIP-68, стандарта метаданных для нативных активов Cardano. Он различает референсный NFT, чей выход транзакции хранит метаданные, и пользовательский токен, представляющий актив в кошельке держателя. Логика контракта эмитента определяет, можно ли обновлять метаданные.

Затем агент ответил на запрос о соответствующей транзакции, выбрав инструкции по разработке и представив доступные библиотеки. Gargiulo выбрал cardano-client-lib, библиотеку на Java, и получил конфигурацию проекта, зависимости и код реализации. В сгенерированном примере была указана Java 17.

Gargiulo не запускал пример во время сессии. Таким образом, демонстрация охватила подготовку реализации, а сквозное тестирование транзакции еще предстояло.

Обратная связь и дальнейшие применения Cardano

Cardano Dev Skills включает механизм обратной связи для сообщения о некорректной документации, отсутствующих инструкциях или ошибках выбора подходящего навыка. Bora, участник проекта, описал случай, когда агент предложил сформировать отчет в конце сессии и попросил пользователя его проверить перед одобрением отправки как issue в GitHub.

Мейнтейнеры используют эти отчеты, чтобы оценить, нуждается ли источник или рабочий процесс в исправлении. Gargiulo также разделил проблемы документации и запросы, которые сами по себе неясны или технически некорректны, поскольку для них требуются разные реакции.

Специализированные вклады помогают расширять охват. Gargiulo привел пример добавления материалов по Go участником, знакомым с языком и инструментами Cardano. Правила охвата проекта допускают интеграции для разработки, спецификации, SDK и инфраструктурную документацию, исключая маркетинговые материалы и пользовательские руководства конечных продуктов.

Текст пакета можно просматривать напрямую, тогда как его вспомогательные хуки требуют ревью, поскольку выполняют код. Gargiulo обозначил последующие сессии по инъекции подсказок, границам доверия и ситуациям, когда агенты игнорируют документацию. Он также описал планы по дополнительной работе над модульностью и совместимостью с другими агентами во второй половине октября.

Среди возможных расширений, обсуждавшихся во время сессии, были оценка предложений по управлению на соответствие Cardano Constitution и эксперимент в тестнете, в рамках которого пользователи платили бы агенту в USDCx за ревью смарт контракта, возможно через Masumi. Эти идеи были представлены соответственно как работа в процессе и предложенный эксперимент.

Онбординг хакатона дал конкретное применение существующему пакету. Для запланированного мероприятия на 36 часов в Сингапуре один из участников описал подход, при котором разработчикам выдаются Cardano Dev Skills и несколько стартовых подсказок вместо составления обширного списка ресурсов для каждой команды.

В таком рабочем процессе команда может начать с транзакции, валидатора или стандарта токена прямо внутри своего агента для программирования. Соответствующие инструкции по задачам и технические справочные материалы доступны в той же среде, а обнаруженные в ходе реализации проблемы можно сообщать через процесс обратной связи пакета.