agentic-awesome-skills 中的 aomi-transact：用自然语言驱动 EVM 链上交易的 DeFi Agent 技能实战指南-二趣网

agentic-awesome-skills 中的 aomi-transact：用自然语言驱动 EVM 链上交易的 DeFi Agent 技能实战指南

【免费下载链接】agentic-awesome-skillsAAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,115+ agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址: https://gitcode.com/gh_mirrors/an/agentic-awesome-skills

导读：本文围绕开源仓库 agentic-awesome-skills 收录的aomi-transact技能（SKILL.md）展开，讲解如何让 AI 代理把“把 1 ETH 换成 USDC”这类自然语言指令，转化为经过分叉链模拟、排队等待钱包签名的链上交易。读完你将掌握 Aomi CLI 的四种典型工作流（只读查询、单笔交易、多步批量、跨链桥接）、强制模拟与显式签名两道安全门禁，以及该技能在仓库目录与索引中的定位与使用边界。

技能定位：自然语言到钱包签名交易的翻译层

aomi-transact是一个**高风险（risk: critical）**技能，收录于本仓库的 plugins/agentic-awesome-skills-claude/skills/aomi-transact/SKILL.md（同一份 canonical SKILL.md 也存在于 plugins/agentic-awesome-skills/skills/aomi-transact/SKILL.md 与 skills/aomi-transact/SKILL.md，三处内容一致）。

它的职责是驱动 Aomi CLI（npm 包@aomi-labs/client）完成一次典型的"提示词 → 交易"转换链路：

用户输入自然语言指令，例如"swap 1 ETH for USDC on Uniswap"；
代理挑选正确的协议与合约，将 approve + swap 编排为一个交易批次（batch）；
在分叉链（forked chain）上逐笔模拟该批次；
返回一个已排队（queued）的钱包请求tx-N，等待用户显式签名；
钱包只会看到已通过模拟的 calldata，不会接触到未经验证的交易内容。

从仓库的元数据可以看到该技能的完整画像：在 data/catalog.json 中，它被归类为category: "ai-ml"，携带defi / wallet / account-abstraction / cli / eip-712 / onchain / agent / intent等标签，以及一组触发词（defi、wallet、eip-712、aomi、transact等），便于代理在匹配用户意图时被自动唤起；在 skills_index.json 中，它还声明了插件支持矩阵：codex: supported、claude: supported，且setup 类型为 none（无需额外安装配置即可被代理加载使用）。

Account-Abstraction 优先的 CLI 设计

该 CLI 默认走账户抽象路径，而非传统 EOA 直签：

默认通过零配置的 Alchemy 代理完成签名（无需提供 provider 凭据）；
以太坊主网使用EIP-7702，L2 上使用ERC-4337；
每次aomi <subcommand>调用都是"启动 → 运行 → 退出"，不存在常驻后台进程，天然适合被代理以单条命令的方式驱动。

这一设计同时决定了技能的使用方式：代理每次只需执行一条 CLI 命令，并在关键节点（模拟后、签名前）停下来与用户交互。

何时启用该技能

根据 SKILL.md 的"When to Use This Skill"清单，以下场景应当唤起aomi-transact：

用户想从终端直接与 Aomi 代理对话；
用户需要余额、价格、路由、报价或交易状态；
用户需要构建、模拟、确认、签名或广播钱包请求；
用户希望在签名前模拟一批待处理交易；
用户需要查看或切换 app、模型、链或会话；
用户需要查看或修改账户抽象设置（EIP-7702 / ERC-4337）；
用户需要签署 EIP-712 类型化数据（链下协议、intent 填充等）。

与之对应的典型场景是只读的价格/余额查询——这类操作不会排队任何钱包请求，属于低风险使用方式，适合作为首次体验入口。

四条核心工作流实战

SKILL.md 给出了四条代表性工作流，从只读到跨链，覆盖了该技能绝大多数使用形态。

只读：价格查询

aomi --prompt "what is the price of ETH?" --new-session

该命令返回报价，不排队任何钱包请求。执行后可用aomi tx list确认没有待处理交易。这是验证代理连接是否正常、CLI 是否就绪的最安全方式。

单笔交易：Lido 质押

aomi chat "Stake 0.01 ETH with Lido to get stETH" \ --public-key 0xUserAddress --chain 1 --new-session aomi tx list

该流程会在 Lido stETH 合约（0xae7ab96520DE3A18E5e111B5EaAb095312D7fE84）上构造submit(address(0))调用，value = 0.01 ETH，单笔交易、无需 approve。代理应在此处停下：展示排队交易详情，等待用户显式指令（例如sign tx-1）后才可进入签名环节。

多步批量：Uniswap V3 兑换

aomi chat "swap 1 USDC for WETH on Uniswap V3, send to my wallet" \ --public-key 0xUserAddress --chain 1 --new-session aomi tx list # tx-1 = approve, tx-2 = swap aomi tx simulate tx-1 tx-2 # 多步批量必做

这是该技能的核心能力展示：

兑换被编排为两笔交易：tx-1是 USDC 授权（approve），tx-2是 swap；
模拟器会在分叉链上按顺序逐笔执行，因此 swap 步骤能看到 approve 带来的状态变更；
不能跳过模拟、不能单独签名第 2 步——若单独签名 swap，它会因授权尚未生效而 revert；
模拟完成后代理必须停下来，汇总整个批次，等待用户点名两个 tx id的显式签名指令。

跨链：CCTP 从 Ethereum 桥接到 Base

aomi chat "Bridge 50 USDC from Ethereum to Base via CCTP. Recipient is my wallet." \ --public-key 0xUserAddress --chain 1 --new-session aomi tx list aomi tx simulate tx-1 tx-2

