图谱

把区块链数据查询请求路由至最合适的Graph Protocol服务，支持中文交互，提供实时数据和查询优化建议。

功能说明: 本技能涵盖 中文交互、化工作流场景 等核心能力。

Graph Advocate

付费版进阶功能

能力	免费版	付费版
基础功能	支持	支持
复杂工作流可视化编排	不支持	支持
条件分支与异常重试	不支持	支持
定时触发与事件驱动	不支持	支持
执行日志与审计追踪	不支持	支持
分布式任务调度与负载均衡	不支持	支持

典型场景

场景	输入	输出
区块链数据查询	链上数据问题和子图类型	Graph Protocol服务路由和建议
子图选择	数据需求和合约地址	最优子图索引和查询端点
查询优化	GraphQL查询和子图模式	优化查询和性能建议

不适用于：非区块链数据的图数据库查询

参数说明

参数名	类型	必填	说明
question	string	是	区块链数据查询问题
chain	string	否	区块链网络, 可选: ethereum/polygon/arbitrum, 默认: ethereum

返回格式

json

{
  "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配置方式:

bash

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

错误处理体系

错误场景	原因	处理方式
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: [详细回答]

安全提示

1. 确保API Key安全，避免泄露到版本控制系统。
2. 限制技能访问权限，防止未授权访问。
3. 定期更新Graph Protocol服务，确保安全性和稳定性。
4. 对敏感数据进行加密处理，防止数据泄露。
5. 监控技能运行日志，及时发现并处理异常情况。

安全风险防范

风险项	等级	防护措施	验证方法
API密钥泄露	高	通过环境变量配置，禁止硬编码	定期检查代码和配置文件
命令执行风险	高	仅执行白名单命令，避免拼接用户输入	使用沙箱环境测试
网络通信安全	中	使用HTTPS协议，验证SSL证书	定期检查证书有效期
敏感数据暴露	高	输出结果中不包含密钥、令牌等敏感信息	日志脱敏审查
未授权访问	中	限制访问权限，实施认证机制	定期审计访问日志

上线流程

1. 配置API密钥: 在环境变量中设置对应的API Key
2. 初始化连接: 使用提供的凭证建立API连接
3. 调用接口: 传入必要参数执行API调用
4. 准备文件: 确认文件路径正确且格式受支持
5. 执行处理: 调用对应的处理函数
6. 查看结果: 检查输出文件或返回数据
7. 检查环境: 确认运行时和依赖已安装
8. 执行命令: 使用正确的参数格式执行
9. 查看输出: 检查命令输出和退出码

前置条件

• 已安装所需运行环境(参考依赖说明)
• 已获取必要的API密钥或访问凭证(如适用)
• 输入数据已准备就绪