Cardano Dev Skills 将 AI 代理连接到最新文档

Cardano Dev Skills 为 AI 编码代理提供构建交易、编写智能合约以及理解 Cardano 标准的操作指引和技术参考。该包旨在解决一个反复出现的开发问题：代理可能生成看似合理但依赖过时库或网络规则的代码。

Cardano Foundation 的高级区块链架构师 Giovanni Gargiulo 在 9 月 18 日的 Developers Office Hours 中演示了该工具，引导一个代理从解释 CIP-68 到给出 Java 实现示例。

Cardano 代码中的 Aiken 与 Conway 错误

Gargiulo 发现修正 AI 生成的代码有时比他自己实现方案还要耗时，于是启动了该项目。最初的个人实验后来被移入 Cardano Foundation 的 GitHub 组织，并向社区开放贡献。

一个反复出现的问题与 Aiken 有关，这是一种在 Cardano 上开发智能合约的语言。即使在 Gargiulo 明确要求使用第 3 版文档时，代理仍沿用标准库 2.4 版的用法，导致生成的代码无法编译。

Conway 时代的变更带来了另一处故障点。在处理权益地址注册与证书时，代理把较新的要求与较旧的交易构造方式混在一起，应用代码虽可成功编译，但交易提交到网络时仍会失败。

软件开发工具包，即 SDKs，也出现了类似问题。这些库让应用能够构造交易并与 Cardano 交互，但字段改名或函数签名变更会使旧示例无法使用。

起初，Gargiulo 手动下载最新文档并反复引导代理查阅。会话重启或对话上下文被压缩意味着这些指示需要一再提供。他在文档检索方面的实验也需要持续维护来源，最终促成了一个将参考资料与可复用开发工作流结合在一起的包。

经维护的来源与 CIP-68 演示

会中展示的版本包含 15 项开发技能和 55 个文档来源。到 10 月 2 日，该项目的官方网站列出了 18 项技能和 73 个来源，涵盖 SDKs、编程语言、基础设施、CIPs 和分类账规范。

每项技能都为特定任务提供指引，例如构建 ADA 转账交易、编写验证器或优化合约。Cardano Improvement Proposals，简称 CIPs，提供技术标准，代理可借助配套来源对其进行解读与应用。

该包将来源注册表、任务指引和已下载参考资料相互分离。维护者可以独立于指导代理如何使用文档的工作流来更新文档。

任务描述还能帮助代理将普通请求匹配到合适的工作流。开发者可以用自然语言请求代币交易或合约审查，代理无需显式命令即可选择相关技能。

一项每周自动流程会获取上游变更，并在进入主分支前发起 GitHub 拉取请求以供人工审查。随后用户即可获得更新后的包。Claude Code 用户需要为其市场启用自动更新，或手动更新。

cardano-context 技能会添加一条持久的项目指令，提示 Claude Code 或 Codex 将现有的 Cardano 知识视为可能过时，并优先查阅随附参考资料。两种代理都会通过各自的安装路径使用相同的开发技能与来源。

在演示中，Gargiulo 要求解释 CIP-68，这是一项针对 Cardano 原生资产的元数据标准。它区分了引用型 NFT，其交易输出存放元数据，与代表该资产并存在持有者钱包中的用户代币。元数据是否可更新由发行方的合约逻辑决定。

随后，代理根据构造相应交易的请求选择了开发指引并列出了可用库。Gargiulo 选择了 Java 库 cardano-client-lib，并收到了项目配置、依赖项与实现代码。生成的示例指定使用 Java 17。

会中 Gargiulo 并未实际运行该示例。因此此次演示主要覆盖了实现的准备工作，端到端的交易测试仍待完成。

反馈与更多 Cardano 应用

Cardano Dev Skills 包含一个反馈机制，用于报告文档不准确、指引缺失或未能选择合适技能的情况。项目贡献者 Bora 提到过这样一例：在一次会话结束时，代理提出生成一份报告，并请用户先行审阅，再批准将其作为 GitHub issue 提交。

维护者会利用这些报告评估来源或工作流是否需要修正。Gargiulo 还区分了文档问题与本身表达不清或技术上有缺陷的请求，因为两者需要不同的应对方式。

专业人士的贡献有助于扩展覆盖范围。Gargiulo 举例称，一位熟悉该语言及其 Cardano 工具链的贡献者补充了 Go 相关材料。项目的范围规则接纳开发集成、规范、SDKs 与基础设施文档，但不包含市场营销材料和成品用户手册。

该包的文本可以直接检查，而其辅助钩子因会执行代码而需要审查。Gargiulo 概述了后续将围绕提示注入、信任边界以及代理忽视文档等情形开展的讨论。他还表示计划在十月下半月进一步开展模块化和与其他代理的兼容性工作。

会中讨论的潜在扩展包括依据 Cardano Constitution 评估治理提案，以及在测试网进行的一项实验，其中用户将以 USDCx 向代理支付智能合约审查费用，可能通过 Masumi 完成。二者分别被呈现为进行中的工作与拟议中的实验。

黑客松的入门引导为该现有包提供了一个具体用例。针对在新加坡计划举行的 36 小时活动，有参与者表示将向开发者提供 Cardano Dev Skills 和少量起始提示，而不是为每个团队整理一份庞大的资源清单。

在该工作流中，团队可以在其编码代理内从交易、验证器或代币标准入手。相关任务指引与技术参考在同一环境中可用，实施过程中发现的问题可通过该包的反馈流程进行报告。