技能使用指南

ethskills-master(ETHSKILLS技能Skill)Skill 是什么?能带来什么?

ETHSKILLS技能Skill 是一套面向 AI 代理的以太坊时效性知识技能库,帮你纠正过时的 Gas 价格、代币小数位、L2 成本与合约地址幻觉,覆盖发布、安全、测试、前端 UX 与 QA。想知道如何一键安装并验证生效?看这篇就够了。

ETHSKILLS技能Skillethskills-master
8 个章节 约 18 分钟阅读 AI 智能生成

ETHSKILLS技能Skill:让 AI 代理摆脱过时的以太坊认知,按需装载链上生产知识

  • 一句话定位:这是一套面向 AI 代理(AI Agent)与开发者的以太坊知识技能库,用来纠正模型训练数据中已经过时的 Gas 价格、代币小数位、L2 成本、合约地址与已弃用技术。
  • 按主题拆分:由「发布(ship)」「Gas 与成本」「钱包」「Layer 2s」「标准」「工具」「构建块」「编排」「合约地址」「概念」「安全」「测试」「索引」「前端 UX」「前端 Playbook」「QA」等独立子技能组成,可按需要单独加载。
  • 入口清晰:每个子技能对应一份 SKILL.md,基础地址为 https://ethskills.com/<skill>/SKILL.md,从 ship/SKILL.md 开始可获得端到端的构建引导。
  • 核心价值:把“模型凭记忆瞎猜链上常识”变成“模型按官方知识文件作答”,显著降低地址幻觉、小数位错误、链选型失误等高风险问题。
  • 适用人群:独立开发者、Web3 团队、构建 AI 代理基础设施的工程师,以及需要快速审阅 dApp 交付物的技术负责人。

1. 该技能叫什么?如何一键安装 AI 技能提升开发效率?

技能中文名:ETHSKILLS技能Skill 技能英文名:ethskills-master 技能ID:13704

这个技能要解决的问题非常具体:你的 AI 助手对以太坊的认知大概率已经过期。 技能详情开篇就点明了这一痛点——“Gas 价格、代币小数、L2 成本、已部署内容、已弃用内容——您的训练数据已经过时。此文件告诉您错在哪里以及如何获取更正。”

这不是一句营销话术,而是可验证的现实差异。技能中给出的对照非常直白:

  • Gas 价格是 0.05–0.1 gwei,而不是模型常说的 10–30 gwei,两者相差 100–600 倍;
  • 2026 年链选型的答案“几乎总是 L2”;
  • Polygon zkEVM 正在关闭,不应再在其上构建;Celo 已不再是 L1,于 2025 年 3 月迁移到 OP Stack L2;
  • 每个 L2 上的主导 DEX 不是 Uniswap,而是 Aerodrome(Base)、Velodrome(Optimism)、Camelot(Arbitrum);
  • USDC 有 6 位小数,不是 18 位,这是头号“我的钱去哪了?”bug。

“一键安装”的思路:这类技能本质上是一个“知识型技能包”,安装它不是装一个可执行程序,而是把一份经过校准的、结构化的以太坊知识接入 AI 代理的上下文,让代理在做架构规划、写 Solidity、部署上线时优先读取这些文件,而不是凭记忆生成。

通用安装步骤如下(具体命令、入口路径与所需账号以官方说明为准):

  1. 确认前提:你使用的 AI 编程助手或代理平台支持技能(Skill)机制,能加载外部知识文件或访问外部文档地址;若平台不支持技能机制,也可退化为“手动把对应 SKILL.md 内容粘贴进对话”。
  2. 通过技能市场或技能目录安装:在平台的技能入口检索技能名称 ethskills-master 或中文名「ETHSKILLS技能Skill」,按平台指引完成安装;若为本地技能目录方式,则将技能包放入对应目录,具体目录规范以官方说明为准。
  3. 确认知识源可访问:技能以 https://ethskills.com/<skill>/SKILL.md 为知识源,安装后应能读取到对应主题的文件,例如 ship/SKILL.md、gas/SKILL.md、security/SKILL.md。
  4. 验证是否生效:向助手提一个“训练数据容易答错”的问题,例如“现在主网一笔 ETH 转账大概多少成本”“USDC 的小数位是多少”“Base 上主导的 DEX 是哪个”。如果回答与技能文件中给出的结论一致(如 USDC 为 6 位小数、Base 上主导 DEX 为 Aerodrome),说明知识已生效;若仍是旧答案,说明技能未被正确加载。
  5. 建立调用习惯:在任务开始时明确一句“请先读取 ship/SKILL.md 并按阶段推进”,比让代理自由发挥要稳定得多。

