ethereum-wingman

Ethereum Wingman 是 BuidlGuidl 社区推出的 Scaffold-ETH 2 官方开发助手，旨在为以太坊开发者提供从项目搭建到智能合约部署的全流程指导。

核心用法：该 Skill 指导开发者使用 npx create-eth@latest 快速创建 Scaffold-ETH 2 项目，强制采用 Fork 模式（yarn fork）而非本地空链进行测试，确保在真实协议状态（如 Uniswap、Aave）下验证合约逻辑。它提供完整的开发工作流：配置轮询间隔、启用自动出块、部署合约到本地分叉网络，并通过预配置的 RainbowKit 前端与合约交互。同时涵盖 Solidity 智能合约编写、ERC-20/ERC-721 标准实现、DeFi 协议集成（如使用 Chainlink 预言机）以及 SpeedRun Ethereum 挑战课程的参考实现。

显著优点：首先，来源权威性强，BuidlGuidl 是以太坊教育领域知名社区，维护着广泛使用的 Scaffold-ETH 框架。其次，安全教学体系完善，文档包含 12 条"Critical Gotchas"（如代币精度处理、重入攻击防护、预言机操纵风险），并提供 check-gotchas.sh 脚本主动扫描代码漏洞。第三，实战导向的 Fork 模式允许开发者在本地测试与主网完全一致的状态，无需消耗真实 Gas 即可验证与真实协议（如 USDC、WETH）的交互逻辑。第四，完整的 React hooks 封装（useScaffoldReadContract、useScaffoldWriteContract）大幅降低前端与合约交互的复杂度。

潜在缺点：该工具主要面向已有一定编程基础的开发者，对完全的初学者存在学习曲线。其次，作为教学辅助工具，文档中的 Solidity 代码示例主要用于演示概念，直接用于生产环境前必须经过专业安全审计。此外，工具链深度依赖 Node.js 和 Yarn 生态，对环境配置有特定要求，且主要集中在 EVM 生态，不适用于其他区块链平台。

适合的目标群体：主要面向以太坊智能合约开发者、Web3 前端工程师、DeFi 协议构建者，以及希望通过 SpeedRun Ethereum 课程系统学习区块链开发的学生和研究人员。特别适合需要快速原型化 dApp 或学习安全最佳实践的中高级开发者。

使用风险：一方面，初始化脚本依赖外部工具（如 npx、foundry），需确保依赖来源可信且版本锁定。另一方面，Fork 模式虽然免费，但需要消耗较多本地计算资源运行 Anvil 节点。最重要的是，文档中提供的合约代码（如清算激励设计、Vault 份额计算）仅为教学演示，主网部署前必须进行全面安全审计，避免因代码复制导致的资金风险。

核心功能与定位

ethereum-wingman 是以太坊生态最全面的开发者教育助手，专为 AI Agent 和开发者设计，提供从项目创建到部署的全流程指导。该 Skill 基于 Scaffold-ETH 2 技术栈（Foundry + Next.js + RainbowKit），采用 Fork 模式 开发——即直接分叉真实网络状态（Base/Mainnet/Arbitrum 等）进行测试，而非使用空白的本地链，这意味着开发者可以调用真实的 Uniswap、Aave、Chainlink 等协议进行集成测试。

显著优势

1. 生产级开发流程：强制使用 yarn fork 替代 yarn chain，确保测试环境贴近真实主网状态；提供完整的 7 步项目初始化流程，包括关键的自动区块挖矿配置（解决 block.timestamp 冻结问题）。

2. 安全教育深度：涵盖 12 个关键安全陷阱（Token 精度、ERC-20 授权模式、重入攻击、预言机操纵等），每个都配有真实攻击案例和防护代码。

3. 激励机制设计：强调"无自动执行"原则——任何需要调用的函数必须设计经济激励（如清算奖励、收益分成），这对 DeFi 协议设计至关重要。

4. 实战课程映射：完整对应 SpeedRun Ethereum 12 个挑战（NFT、Staking、DEX、Lending、Stablecoin、ZK Voting 等），形成系统学习路径。

局限性与注意事项

• 技术栈锁定：深度绑定 Scaffold-ETH 2，若团队使用 Hardhat 或纯 Brownie 开发需额外适配。
• 教育性质：代码示例为教学片段，生产环境需进一步审计。
• 前端依赖：强制使用 Next.js + RainbowKit，对 Vue/Svelte 团队不友好。

适合人群

• 以太坊新手开发者（有 JavaScript/Solidity 基础）
• 全栈 dApp 开发者需快速原型验证
• 安全研究者学习 DeFi 攻击模式
• 教育机构开展区块链课程

风险与建议

Fork 模式下测试使用真实代币余额（从"鲸鱼"地址转移），虽为本地分叉但仍需注意：

• 切勿将 .env 中的私钥配置为真实资金账户
• 生产部署前务必通过专业安全审计
• 预言机集成需使用 Chainlink 官方 feed，禁用 DEX 现货价