用途:在 Foundry 项目中编写和修改可编译、符合项目约定并通过 lint 门禁的生产级 Solidity 合约。
主要能力:提供命名、导入、目录布局、继承顺序、成员分区、NatSpec、自定义错误、Checks-Effects-Interactions、代币与低级调用、类型选择、栈过深、合约体积等约定,并附安全实践、Gas 优化、事件设计、升级与版本、链上元数据等参考文档。
使用方式:写代码前先读 foundry.toml、remappings.txt 和最近的 AGENTS.md;固定 solc 与 EVM 版本决定可用特性,如 transient storage 和 mcopy 需 Cancun 及以上,transient 状态变量还需 solc 0.8.28 及以上;evm_version 未设置时用 forge config | grep evm_version 查看默认值。格式交给 forge fmt、Solhint、Prettier。完成标准:forge build 成功,必要时 forge build --sizes;lint 门禁通过,如 forge fmt --check <files> 和 bun solhint <files>(或 bun run full-check);新行为有测试或说明缺失覆盖。
适用场景:Foundry 项目中的合约编写、函数实现、错误/事件/结构体添加等。
限制:默认约定仅作回退,现有代码与仓库说明优先;via_ir 会改变字节码并拖慢编译,应作为项目级决定;部署字节码须低于 EIP-170 的 24,576 字节。其余细节暂未提供。