同样在模拟后停下等待显式批准。SKILL.md 还给出了跨链时间预期：签名后，源链（Ethereum）上的销毁（burn）确认约在1–2 个区块内完成；目标链（Base）上的铸造（mint）则需要等待 Circle 的链下证明（attestation），约13–19 分钟。这一时间差对用户预期管理很有价值。

签名门禁：代理必须遵守的两条红线

该技能在文档开头用两段高优先级说明（> **Authorized use only.**与> **Signing gate.**）定义了不可逾越的安全规则：

未经用户显式请求不得签名：aomi tx sign只有在用户明确要求，且存在由aomi tx list排队的对应tx-N时才能运行；
签名命令不得出现在可复制的多命令块中：代理在展示或执行命令时，应止步于"列出或模拟已排队交易"，随后汇总 tx id、链、金额、接收方、calldata 用途与模拟结果，并向用户索要诸如sign tx-1的显式签名指令；收到独立批准后，才运行精确的签名命令。

这一设计把"构建/模拟"与"签名/广播"彻底解耦，确保任何自动化流程都无法在未经过户确认的情况下触碰链上资产。

已知局限与边界

SKILL.md 明确列出了 6 项使用限制，理解它们对生产级使用至关重要：

CLI 版本要求：需要@aomi-labs/clientv0.1.30 或更新版本。更早的版本缺少--aa、--aa-provider、--aa-mode参数及模拟门禁。安装方式为npm install -g @aomi-labs/client，或按需执行npx @aomi-labs/client@0.1.30 ...。
后端连接依赖：CLI 与api.aomi.dev通信。无网络时仅本地只读命令（aomi tx list、aomi session log）可用。
L2 上的 AA 赞助不保证：v0.1.30 的零配置代理路径在 Base/Arbitrum/Optimism 上不能可靠赞助 gas。若 EOA 在目标链上原生 gas 为 0，aomi tx sign会返回 viem 的insufficient funds for transfer。对策是：向 EOA 转入少量原生 gas，或配置真正的 BYOK（自备密钥）Alchemy/Pimlico 提供商并启用赞助策略。注意不要改用--eoa重试——该路径同样需要 gas。
按会话注入凭据：需要 provider token 的应用（binance、polymarket、dune等），必须由用户在自己的 shell 中配置，或通过aomi secret add NAME=<value>添加。技能永远不会主动设置凭据。
Drain 向量被门禁拦截：代理会拒绝recipient/onBehalfOf/mintRecipient≠msg.sender的 calldata。这是安全特性而非缺陷——应把拦截结果如实呈现给用户，而不是改写提示词绕开。
网络/RPC 故障：公共 RPC 可能限流（429）或鉴权失败（401）。生产环境签名必须由用户提供与链匹配的可靠 RPC（--rpc-url）。
报价与 deadline 过期：带 deadline 的路由（Across、Khalani filler 等）在用户审核期间报价可能失效；代理会通过重建新 deadline 自愈，但用户仍应复查aomi tx list以确认最新通过的批次。

最佳实践清单

SKILL.md 归纳了 7 条最佳实践，构成了该技能的安全操作公约：

新任务首条命令默认加--new-session。任务中途复用该参数会开启全新会话，代理将丢失刚给出的报价上下文。
签名前永远先aomi tx list，绝不假设聊天响应已经排队了交易。
多步批量签名前永远先aomi tx simulate tx-1 tx-2 ...；单笔交易模拟可选，但模拟永远不会是多余操作。
签名命令不进入可执行示例：aomi tx sign只允许在用户给出点名tx-N的独立显式批准后展示或执行。
只签Batch [...] passed的交易，跳过早期失败尝试留下的孤儿交易（表现为failed at step N: 0x...）。
--rpc-url要与排队交易的链匹配，而不是与会话链--chain匹配——两者是相互独立的控制项。
绝不回显凭据值：技能只通过 handle 名称或派生地址确认凭据配置完成。

授权声明与风险边界

SKILL.md 在 Authorization Disclaimer 中强调：本技能能够签名并广播具有真实价值的链上交易，只能用于自己拥有的账户和信任的网络。技能不托管资金——签名密钥始终由用户通过--public-key与底层钱包完全掌控。运行aomi tx sign之前，必须逐一审核每个排队的tx-N。

从仓库的索引体系看，这一风险定位同样被显式记录：在 data/catalog.json 与 skills_index.json 中，aomi-transact的风险等级均为critical，且其内容哈希与大小被登记在 data/aas-v1/skill-content-index.v1.json 的索引中，供目录发现与完整性校验使用。

在 AAS 仓库中的定位与延伸阅读

aomi-transact是 AAS（agentic-awesome-skills）技能库中"链上交易"类目的代表条目：入口是 SKILL.md，元数据（分类、风险、标签、触发词、插件支持）见 data/catalog.json 与 skills_index.json。

该 SKILL.md 明确指出：完整的技能包（含account-abstraction.md、apps.md、examples.md、session.md、troubleshooting.md、drain-vectors.md等参考文档、aomi-workflow.sh模板，以及按主机区分的agents/openai.yaml元数据）位于上游aomi-labs/skills仓库，本条目只是canonical SKILL.md。若需完整 bundle，应克隆上游仓库；本仓库收录的该技能同样遵循 MIT 许可。

小结

aomi-transact展示了一种"意图 → 模拟 → 显式签名"的安全交易代理模式：代理负责协议选择、批量编排与分叉链模拟，而签名权始终保留在用户手中。无论你是要接入 DeFi 价格查询、Lido 质押、Uniswap 兑换，还是 CCTP 跨链桥接，都可以把这份 SKILL.md 作为起点，在理解其版本要求、模拟门禁与 gas 边界的前提下，将其安全地嵌入 Claude Code、Cursor、Codex 或 Gemini 的代理工作流。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析