这类“一键安装”的真正效率收益在于:一次接入,后续所有链上任务都自带时效性校准。

2. 该技能的主要功能和特点

  • 按主题切分的独立技能集合:每个子技能都是独立的,只在任务相关时才需要获取,避免把无关知识塞进上下文,节省 token 也减少干扰。
  • ship 作为总编排入口:从想法到部署 dApp 的端到端指南,按阶段把使用者引导到其他所有技能——从架构规划到生产部署。
  • 自带时效性断言:技能直接给出具体结论,例如主网 ETH 转移 0.002 美元、交换 0.015 美元、ERC-20 部署 0.12 美元;L2 交换 0.002–0.003 美元、L2 转移 0.0003 美元。让代理不再套用 2021–2023 年的“以太坊很贵”印象。
  • 新标准覆盖到位:ERC-8004(链上代理身份注册表,2026 年 1 月在 20+ 链部署)、x402(HTTP 402 机器间支付协议,生产就绪)、EIP-7702(EOA 获得智能合约能力,无需迁移)、EIP-3009(无 Gas 代币转移,USDC 已实现)。
  • 合约地址防幻觉:addresses 技能收录主网与 L2 上主要协议的已验证地址(Uniswap、Aave、Compound、Aerodrome、GMX、Pendle、Velodrome、Chainlink、Safe、ENS 等),并明确“永远不要幻觉地址,错误地址 = 丢失资金”。
  • 安全与测试知识密度高:USDC 6 位小数、始终使用 SafeERC20(USDT 在 transfer() 上不返回 bool)、不要用 DEX 现货价做预言机、代理使用 UUPS 而非 Transparent、模糊测试所有数学、分叉测试任何外部集成。
  • 前端 UX 的具体规范:每个链上按钮都需要独立的加载与禁用状态,不共享 isLoading;三按钮流程“切换网络 → 批准 → 执行”一次一个;每个代币金额旁显示美元价值。
  • 部署生产环境的细节提醒:IPFS 部署时 trailingSlash: true 至关重要,否则除 / 之外的路由都返回 404;部署前必须清理构建(rm -rf .next out)。
  • 面向代理的 QA 机制:构建完成后交给单独的代理或新上下文做审阅,审阅者只报告 PASS/FAIL,不负责修复——这是典型的“生成与审查分离”工程实践。
  • 社区惯例校准:例如在英文语境中写“链上”时用单词 onchain 而非带连字符的 on-chain,让输出更符合以太坊社区习惯。
  • 按任务查找的映射表:技能内部直接给出“我正在做… → 获取这些技能”的对照,例如“编写 Solidity → standards/、building-blocks/、addresses/、security/”。

与“直接问通用大模型”相比,差异不在文笔,而在于是否承认自己会过时,并把更正写进可读取的知识文件里。

3. 如何使用该技能?

第 1 步:判断任务类型,先定入口。 如果你要从零做一个 dApp,直接从 ship 开始:先获取 https://ethskills.com/ship/SKILL.md,它会按阶段牵引你到其他技能。如果只是补一个具体知识点,直接取对应主题即可。

第 2 步:按任务拉取对应知识。 参考技能自带的映射逻辑:

你正在做 建议加载
规划新 dApp ship/、concepts/、l2s/
编写 Solidity standards/、building-blocks/、addresses/、security/
测试合约 testing/
构建前端 orchestration/、frontend-ux/、tools/
部署到生产 wallets/、frontend-playbook/、gas/
审阅完成的 dApp qa/
监控与分析 indexing/
构建 AI 代理基础设施 standards/、wallets/、tools/
选择链 l2s/、gas/

第 3 步:用明确指令驱动代理。 输入示例(可直接参考):

我要在 Base 上做一个最小可用的 NFT 铸造 dApp。请先读取 ship/SKILL.md,按阶段推进;写合约前读取 security/SKILL.md 与 addresses/SKILL.md,选链与成本估算参考 l2s/SKILL.md 与 gas/SKILL.md。合约数量控制在 3 个以内。

