（3422期）Design Uniswap Hook – V4 Hook架构设计与规划工具

V4 Hook架构设计与规划工具 专业设计Uniswap V4 Hook架构，分析回调选择、Gas成本与安全风险，输出完整设计文档供开发前评估。 使用说明 核心功能 design-hook 是一个专注于Uniswap V4 Hook架构设计的规划型技能，其核心定位是"设计先行、代码后置"。与直接生成代码的工具不同，它通过调用 hook-builder 子代理，在纯设计模式下输出一份完整的设计文档，涵盖开发Hook所需的全部架构决策。 设计文档核心内容 | 模块 | 输出内容 ||------|----------|| 回调选择 | 分析业务需求，确定必需的V4回调（如 beforeSwap、afterInitialize 等） || Hook标志位 | 计算所需的Hook Flags组合及对应的十六进制掩码（如 0x2080） || 状态管理 | 设计存储变量、数据结构和访问模式，包括可变/不可变状态划分 || Gas估算 | 按回调提供粗略Gas开销（如 beforeSwap ~30,000 gas） || 安全考量 | 识别特定于该设计的攻击向量（预言机操纵、重入等）及缓解措施 || 架构决策 | 记录关键设计选择及其理由，支持追溯与评审 || 替代方案 | 对比其他可行路径，说明当前选择的优劣 | 典型使用场景 开发前规划：明确技术可行性，避免编码后返工 方案评审：团队内部分享设计，收集反馈 学习参考：理解特定Hook类型（如TWAMM、动态费用、限价单）的实现原理 可行性评估：判断想法是否在V4技术约束内可实现 显著优点 零代码风险：设计阶段不生成文件，避免污染工作区 专业化分工：由 hook-builder 子代理专注处理复杂的V4回调矩阵 决策可追溯：强制记录架构决策理由，提升代码可维护性 安全前置：在设计阶段识别风险，而非事后修补 潜在局限 无代码产出：需要配合 build-hook 技能才能进入实现阶段 Gas估算非精确值：基于典型实现的经验值，实际消耗依赖具体编码 依赖子代理质量：设计深度受限于 hook-builder 的知识覆盖 无法自动验证：设计正确性需人工或后续代码审查确认 适合人群 V4 Hook开发者（初级到高级） DeFi协议架构师评估Hook集成的技术方案 安全审计师快速理解陌生Hook的设计意图 研究人员探索V4 Hook的设计空间 常规风险 | 风险类型 | 说明 ||----------|------|| 设计错误 | 错误的回调选择或标志位计算导致Hook无法正常触发 || Gas低估 | 复杂状态操作可能导致实际Gas远超估算，影响用户体验 || 预言机依赖 | 涉及外部数据的Hook需额外评估操纵风险与可用性 || 权限模型缺陷 | 设计中未妥善处理的权限控制可能引入中心化风险 | 原始说明 Design a Uniswap V4 hook architecture without code generation. Use when user wants to plan a hook, understand which callbacks to use, or review an architecture before building. Returns a design document, not code.