design-integration

🦄 Uniswap 集成架构设计专家

基于 Uniswap 官方技术栈的架构设计助手,为 DeFi 项目提供从选型到实施的完整蓝图、依赖清单与安全保障方案。

收藏
2.6k
安装
1.2k
版本
v0.1.0
CLS 安全性认证2026-05-03
点击查看完整报告 >

使用说明

核心用法:

该 Skill 是专为 Uniswap 集成设计的架构规划工具。当用户需要为项目添加 Uniswap 功能(如代币兑换、流动性提供)时,Skill 会提取项目类型、功能需求、执行环境、目标链和规模等关键参数,通过 Task(subagent_type:integration-architect) 委托给专业的集成架构师子代理。子代理将综合评估 Trading API、Universal Router SDK、直接合约调用和 V4 Hooks 四种集成方式,输出包含组件架构、数据流设计、依赖清单和安全审查的完整蓝图。

显著优点:

首先,方案全面且专业,不仅对比多种集成方式的优劣,还提供主方案+备选方案的组合策略,确保系统健壮性。其次,紧跟技术前沿,强制使用 viem(而非 ethers.js)和 Permit2(而非传统授权),符合现代 DeFi 安全最佳实践。第三,安全考量深入,内置针对报价失效、授权风险和密钥管理的具体缓解措施,并识别常见的攻击向量。第四,输出物实用性强,提供按依赖关系排序的实施计划和工时估算,便于项目管理。

潜在缺点或局限性:

作为 T3 来源(个人开发者 wpank)的工具,其内容权威性不及官方文档,建议用户将输出作为参考而非绝对标准。Skill 本身仅生成架构文档,不执行实际代码或交易,开发者需自行完成具体编码和测试。此外,架构建议的质量高度依赖 integration-architect 子代理的能力,对于极其复杂或创新的 DeFi 协议设计,可能需要人工架构师进一步验证。

适合的目标群体:

主要面向三类开发者:一是构建 DeFi 仪表盘、钱包应用或 DEX 聚合器的前端开发者;二是开发套利机器人、做市系统或后端服务的后端工程师;三是设计需要与 Uniswap 交互的 DeFi 协议的智能合约开发者。特别适合那些熟悉 JavaScript/TypeScript 技术栈,希望在以太坊、Base、Arbitrum 等 EVM 链上快速启动 Uniswap 集成的团队。

使用风险:

虽然 Skill 本身安全(纯文档型),但使用时需注意:输出的代码示例和架构建议需经过安全审计后再用于生产环境;推荐的依赖版本(如 @uniswap/sdk-core ^5.8.0)建议使用精确版本号锁定,避免自动升级引入漏洞;Skill 需要 Read 权限访问用户代码库,请确保项目中不包含私钥、API Key 等敏感信息;最后,Uniswap 智能合约本身存在无常损失、MEV 攻击等固有风险,架构设计仅降低集成风险,不消除底层协议风险。

安全解读

核心用法

design-integration 是一个纯文档型Skill,本身不执行代码,而是通过 Task 工具将请求委派给 integration-architect 子代理。用户只需描述项目类型(如DeFi面板、套利机器人)、所需功能(swap/LP/两者)、执行环境(前端/后端/合约/全栈)、目标链及规模预期,即可获得量身定制的集成方案。

显著优点

1. 架构决策自动化:自动评估 Trading API vs Universal Router SDK vs 直接合约调用 vs V4 hooks 的优劣,给出主方案+备选方案
2. 端到端蓝图:输出包含组件架构图、数据流、依赖清单(版本锁定)、安全审查及实施计划

3. 现代技术栈:默认推荐 viem(而非 ethers.js)和 Permit2(而非传统 approve),符合当前最佳实践

4. 多链支持:内置调用 mcp__uniswap__get_supported_chains 查询官方支持的11条链,避免部署到未支持网络

5. 安全优先设计:内置安全审查环节,涵盖报价失效、授权管理、密钥安全等DeFi常见风险

潜在局限

  • 依赖子代理质量:实际方案质量完全取决于 integration-architect 子代理的能力,本Skill本身无校验逻辑
  • 无实时数据:除链支持查询外,不直接调用Uniswap API或合约获取实时数据(如汇率、流动性)
  • 个人维护来源:维护者为GitHub个人账号(wpank),非Uniswap官方或顶级基金会,长期维护稳定性需观察
  • 文档型限制:T-MD分类意味着无法执行动态测试或代码生成,所有实现需用户自行完成

适合人群

  • DeFi协议开发者:需要评估多种集成方式并制定技术路线的团队
  • dApp前端工程师:寻求最佳SDK选择和Permit2集成方案
  • 量化/套利策略开发者:需要架构设计指导的backend-focused用户
  • 技术负责人:需要快速产出技术评估文档和工时估算的场景

常规风险

  • 方案实施风险:生成的蓝图需开发团队正确实施,Skill本身不保证最终实现无漏洞
  • Permit2认知门槛:虽然推荐更安全,但Permit2授权模式对不熟悉EIP-2612的开发者有学习成本
  • API依赖:若选择Trading API方案,需承担Uniswap API服务可用性和费率变化的风险
  • V4 Hooks复杂性:对于高级用法(自定义V4 hooks),文档可能无法覆盖所有边界情况

design-integration 内容

手动下载zip · 3.6 kB
README.mdtext/markdown
请选择文件