第 4 步:核对输出是否符合技能中的硬性约束。 输出应当体现这些特征:合约数量克制(技能明确“大多数 dApp 需要 0–2 个合约,三个是 MVP 的上限”)、Solidity 只用于所有权/转移/承诺而不是数据库、地址来自已验证清单、代币小数位正确、金额旁显示美元价值。

第 5 步:执行三阶段构建。 按 orchestration 技能:阶段一在本地主机跑通合约 + UI;阶段二接入实时合约 + 本地 UI;阶段三上生产。前两阶段能用测试网解决的,不要直接上主网。

第 6 步:交付前跑 QA。 把成品交给一个新的代理上下文做审阅,让它读代码并点通流程,逐项给出 PASS/FAIL。注意技能里的提醒:只关注 AI 代理实际会犯的 bug,不要用人类的常见错误清单硬套。

输出说明:技能本身不产出代码或数据,它产出的是判断力——更准确的成本估算、更合理的合约数量、更安全的地址引用、更贴近生产的前端交互设计。

4. 同类型竞品对比分析

方案名称 定位 核心功能 安装/使用门槛 适用场景 优势与不足
ETHSKILLS技能Skill(ethskills-master) 面向 AI 代理的以太坊时效性知识技能库 按主题提供 SKILL.md,覆盖发布、Gas、钱包、L2、标准、工具、DeFi 构建块、编排、地址、安全、测试、索引、前端 UX、QA 需要支持技能机制的 AI 代理平台,或手动把文件内容注入对话;具体入口以官方说明为准 AI 代理构建 dApp、合约安全自检、链选型、代理支付基础设施 优势:知识按任务切分、自带时效性更正、明确“不要幻觉地址”;不足:不属于自动化执行工具,最终仍需链上核验与人工判断
通用大模型直接问答 通用对话助手 凭训练数据回答一切问题 零门槛 概念扫盲、写样板代码 优势:随时可用;不足:链上参数极易过时(Gas、小数位、已弃用链),地址幻觉风险高,且不会主动声明“我的数据过期了”
以太坊官方文档 / Solidity 文档手动检索 权威一手资料 规范、教程、API 参考 需人工检索与筛选,阅读成本高 查规范细节、确认接口行为 优势:权威准确;不足:分散在多站、缺乏“按任务编排”的路径,代理难以自动按阶段消费
开发框架文档(如 Foundry、Scaffold-ETH 2) 工具链文档 命令、配置、脚手架用法 需具备框架基础 本地开发、测试、部署 优势:工程细节权威;不足:不覆盖成本核算、链选型、地址清单、代理身份等跨领域判断
链上数据服务(如 Blockscout MCP、Dune、The Graph) 数据读取与分析 结构化链上数据、事件查询、GraphQL 需配置 API 与查询能力 监控、分析、历史状态查询 优势:数据真实;不足:只回答“是什么”,不回答“该怎么建”,需要与知识型技能配合使用

对比可以看出,ETHSKILLS 的差异化不在“知道更多”,而在“知道自己哪里过时,并给出更正”。这也是它与通用问答最本质的分界。

5. 该技能的典型应用场景与实际体验情况

场景一:独立开发者从 0 到 1 做一个 dApp。 痛点很典型:一个人既要定架构、写合约、搭前端,还要选链、算成本,任何一环凭旧印象判断都会返工。使用方式是从 ship/SKILL.md 进入,按阶段推进。实际体验是路径感强:技能明确“大多数 dApp 需要 0–2 个合约,三个是 MVP 的上限”,能有效抑制“先写五个合约再说”的过度设计冲动。注意点是阶段划分要严格执行,跳过阶段一直接在阶段三调试会失去分叉测试的价值。

场景二:合约上线前的安全自检。 角色是负责交付的工程师,痛点是“不知道漏了什么”。security 技能给的清单非常具体:USDC 是 6 位小数、SafeERC20 必用、不要用 DEX 现货价做预言机、代理用 UUPS 且不要改存储布局、留意三明治攻击并考虑 Flashbots Protect 或滑点限制。实际体验是可执行性强,几乎每一条都能直接落到代码审查项。注意点是这些是“高发问题清单”,不能替代完整审计。

