核心功能: 本技能提供中文交互、化工作流场景等能力。
Graph Advocate
付费版进阶功能
| 能力 | 免费版 | 付费版 |
|---|---|---|
| 基础功能 | 支持 | 支持 |
| 复杂工作流可视化编排 | 不支持 | 支持 |
| 条件分支与异常重试 | 不支持 | 支持 |
| 定时触发与事件驱动 | 不支持 | 支持 |
| 执行日志与审计追踪 | 不支持 | 支持 |
| 分布式任务调度与负载均衡 | 不支持 | 支持 |
主要能力
- Route any blockchain data question to the right Graph Protocol service
- Returns live data from 15
典型场景
| 场景 | 输入 | 输出 |
|---|---|---|
| 区块链数据查询 | 链上数据问题和子图类型 | Graph Protocol服务路由和建议 |
| 子图选择 | 数据需求和合约地址 | 最优子图索引和查询端点 |
| 查询优化 | GraphQL查询和子图模式 | 优化查询和性能建议 |
不适用于:非区块链数据的图数据库查询
操作步骤
- 确认运行环境满足依赖说明中的要求
- 根据适用场景选择合适的使用方式
- 执行操作并检查输出结果
- 如遇错误,参考错误处理章节
参数说明
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| question | string | 是 | 区块链数据查询问题 |
| chain | string | 否 | 区块链网络, 可选: ethereum/polygon/arbitrum, 默认: ethereum |
返回格式
{
"success": true,
"data": {
"overall_grade": "A",
"total_score": 92,
"max_score": 100,
"summary": "处理完成",
"details": [
{
"item": "代码风格",
"status": "pass",
"score": 95,
"comment": "符合规范"
},
{
"item": "安全合规",
"status": "warn",
"score": 80,
"comment": "符合规范"
}
],
"improvements": [
{
"priority": "high",
"suggestion": "建议优化",
"expected_gain": "+5分"
},
{
"priority": "medium",
"suggestion": "建议优化",
"expected_gain": "+3分"
}
]
},
"error": null
}
安装与配置
运行环境
- Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
- 操作系统: Windows / macOS / Linux
工具依赖
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| LLM API | API | 必需 | 由Agent内置LLM提供 |
API Key 配置
可用性分类
- 分类: MD+execute()
- 说明: 基于Markdown的AI Skill,
API Key配置方式:
export API_KEY="${API_KEY:?请设置环境变量}"
配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.
案例展示
"Top 10 USDC holders on Ethereum" → token-api
"Best subgraph for Uniswap V3 on Arbitrum?" → subgraph-registry
"Aave V3 liquidations above $50K" → graph-aave-connector
"Hottest Polymarket markets" → token-api (/v1/polymarket/markets)
"Polymarket OHLCV for Bitcoin market" → token-api (/v1/polymarket/markets/ohlc)
"Polymarket trader P&L for 0x..." → token-api (/v1/polymarket/users/positions)
"Polymarket live orderbook depth" → graph-polymarket-connector (advanced)
"Polymarket trader winrate/drawdown" → graph-polymarket-connector (subgraph P&L stats)
"Score Hyperliquid trader 0x..." → /hyperliquid/score (paid)
"Hyperliquid top traders for HYPE" → /hyperliquid/screen (paid)
"Evaluate Hyperliquid vault 0x..." → /hyperliquid/vault (paid)
"Compare Aave vs Compound TVL" → graph-lending-connector
"x402 payment volume on Base today" → x402-analytics
"Top 10 x402 recipients in the last 30 days" → /ask (paid, NL→SQL)
"When did x402 volume on Base inflect?" → /ask (paid, NL→SQL)
"Has 0x0FF5A6… ever been paid via x402?" → /onchain-x402/address (paid, decentralized)
"Polymarket vs Limitless spread on 'trump'" → /predmarket/spread (paid, cross-venue JOIN)
"Kalshi vs Polymarket fed-rate arbitrage" → /kalshi-polymarket/spread (paid)
"Find agents that do trading" → 8004scan
问答集成汇总
Q1: 如何开始使用Graph Advocate?
A: 请参考使用流程和依赖说明章节,确保运行环境满足要求后调用本技能。
错误处理体系
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| LLM响应超时或无响应 | 网络延迟或模型负载过高 | 请求重试;确认Agent平台LLM服务正常 |
| 输入内容格式不正确 | 用户输入不符合skill预期格式 | 检查输入是否符合skill使用说明中的格式要求,参考示例章节 |
| 执行结果与预期不符 | 指令描述不够明确或上下文不足 | 提供更详细的指令描述,补充必要的上下文信息 |
| 命令执行失败 | 运行环境不满足要求或权限不足 | 确认运行环境符合依赖说明中的要求;检查命令权限设置 |
注意事项
- 需要API Key,无Key环境无法使用
创新优势
效率提升量化分析
| 操作步骤 | 手动耗时 | 自动化耗时 | 时间节约 | 准确率提升 |
|---|---|---|---|---|
| 数据查询 | 30分钟 | 2分钟 | 28分钟 | 10% |
| 数据分析 | 4小时 | 30分钟 | 3.5小时 | 5% |
| 报表生成 | 2小时 | 20分钟 | 1.5小时 | 3% |
| 统计洞察 | 6小时 | 1小时 | 5小时 | 8% |
| 数据可视化 | 3小时 | 30分钟 | 2.5小时 | 4% |
差异化对比
| 对比维度 | 本技能 | 手动操作 | Python脚本 | 专业软件 |
|---|---|---|---|---|
| 功能丰富性 | 全面支持Graph Protocol服务 | 部分支持 | 基本支持 | 全面支持 |
| 操作便捷性 | 一键调用,快速返回结果 | 需编写脚本 | 需编写脚本 | 需专业操作 |
| 成本效益 | 付费版提供高级功能,免费版基础功能充足 | 需购买软件或编写脚本 | 需购买软件或编写脚本 | 需购买软件 |
| 易用性 | 界面友好,易于上手 | 需学习编程 | 需学习编程 | 需学习专业软件操作 |
| 维护成本 | 定期更新,维护成本低 | 需持续维护 | 需持续维护 | 需持续维护 |
核心痛点解决
| 痛点 | 描述 | 影响范围 | 解决方案 | 量化效果 |
|---|---|---|---|---|
| 数据查询效率低 | 手动查询区块链数据耗时较长,影响工作效率 | 所有区块链数据查询场景 | 提供自动化查询工具,快速返回结果 | 时间节约达28分钟 |
| 数据分析困难 | 手动分析数据过程复杂,结果不准确 | 所有数据分析场景 | 提供数据分析工具,提高分析准确率 | 准确率提升8% |
| 报表生成繁琐 | 手动生成报表耗时较长,且格式不统一 | 所有报表生成场景 | 提供报表生成工具,提高报表生成效率 | 时间节约达1.5小时 |
常见问题FAQ
Q1: [具体问题]
A: [详细回答]
Q2: [具体问题]
A: [详细回答]
Q3: [具体问题]
A: [详细回答]
Q4: [具体问题]
A: [详细回答]
Q5: [具体问题]
A: [详细回答]
问题排查手册
| 错误现象 | 可能原因 | 诊断步骤 | 解决方案 |
|---|---|---|---|
| 无法连接Graph Protocol服务 | 网络连接问题或API Key配置错误 | 检查网络连接,重新配置API Key | 重新配置API Key,确保网络连接正常 |
| 返回结果为空 | 请求参数错误或Graph Protocol服务无相关数据 | 检查请求参数,确认Graph Protocol服务有相关数据 | 修正请求参数,确认Graph Protocol服务有相关数据 |
| 返回结果错误 | Graph Protocol服务错误或请求参数错误 | 检查Graph Protocol服务状态,确认请求参数正确 | 修复Graph Protocol服务错误,修正请求参数 |
| 执行时间过长 | 请求参数复杂或Graph Protocol服务响应慢 | 简化请求参数,检查Graph Protocol服务响应时间 | 简化请求参数,优化Graph Protocol服务 |
安全提示
- 确保API Key安全,避免泄露到版本控制系统。
- 限制技能访问权限,防止未授权访问。
- 定期更新Graph Protocol服务,确保安全性和稳定性。
- 对敏感数据进行加密处理,防止数据泄露。
- 监控技能运行日志,及时发现并处理异常情况。
安全风险防范
| 风险项 | 等级 | 防护措施 | 验证方法 |
|---|---|---|---|
| API密钥泄露 | 高 | 通过环境变量配置,禁止硬编码 | 定期检查代码和配置文件 |
| 命令执行风险 | 高 | 仅执行白名单命令,避免拼接用户输入 | 使用沙箱环境测试 |
| 网络通信安全 | 中 | 使用HTTPS协议,验证SSL证书 | 定期检查证书有效期 |
| 敏感数据暴露 | 高 | 输出结果中不包含密钥、令牌等敏感信息 | 日志脱敏审查 |
| 未授权访问 | 中 | 限制访问权限,实施认证机制 | 定期审计访问日志 |
功能介绍
- 自动化执行: 把区块链数据问题路由到对的Graph Protocol服务,返实时数据。Route any blockchain dat
- 文件处理: 支持多种文件格式的读取、解析和写入操作
- API集成: 通过标准化接口调用外部服务并处理响应
- 命令执行: 在安全沙箱中执行系统命令并收集结果
- 信息检索: 快速搜索和过滤目标数据
上线流程
- 配置API密钥: 在环境变量中设置对应的API Key
- 初始化连接: 使用提供的凭证建立API连接
- 调用接口: 传入必要参数执行API调用
- 准备文件: 确认文件路径正确且格式受支持
- 执行处理: 调用对应的处理函数
- 查看结果: 检查输出文件或返回数据
- 检查环境: 确认运行时和依赖已安装
- 执行命令: 使用正确的参数格式执行
- 查看输出: 检查命令输出和退出码
前置条件
- 已安装所需运行环境(参考依赖说明)
- 已获取必要的API密钥或访问凭证(如适用)
- 输入数据已准备就绪
依赖说明
运行环境
- Agent 平台: 支持SKILL.md的任意AI Agent
- 操作系统: Windows / macOS / Linux
可用性分类
- 分类: MD(纯Markdown指令,通过自然语言驱动Agent完成操作)
- 说明: 基于Markdown的AI Skill,通过自然语言指令驱动Agent完成操作。
Related skills
- Downloads
- Security audit
- Review
- Last updated
- 1mo ago
- Current version
- v1.0.0
- License
- MIT-0
