用途:该技能面向 Solidity 合约开发,帮助编写符合行业最佳实践的生产级合约,触发场景包括编写合约、实现函数、添加功能或错误、Gas 优化、事件设计等。
主要能力:内置多份参考文件,分别覆盖编码模式(NatSpec、错误、修饰器、导入、分节标题)、安全实践(CEI、访问控制、EIP-7702、升级)、Gas 优化(EIP-1153、L2 模式、Solady、存储缓存)、事件设计(面向 The Graph 与索引器)、版本与迁移(接口版本、存储迁移、弃用)、Sablier 约定以及链上 NFT 元数据与 SVG 生成。
使用方式:编写合约代码前先阅读 coding-patterns.md;实现状态变更时参考 security-practices.md;优化效率时参考 gas-optimization.md;添加事件时参考 event-design.md;发布新版本时参考 versioning-migration.md;在 Sablier 仓库中工作时参考 sablier-conventions.md;实现 tokenURI 时参考 nft-descriptor.md。仓库内的 agent 会提供仓库特定结构(包位置、继承层级等)。
约定要点:合约与库用 PascalCase,接口加 I 前缀,函数与变量用 camelCase,常量用 SCREAMING_SNAKE,私有/内部成员加下划线前缀,错误命名为 {Contract}_{Description};导入按字母序、外部在前本地在后;函数顺序为构造函数、Receive/Fallback、外部函数、公共函数、内部函数、私有函数。关键原则包括实现中使用 @inheritdoc、每种失败模式一个具体错误、遵循 CEI、始终使用 SafeERC20、时间戳用 uint40、金额用 uint128。
限制:合约需保持在 24kb 字节码限制内,可用 forge build --sizes 验证;超出时可提取为外部库、拆分合约、删除未用函数或使用自定义错误。遇到 Stack Too Deep 可用内存结构体打包局部变量。资料未提供收费、价格或平台信息。