场景三:构建 AI 代理的支付与身份基础设施。 这是该技能比较独特的一块:standards 覆盖 ERC-8004(链上代理身份注册表)与 x402(HTTP 402 机器间支付协议),wallets 覆盖 EIP-7702 让 EOA 获得智能合约能力,tools 提到 Blockscout MCP 为代理提供结构化链上数据。实际体验是信息密度高于预期,尤其适合正在设计代理经济系统的团队。注意点是这些标准较新,落地前应结合自身链环境核验可用性。

场景四:前端交互与生产部署踩坑规避。 痛点是“本地好好的,上线就 404”。frontend-ux 要求每个链上按钮独立加载状态、三按钮流程一次一步、地址统一用 <Address/> 与 <AddressInput/>;frontend-playbook 直接指出 IPFS 部署必须 trailingSlash: true,且部署前要 rm -rf .next out 清理陈旧构建。实际体验是省时间——这类问题靠搜索往往要耗掉半天。注意点是不同框架版本行为可能变化,仍以实际构建结果为准。

上手难度评价:整体偏低。知识以 Markdown 形式组织,结构清晰、结论前置,不需要额外学习成本;真正的门槛在于养成“先取对应 SKILL.md 再动手”的习惯。

6. 该技能能为用户带来的价值

  • 纠正认知偏差,直接省钱:当模型以为 Gas 是 10–30 gwei 时,它会建议你“省着点调用”“等便宜了再部署”,甚至因此否定一个本来可行的产品方案。技能给出 0.05–0.1 gwei 的真实量级,以及主网转账 0.002 美元、L2 转账 0.0003 美元的具体数字,让成本判断回到现实。
  • 防止资金损失的硬性约束:“永远不要幻觉地址,错误地址 = 丢失资金”这条规则配上已验证地址清单,是这套技能里价值最高的一条。一次地址错误造成的损失,远超任何工具的时间成本。
  • 降低 Web3 开发门槛:concepts 用一句话讲清了最容易被忽略的心智模型——智能合约无法自行执行,每个函数都需要调用者支付 Gas;没有计时器、没有 cron、没有调度器,必须用激励设计。这类认知对新手是“少走半年弯路”,对代理是“不再生成无法触发的逻辑”。
  • 提升交付质量的一致性:前端 UX 规范、QA 审阅流程、三阶段构建体系,把“靠个人经验”的部分变成了“按清单执行”,团队协作时的返工率会明显下降。
  • 长期价值:以太坊在持续升级(Pectra、Fusaka、PeerDAS、2 倍 Gas 限制、EIP-7702),模型训练数据永远滞后。一个可持续更新的知识源,比一次性记住的答案更有长期价值。

7. 常见问题 FAQ

Q1:这个技能怎么安装? 在支持技能机制的 AI 代理平台中,通过技能入口检索英文名 ethskills-master 或中文名「ETHSKILLS技能Skill」安装即可;具体命令与目录规范以官方说明为准。若平台不支持技能机制,也可以直接访问 https://ethskills.com/<skill>/SKILL.md 将内容提供给助手。

Q2:它是收费的吗? 技能详情内容中未说明商业收费方式与价格,本文不作推测,具体以官方说明为准。

Q3:它和直接问大模型有什么区别? 区别在于“是否承认过时”。通用大模型的以太坊参数往往停留在几年前,且不会主动声明;这套技能直接列出“你错在哪里”,例如 Gas 是 0.05–0.1 gwei 而非 10–30 gwei、USDC 是 6 位小数、Polygon zkEVM 正在关闭、每个 L2 上的主导 DEX 不是 Uniswap。

Q4:适合谁用? 最适合三类人:用 AI 代理构建 dApp 的开发者、需要做合约安全自检与交付审阅的工程师、以及构建 AI 代理支付与身份基础设施(x402、ERC-8004、EIP-7702)的团队。纯概念学习者也能用,但收益最大的是“要交付”的人。

Q5:技能里给的地址和价格可以直接用吗? 不建议盲用。技能本身的态度就是谨慎——地址清单声明“所有通过 cast code + cast call 在链上验证(2026 年 2 月)”,说明验证动作本身就是流程的一部分。使用任何地址前,请自行在链上复核;成本数字也应结合实时网络状况判断。